Налаштування агента вручну
Усе, що знає агент, лежить в одному файлі — app_settings.json. Конфігуратор пише його за
вас, а для скриптових і headless-встановлень ви можете написати його самі. Ця сторінка —
довідник по полях.
Якщо ви просто хочете підключити пристрій, ця сторінка вам не потрібна: як пов'язати пристрій з обліковим записом — коротше й безпечніше.
Де лежить файл
Агент читає app_settings.json із теки, де лежить його власний виконуваний файл. Тобто:
- Windows — поруч із
FilemoteAgent.exe, у теці встановлення або портативній теці. - Встановлення служби в Linux —
/opt/filemote/app_settings.json, бо саме туди скрипт встановлення кладе агента. - Усі інші випадки — поруч із тим бінарником, який ви запустили.
Термінальний конфігуратор типово бере файл поруч із собою і приймає --config <path>, щоб
редагувати інший, — а це саме те, що потрібно під час встановлення служби, оскільки
FilemoteCli у префікс не копіюється. Відносний шлях тут розв'язується від вашого
поточного каталогу.
З'єднання
| Поле | Що означає |
|---|---|
ip | Ім'я хоста або адреса сервера, до якого підключається агент |
port | Порт сервера |
EnforceHttps | Відмовлятися від з'єднання звичайним HTTP. Увімкнено типово; підключення через термінальний клієнт вимикає його, бо ретранслятор доступний через HTTP |
Лишіть в ip і port адресу вашого власного сервера. Порожній ip не означає «розберися
сам» — агент відкотиться на вшите типове значення, яке майже напевно не стосується вашого
розгортання.
Ідентифікація
| Поле | Що означає |
|---|---|
login | E-mail облікового запису |
pass | Зашифрований пароль облікового запису — див. нижче |
PairCode | Код підключення, що очікує на погашення |
DeviceToken | Тривалий токен, збережений після погашення коду |
pass — це не пароль відкритим текстом. Конфігуратор зберігає його через локальний
захист платформи — DPAPI у Windows, локальний файл ключа в інших випадках — і агент чекає
саме такої форми. Вставити в поле пароль відкритим текстом не вийде; задайте пароль через
конфігуратор, а ще краще — пов'яжіть пристрій кодом і лишіть pass порожнім.
До чого агентові дозволено звертатися
rootPaths — це список каталогів, які дозволено бачити браузеру. Усе, що поза списком,
відхиляється, зокрема спроби вийти назовні через ... Агент відмовляється стартувати з
порожнім списком, тож поле не є необов'язковим.
rootPath (в однині) — застаріле поле, лишене тільки для того, щоб старі файли налаштувань
далі завантажувались. Використовуйте rootPaths.
Налаштування передавання даних
| Поле | Типово | Що означає |
|---|---|---|
ChunkSizeKb | 64 | Розмір одного блоку передавання |
MaxDownloadMb | 2048 | Максимальний розмір одного завантаження; 0 — без обмежень |
ReconnectDelayMs | 5000 | Перша затримка перепідключення. Далі подвоюється з кожною спробою, з розкидом, максимум до 30 секунд |
TransferSpeedLimitKbps | 0 | Обмеження вихідної швидкості; 0 — без обмежень |
AI та база знань
| Поле | Типово | Що означає |
|---|---|---|
AiModelId | qwen2.5-1.5b-instruct | Основна модель |
AiDevice | auto | auto обирає GPU, якщо є Vulkan-сумісний; cpu і gpu задають жорстко. cuda досі приймається як застаріле значення |
AiTemperature | 0.7 | Температура семплювання |
AiMaxNewTokens | 512 | Обмеження довжини відповіді |
AiSystemPrompt | порожньо | Підставляється на початок кожної розмови |
AiAutoStart | false | Запускати AI-сервіс разом з агентом |
AiDocumentModel, AiVisionModel, AiCodeModel, AiSummaryModel | порожньо | Спеціалізовані моделі; порожній слот відкочується на основну модель |
KbEnabled | true | Підмішувати контекст із бази знань в AI-чат |
KbPaths | порожньо | Теки для індексації |
KbIncludeBrowser | false | Індексувати історію браузера |
KbIncludeEmail | false | Індексувати файли .eml і .msg |
KbPrivacyAccepted | false | Фіксує, що діалог згоди було показано |
KbScheduleEnabled | false | Переіндексовувати за розкладом |
KbScheduleDays | не задано | Дні тижня для переіндексації; порожній список означає «ніколи» |
KbScheduleTime | 03:00 | Час доби для запуску за розкладом, 24-годинний формат |
KbScheduleIntervalHours досі трапляється у старих файлах налаштувань. Воно читається лише
для того, щоб такі файли далі завантажувались, і більше ні на що не впливає — його замінили
два поля вище.
Порт AI-сервісу більше не налаштовується — він фіксований на 8765. У старих файлах
налаштувань може лишитися поле AiPort; воно ігнорується.
Оновлення
| Поле | Типово | Що означає |
|---|---|---|
UpdateCheckEnabled | true | Головний вимикач перевірки оновлень |
UpdateChannel | stable | stable або beta |
UpdateSkippedVersion | порожньо | Єдина версія, яку ви вирішили пропустити |
Що ці налаштування роблять насправді, описано у статті як підтримувати Filemote в актуальному стані.
Чому підключення кодом усе-таки краще
Агент, налаштований із паролем від облікового запису, виводить із цього пароля ключ шифрування ваших файлів. Змініть пароль у браузері — і сторони перестануть сходитись: браузер одразу виведе новий ключ, а робочий агент збереже старий, і все, що він надсилає назад, розшифрується в нісенітницю. Симптом і спосіб полагодити — у статті пристрій показано як офлайн.
Підключення кодом знімає проблему цілком, бо несе ключ у самому коді, поза основним каналом. Ручне налаштування існує для headless- і скриптових встановлень; якщо у вас є екран і браузер, пов'яжіть пристрій кодом.
Оновлено 2026-07-31