Установка в Linux

Запустить агента в Linux можно двумя способами: как системную службу, стартующую вместе с машиной, или как обычный процесс, который вы запускаете сами. Один и тот же архив подходит для обоих.

Выберите архив

Архив	Для чего
`filemote-<версия>-linux-x64.tar.gz`	Обычные ПК и серверы
`filemote-<версия>-linux-arm64.tar.gz`	Raspberry Pi 4/5, AWS Graviton, Oracle Ampere

Оба распаковываются в одну папку, где лежат FilemoteAgent, FilemoteCli, install.sh, apply-update.sh, пустой app_settings.json и каталог AiService.

Архивы собираются на Windows, где нет unix-бита исполнения, поэтому chmod +x — всегда первый шаг. Сами бинарники самодостаточные, так что агенту не нужна установка .NET — скрипт установки ставит .NET всё равно, потому что разворачивает полное окружение, включая AI.

Установка как службы (нужен root)

tar xzf filemote-<версия>-linux-x64.tar.gz
cd filemote-<версия>-linux-x64
chmod +x install.sh
sudo ./install.sh

Скрипт:

определяет ваш пакетный менеджер (apt, dnf, yum, zypper или pacman) и, если не узнаёт ни одного, предупреждает, а не прерывается;
ставит среду выполнения .NET 8, добавляя пакетный репозиторий Microsoft на Debian и Ubuntu и откатываясь на dotnet-install.sh от Microsoft, если через пакеты не вышло;
ставит актуальный Python, если нет ничего новее 3.10 — явно 3.12 на apt, dnf и zypper и то, что дистрибутив считает актуальным, на yum и pacman, — а если и это не удалось, отключает AI-сервис и продолжает, вместо того чтобы бросить всю установку;
копирует агента в /opt/filemote вместе с AI-сервисом и помощником обновления;
создаёт systemd-юнит filemote-agent.

Юнит работает от вашего пользователя, а не от root, перезапускается при сбое через пять секунд, ограничен 8 ГБ памяти и 80% CPU и пишет журнал в journald.

Юнит включён, но не запущен. Включён — значит поднимется после перезагрузки; свежая установка остаётся в состоянии inactive (dead), пока вы её не запустите, а сделать это следует после настройки на следующем шаге.

Настраивайте ту копию, которую действительно читает служба

Именно здесь чаще всего ошибаются при первой установке. FilemoteCli не копируется в /opt/filemote и по умолчанию пишет app_settings.json рядом со своим бинарником. Запустите его прямо из распакованного архива — и настроите файл, который служба никогда не читает, причём нигде не будет ошибки: с точки зрения службы у неё просто ещё нет учётных данных.

Укажите ему файл самой службы:

sudo ./FilemoteCli --config /opt/filemote/app_settings.json

Выберите [2] Pair with a code, вставьте код с сайта, затем [7] Save and exit — полное пошаговое описание есть в статье как связать устройство с учётной записью. После этого запустите службу:

sudo systemctl start filemote-agent
sudo systemctl status filemote-agent

Установка без root

На общем хостинге или в контейнере скрипт можно вообще не использовать:

tar xzf filemote-<версия>-linux-x64.tar.gz
cd filemote-<версия>-linux-x64
chmod +x FilemoteCli FilemoteAgent
./FilemoteCli      # настроить и связать
./FilemoteAgent    # запустить

После перезагрузки ничего не стартует, и зависимости AI не ставятся, но доступ к файлам работает точно так же. Запускайте агента под tmux, screen или пользовательским systemd-юнитом, если хотите, чтобы он пережил вашу сессию.

Флаги скрипта

Флаг	Что делает
`--no-ai`	Полностью пропустить AI-сервис — ни Python, ни зависимостей
`--no-autostart`	Поставить файлы, но не создавать systemd-юнит
`--prefix /path`	Установить не в `/opt/filemote`, а в другое место
`--model <id>`	Заранее выбрать основную AI-модель
`--device cpu\|gpu\|auto`	Вычислительное устройство для AI
`--gpu`	Собрать AI-движок с поддержкой GPU
`--hf-token <token>`	Токен Hugging Face, для моделей с ограниченным доступом

Флаги модели, устройства и токена вливаются в app_settings.json, не трогая уже имеющиеся настройки, поэтому повторный запуск скрипта не отменяет вашу конфигурацию. Нераспознанный флаг вызывает предупреждение и игнорируется.

AI в Linux

Без --gpu AI-движок ставится готовым CPU-пакетом. С --gpu он собирается из исходников — с CUDA, если есть nvidia-smi, иначе с Vulkan, — а значит, сначала будут поставлены компилятор и CMake, и шаг займёт несколько минут.

На Raspberry Pi с объёмом памяти меньше 8 ГБ ставьте с --no-ai.

Журналы и команды службы

sudo systemctl start filemote-agent      # запустить сейчас
sudo systemctl status filemote-agent     # работает ли
sudo journalctl -u filemote-agent -f     # следить за журналом

Если устройство так и не появляется в сети, пройдите по статье устройство отображается как офлайн.

Обновление с установки до ребрендинга

Если на машине ещё осталась старая служба rfm-agent, скрипт остановит её, отключит и удалит её юнит — два агента, конкурирующих за одну учётную запись, не нужны никому — и перенесёт ваши настройки и скачанные AI-модели из /opt/rfm в новый префикс. Старый каталог остаётся, чтобы вы удалили его сами, когда убедитесь, что всё в порядке.

Обновлено 2026-07-31

Не помогло — написать в поддержку