Руководство по установке AgentVera Runner

Что делает Runner

Используйте Runner, когда агенты должны работать на мощном сервере, который включён всегда, а не на ноутбуке. Runner хранит терминальные сеансы агентов на этом сервере: закройте крышку, потеряйте соединение или подключитесь с другого компьютера — сеанс продолжится.

• Код и диалоги остаются на вашем сервере.
• Соединение ретранслируется через сервер AgentVera по шифрованному TLS; ретранслируемый терминальный трафик там не интерпретируется, не журналируется и не сохраняется.
• Вы видите загрузку процессора, памяти и диска сервера, открытые сеансы и файлы в разрешённых вами папках.
• Для задач, которые приходят из вебхуков или по «Send to agent» в вебе, конец вывода агента (до 6 000 символов) по завершении его хода передаётся на сервер как сводка задачи.

Требования

• Сервер или компьютер под управлением Linux или macOS.
• Node.js 20 или новее и npm.
• curl или wget.
• Для сеансов агентов: установленный на этом сервере CLI с выполненным входом — Claude Code, Codex, Gemini CLI или opencode. Терминальные сеансы работают всегда.
• Организация AgentVera на тарифе Pro или Team.

Если Node.js нет, установите его с nodejs.org или через fnm:

curl -fsSL https://fnm.vercel.app/install | bash && fnm install 22

Чтобы установить Claude Code и один раз войти в аккаунт:

npm install -g @anthropic-ai/claude-code
claude login

Установка

1. Откройте app.agentvera.dev/runners в браузере и нажмите «Yeni runner ekle» (добавить runner). Появится 8-символьный код сопряжения; он действует 10 минут.
2. Выполните приведённую ниже команду на своём сервере, заменив KOD вашим кодом сопряжения.
3. Через несколько секунд runner отобразится на /runners как онлайн. Откройте его, чтобы увидеть загрузку процессора, памяти и диска и запустить сеанс Claude, Codex или терминала через «Yeni ajan» (новый агент).

curl -fsSL https://app.agentvera.dev/runner/install.sh | sh -s -- --pair KOD

Если срок действия кода сопряжения истёк, просто создайте новый на /runners.

Параметры установщика

Добавьте эти параметры к команде установки:

• --name NAME: имя runner. По умолчанию — имя хоста машины.
• --server URL: сервер AgentVera. По умолчанию https://app.agentvera.dev.
• --no-service: не устанавливать фоновую службу, если вы будете использовать runner только из настольного приложения по SSH.

curl -fsSL https://app.agentvera.dev/runner/install.sh | sh -s -- --pair KOD --name build-server

Что делает установщик

• Устанавливает Runner в ~/.agentvera-runner/app (папка, которую можете открыть только вы) и создаёт ссылку на команду ~/.local/bin/agentvera-runner.
• В Linux с systemd создаёт пользовательскую службу agentvera-runner, которая сама перезапускается при остановке.
• Без systemd Runner запускается в фоне и пишет журнал в ~/.agentvera-runner/runner.log; после перезагрузки сервера его нужно запустить заново вручную.
• В macOS устанавливает агент launchd с именем dev.agentvera.runner, который запускается при входе, перезапускается при остановке и пишет журнал в ~/.agentvera-runner/runner.log.
• Сохраняет токен доступа в файл, который можете читать только вы.

В Linux, чтобы Runner продолжал работать после выхода из системы, выполните один раз:

sudo loginctl enable-linger $USER

Командная строка

agentvera-runner status               # version, service, pairing, server and allowed folders
agentvera-runner roots ~/projects      # limit agents and file access to these folders
agentvera-runner pair KOD --name NAME  # pair again
agentvera-runner daemon                # run Runner in the foreground

Без roots агенты работают в вашей домашней папке. После повторного сопряжения перезапустите службу; Runner подключается при запуске.

Управление службой

Linux (systemd):

systemctl --user status agentvera-runner
systemctl --user restart agentvera-runner
systemctl --user stop agentvera-runner
journalctl --user -u agentvera-runner -f

macOS (launchd):

launchctl unload ~/Library/LaunchAgents/dev.agentvera.runner.plist   # stop
launchctl load -w ~/Library/LaunchAgents/dev.agentvera.runner.plist   # start
tail -f ~/.agentvera-runner/runner.log

Подключение из настольного приложения

Страница Runner в настольном приложении AgentVera подключается к runner двумя способами: через облако с тем же аккаунтом или напрямую через сохранённый SSH-сервер. Если вы будете использовать SSH, можно установить с --no-service; приложение само запускает Runner при подключении.

Удаление

1. Удалите runner на app.agentvera.dev/runners. Его токен немедленно отзывается, и он перестаёт переподключаться.
2. Остановите и удалите службу.
3. Удалите файлы Runner.

# Linux
systemctl --user disable --now agentvera-runner
rm ~/.config/systemd/user/agentvera-runner.service

# macOS
launchctl unload ~/Library/LaunchAgents/dev.agentvera.runner.plist
rm ~/Library/LaunchAgents/dev.agentvera.runner.plist

# both
rm -rf ~/.agentvera-runner ~/.local/bin/agentvera-runner

Безопасность

• Runner открывает только исходящие соединения; открывать порты или менять настройки файрвола не нужно.
• Видеть runner и подключаться к нему могут только действующие участники вашей организации. Сотрудники поддержки, просматривающие от имени пользователя, подключиться не могут.
• Открытые соединения закрываются для пользователей, чьё членство закончилось или чья организация приостановлена.
• Параметром roots вы определяете, какими папками ограничены агенты и доступ к файлам.
• Задачи, запущенные вебхуками, могут отправлять промпты на runner; подключайте только источники, которым доверяете.

Устранение неполадок

• «Node.js 20 ya da üstü gerekli» (нужен Node.js 20 или новее): установите Node.js 22 и выполните команду снова.
• Неверный код сопряжения: возможно, его 10 минут истекли; получите новый код на /runners.
• Runner не отображается как онлайн: проверьте вывод agentvera-runner status и журналы; убедитесь, что сервер имеет доступ к app.agentvera.dev:443.
• Нужного типа агента нет в «Yeni ajan»: установите этот CLI на сервере и войдите в аккаунт; Runner показывает только те агенты, которые находит установленными.