Настройка HarnessRouter для Codex, Claude Code и Hermes
Разверните HarnessRouter в Docker для объединения API агентов. В статье приведена инструкция по настройке loopback, смене пароля по умолчанию и конфигурации TLS доступа.
Что устраняет HarnessRouter
Вы самостоятельно размещаете HarnessRouter Community Edition, чтобы выставить один API перед несколькими агентскими обвязками (agent harnesses) на собственном сервере. Агентская обвязка — это программа командной строки, которая управляет моделью в цикле: поддерживает сессию, редактирует файлы, выполняет команды и передаёт ход выполнения обратно инициатору задачи. Codex, Claude Code и Hermes выполняют эту работу, и каждый из них поставляется со своей установкой, своим форматом учётных данных и своим представлением о том, что такое сессия. HarnessRouter запускает их все внутри одного контейнера и предоставляет единую HTTP-точку входа, единую авторизацию и единое хранилище секретов.
В этом заключается вся идея, и стоит открыто сказать о цене такого решения. Вы добавляете на свой сервер контейнер, авторизацию, том и путь обновления, чтобы превратить несколько подвижных частей в одну. Если сегодня вы используете только одну обвязку, такая конфигурация будет хуже, чем прямая установка этой обвязки. Этот компромисс обсуждается в последнем разделе, поэтому ознакомьтесь с ним перед развёртыванием.
Всё, что приведено ниже, было проверено для образа с тегом 0.5.5, загруженного 19 августа 2026 года. Проект выпускает новые теги почти каждый день, поэтому проверяйте тот тег, который используете вы, вместо того чтобы доверять этой странице через месяц. 8 ноября 2026 года эта страница была повторно проверена на соответствие текущей документации и исходному коду проекта, когда latest указывал на 0.38.5, и в местах, где текущие релизы ведут себя иначе, об этом сделаны соответствующие пометки. Команды взяты из репозитория проекта по адресу github.com/HarnessRouter/harnessrouter. Они находились в README на момент 0.5.5; подробности настройки теперь находятся в docs/self-hosting-guide.md в том же репозитории.
Что такое Unified Harness Protocol на самом деле
HarnessRouter реализует протокол Unified Harness Protocol (UHP), опубликованный по адресу unifiedharnessprotocol.org. UHP описывает, как продукт запускает задачу на harness, отслеживает её выполнение, управляет сессиями и файлами, а также сообщает об ошибках. Спецификация версионируется по дате. Версия, актуальная на 19 августа 2026 года, была датирована 2026-08-11. По состоянию на 8 ноября 2026 года на сайте указана версия 2026-10-19, которая по-прежнему называется проектом стандарта: «достаточно стабилен для разработки, версионирован для безопасного внесения изменений».
Внимательно отнеситесь к фразе «открытый стандарт». Одна и та же компания пишет спецификацию, эталонную реализацию и набор тестов на соответствие, который определяет, кто именно соответствует стандарту. Правила управления проектом гласят, что изменения не принимаются, пока все три компонента не будут обновлены одновременно. На 9 ноября 2026 года главная страница протокола описывает этот набор как 110 исполняемых проверок, в то время как страница соответствия указывает 101, а в записи эталонного запуска из руководства по self-hosting от 4 сентября 2026 года пройдено 64 проверки. Таким образом, опубликованные данные не совпадают. Журнал изменений проекта датирует шесть дополнительных проверок ветвления 4 ноября 2026 года. Это обычное явление для столь молодого протокола, а лицензия Apache-2.0 позволяет форкнуть любую его часть. Это также означает, что UHP пока не является мультиплатформенным стандартом. Рассматривайте его как развивающийся протокол: полезный, динамичный, но такой, от которого ваш код должен уметь отказаться без необходимости полной переработки.
Что необходимо перед началом работы
Docker и примерно 4 GB свободного места на диске. Также потребуется API key от провайдера моделей, услуги которого вы уже оплачиваете. Размер образа составляет около 700 MB, остальное место на диске потребуется для CLI-инструментов агентов и рабочих областей, в которые они записывают данные. Внутри образа нет предустановленных моделей или пробных ключей, поэтому задачи будут завершаться ошибкой, пока вы не подключите провайдера. Сам HarnessRouter распространяется под лицензией Apache-2.0. На CLI-инструменты агентов распространяются их собственные лицензии и условия использования, которые не заменяются лицензией репозитория; они загружаются при первом запуске, а не поставляются в составе образа.
Развертывание HarnessRouter с помощью одной команды docker run
docker pull harnessrouter/harnessrouter
docker run -d --name harnessrouter \
-p 127.0.0.1:3000:3000 \
-v harnessrouter:/data \
harnessrouter/harnessrouterЗатем дождитесь запуска контейнера. Первый запуск происходит медленно, и логи объясняют причину этого.
docker logs -f harnessrouterВ процессе работы вы увидите строки, подобные этим:
installing Claude Code (Anthropic's terms apply)…
installing Codex (Apache-2.0)…
installing Hermes (check its upstream license before use)…Дождитесь ready on :3000. В текущем руководстве время ожидания составляет примерно полминуты с момента, когда docker run возвращает приглашение командной строки, а не с момента появления этой строки; если http://localhost:3000 не отвечает сразу после сообщения о готовности, повторите попытку через несколько секунд. Установленные CLI кэшируются на томе, поэтому последующие запуски обычно проходят значительно быстрее, хотя бэкенд, который вы добавите позже, или тот, установка которого ранее завершилась неудачей, может снова инициировать процесс установки.
Из этой загрузки следуют два факта, и оба они важны при работе на VPS. Во-первых, для первой загрузки необходим исходящий доступ к сети. Образ не является автономным, поэтому сервер, находящийся за фильтром исходящего трафика или не имеющий маршрута наружу, не сможет получить агентские CLI. И 0.5.5, и текущие релизы рассматривают неудачные установки как некритичные и указывают их в логах, поэтому следите за тем, какие бэкенды отсутствуют в строке backends available:. Во-вторых, вы устанавливаете стороннее программное обеспечение на условиях сторонних разработчиков. Claude Code поставляется на условиях Anthropic, а Hermes — на условиях, установленных его разработчиками, поэтому ознакомьтесь с обоими соглашениями перед коммерческим использованием.
-v harnessrouter:/data создает именованный том Docker. Все постоянные данные хранятся в /data: базы данных SQLite, сохраненные файлы, хранилище секретов и рабочие области агентов. Если вы удалите этот том, вы удалите экземпляр, включая ключи провайдеров и все транскрипты. Создавайте резервные копии при остановленном контейнере, так как копирование базы данных SQLite во время записи может привести к получению нечитаемого файла. Та же дисциплина «сначала остановка, затем копирование» применяется к любому контейнеру с состоянием на сервере, хотя детали зависят от конкретного сервиса, поскольку PhotoPrism и Immich требуют собственных команд для резервного копирования.
docker stop harnessrouter
docker run --rm -v harnessrouter:/data -v "$PWD":/backup alpine \
tar czf /backup/harnessrouter-data.tgz -C / data
docker start harnessrouterВариант compose и строка, которую необходимо изменить
Репозиторий поставляет файл compose. В текущей версии он публикует "127.0.0.1:3000:3000", привязывая порт хоста к loopback. Файл 0.5.5 публиковал "3000:3000"; измените эту строку, если используете старый файл на публичном сервере.
services:
harnessrouter:
image: harnessrouter/harnessrouter:0.5.5
ports:
- "127.0.0.1:3000:3000"
env_file:
- .env
volumes:
- harnessrouter-data:/data
restart: unless-stopped
volumes:
harnessrouter-data:Одна деталь отличается от текущей версии upstream: зафиксированный тег версии вместо latest. Фиксация важна, так как релизы меняются быстро: Docker Hub при проверке 8 ноября 2026 года показывал, что и 0.38.4, и 0.38.5 были загружены в течение последних суток. Среду выполнения агента, которая меняется без вашего ведома, сложно отлаживать. Зафиксируйте текущий релиз вместо копирования 0.5.5 с этой страницы; на 9 ноября 2026 года это было 0.40.0. Затем скопируйте файл окружения, установите права доступа и запустите.
cp .env.example .env
chmod 600 .env
docker compose up -d
docker compose logs -f.env содержит ваш ключ провайдера в открытом виде, поэтому режим 600 является минимально допустимым. Если подкоманда docker compose вам незнакома, шпаргалка по командам Docker Compose охватывает основные повседневные операции.
Почему порт публикуется на 127.0.0.1, а не на 0.0.0.0
-p 3000:3000 по умолчанию публикует порт на всех интерфейсах хоста. -p 127.0.0.1:3000:3000 публикует порт хоста только на loopback. В версиях Docker старше 28.0.0 хосты в том же сегменте L2 могут получить доступ к портам, опубликованным на localhost, а явно настроенная прямая маршрутизация может открыть порт контейнера вовне, несмотря на привязку к loopback. Контейнер по умолчанию слушает порт 3000 внутри, что настраивается через PORT, поэтому измените номер порта слева, чтобы избежать конфликта портов на хосте. Проверьте результат:
docker port harnessrouter
sudo ss -ltnp | grep 3000ss вывод 127.0.0.1:3000 — это правильно. 0.0.0.0:3000 означает, что консоль привязана ко всем интерфейсам IPv4; доступ из публичного интернета всё равно зависит от маршрутизации и фильтрации. В данном случае это опаснее, чем для большинства self-hosted приложений, так как консоль создает окружения, читает все транскрипты, запускает агентов и предоставляет им доступ к оболочке и реальной файловой системе в их рабочем пространстве. Она также хранит ключ провайдера, который вы использовали для подключения. Любой, кто получит доступ к незащищенной консоли, сможет прочитать вашу работу, выполнить команды и использовать ваш ключ.
Правило запрета ufw вас не спасет. Docker перенаправляет трафик опубликованных контейнеров через свои собственные правила до того, как они попадают в цепочки, которыми управляет ufw, поэтому sudo ufw status, показывающий порт как закрытый, не гарантирует, что опубликованный порт действительно заблокирован. Проверяйте с другой машины, а не с самого VPS, иначе тест не будет иметь смысла. Это тот же урок, что и при запуске dsh в headless-режиме на порту 3080: привязывайте сервис к loopback, а затем осознанно решайте, как вы будете получать к нему доступ.
Измените стандартные учетные данные перед началом работы
Войдите в систему по адресу http://localhost:3000, используя имя пользователя harnessrouter и начальный пароль, сгенерированный для вашего экземпляра. Прочитать его можно командой:
docker exec harnessrouter cat /data/selfhost-initial-passwordОбщий пароль harnessrouter работал в версии 0.5.5; текущие установки не принимают этот опубликованный стандартный пароль.
Измените его на странице Profile или задайте при запуске для автоматизированного развертывания. Переменные HR_AUTH_USER и HR_AUTH_PASSWORD позволяют указать начальные учетные данные; данные, сохраненные в профиле, имеют приоритет.
docker run -d --name harnessrouter \
-p 127.0.0.1:3000:3000 \
-v harnessrouter:/data \
-e HR_AUTH_USER='you' \
-e HR_AUTH_PASSWORD='the-password-you-chose' \
harnessrouter/harnessrouterДля локального входа в Console не предусмотрено восстановление пароля через электронную почту. Если вы потеряли пароль, удалите файл аутентификации в томе и перезапустите службу, после чего войдите с использованием настроенных вами HR_AUTH_USER и HR_AUTH_PASSWORD или с помощью сгенерированного начального пароля, если вы не задавали свой собственный.
docker stop harnessrouter
docker run --rm -v harnessrouter:/data alpine rm -f /data/selfhost-auth.json
docker start harnessrouterПараметр HR_AUTH_DISABLED=1 полностью отключает экран входа в систему. В руководстве по self-hosting указано, что это «разумно только на машине, к которой никто другой не имеет доступа». VPS с публичным IP-адресом не является такой машиной, поэтому не отключайте проверку входа, если только вы не запускаете систему на локальном ноутбуке.
Проверьте версию, так как в старых версиях отсутствует шлюз аутентификации
К этому разделу следует отнестись со всей серьезностью. Версии 0.1.x и 0.2.0 были выпущены вообще без шлюза аутентификации: любой, кто мог подключиться к порту 3000, получал доступ к консоли. Версия 0.3.0 стала первым релизом с поддержкой входа в систему. На этой странице последние записи об этих старых тегах были зафиксированы как опубликованные и доступные для загрузки 12 октября 2026 года; их текущая доступность не была подтверждена 8 ноября 2026 года.
По состоянию на 19 августа 2026 года новейшим опубликованным тегом был 0.5.5 от 18 августа 2026 года. На 8 ноября 2026 года тег latest указывал на 0.38.5. Проверьте, какая версия установлена у вас, а затем сравните ее со списком тегов на Docker Hub:
docker image ls harnessrouter/harnessrouterВсе версии ниже 0.3.0 необходимо заменить немедленно, не откладывая на потом. В старых релизах с общим паролем по умолчанию его все еще нужно сменить; в текущих установках генерируется начальный пароль, после чего система предлагает задать собственный. Не считайте номера версий на этой странице актуальными. Они были верны на указанные даты, а данный проект обновляется быстро.
Подключение провайдера
Ничего не заработает, пока не подключен провайдер моделей. Добавьте его через Bring your own key в меню учетной записи или передайте в docker run в качестве переменной окружения. Значение представляет собой JSON, поэтому при вводе в оболочке его необходимо заключить в кавычки:
-e HR_SECRET_GLOBAL_HARNESS_CONN_ANTHROPIC='{"name":"anthropic","provider":"anthropic","api_key":"sk-ant-…"}'.env.example задает одну переменную подключения для каждого семейства провайдеров: HR_SECRET_GLOBAL_HARNESS_CONN_ANTHROPIC для бэкенда claude-code, HR_SECRET_GLOBAL_HARNESS_CONN_OPENAI для бэкенда codex, HR_SECRET_GLOBAL_HARNESS_CONN_GOOGLE для бэкенда gemini и HR_SECRET_GLOBAL_HARNESS_CONN_CUSTOM для любого OpenAI-совместимого endpoint, куда направляются запросы к агрегатору или вашему собственному серверу инференса. Соответствующие переменные HR_SECRET_GLOBAL_HARNESS_POLICY_CLAUDE, HR_SECRET_GLOBAL_HARNESS_POLICY_CODEX и HR_SECRET_GLOBAL_HARNESS_POLICY_HERMES определяют, какое подключение использует каждый бэкенд по умолчанию; для каждого бэкенда предусмотрена своя переменная политики. HR_SECRET_KEY — это отдельный параметр. Текущие релизы шифруют сохраненные учетные данные с его помощью, генерируя ключ в /data/secret-key, если вы не предоставили свой. Сохраняйте один и тот же ключ при перезапусках и обновлениях; чтобы отделить его от данных существующего экземпляра, установите HR_SECRET_KEY в значение из этого файла и удалите сам файл.
HR_BACKENDS определяет, какие бэкенды устанавливаются и загружаются, как в HR_BACKENDS=claude,codex,hermes. Если переменная не задана, текущие релизы устанавливают расширенный список из 30 бэкендов по умолчанию, включая claude, codex, hermes, opencode, gemini, goose и другие, поэтому сокращение списка экономит место на диске и время первого запуска. В текущем руководстве по self-hosting рекомендуется «исключить любой из них из HR_BACKENDS, если вы не планируете его использовать», а в качестве примера минимальной конфигурации приводится HR_BACKENDS=opencode, где Hermes полностью исключен. Ошибка при установке бэкенда не является критической: остальные продолжают работать, а задача для не установленного бэкенда отклоняется с сообщением "not installed", при этом в логе контейнера указывается имя бэкенда, установка которого завершилась неудачей. В README для 0.5.5 была описана известная проблема, при которой исключение hermes приводило к немедленному завершению работы контейнера со статусом 1 без сообщения об ошибке, однако entrypoint этого тега уже исправляет данную проблему; комментарии к нему описывают предыдущую реализацию. Если Hermes — единственный нужный вам инструмент, запуск агента Hermes на отдельном VPS будет более компактным вариантом развертывания.
Вызов API без использования консоли
Консоль не является обязательной. Один и тот же API обслуживает оба варианта, используя контракт в стиле Responses. Сначала выполните вход, чтобы получить сессионный cookie:
curl -c hr.cookies http://localhost:3000/api/selfhost/login \
-H 'content-type: application/json' \
-d '{"username":"harnessrouter","password":"your-password"}'Затем отправьте задачу, указав harness в metadata.harness_id и модель, которую фактически предоставляет ваш подключенный провайдер:
curl -s -b hr.cookies http://localhost:3000/api/harness/v1/responses \
-H 'content-type: application/json' \
-d '{"input":"Reply with exactly this and nothing else: it works.",
"metadata":{"harness_id":"codex"},
"model":"gpt-5.4-mini",
"stream":false}'JSON-объект, содержащий блок вывода и количество токенов, означает, что harness успешно отработал. Изменение harness_id с codex на claude-code отправляет тот же запрос другому harness, и эта возможность подмены является основной причиной существования данного ПО. Обратите внимание, что id имеет значение claude-code, несмотря на то, что имя бэкенда в HR_BACKENDS, а переменная политики — claude. Пользовательское подключение, описанное выше, показывает, как направить harness на совместимый с OpenAI эндпоинт, который вы уже хостите, аналогично тому, как настраивается self-hosted DeepSeek harness на VPS.
Поток с использованием сессионного cookie по-прежнему поддерживается для локальной отладки. Для продуктового бэкенда текущая документация рекомендует создать API-ключ HarnessRouter в разделе API Keys и передавать его в качестве Bearer-токена вместо поддержания сессии консоли.
Доступ с вашего ноутбука без публикации порта
Есть два способа, и ни один из них не требует открытия порта на 0.0.0.0.
SSH-туннель — самый простой вариант, не требующий установки дополнительного ПО на сервере. Он перенаправляет локальный порт на вашей машине на loopback-интерфейс VPS.
ssh -N -L 3000:127.0.0.1:3000 you@your-vpsОставьте эту команду запущенной и откройте http://localhost:3000 в браузере. Если SSH выводит bind: Address already in use, значит, порт 3000 на вашем ноутбуке уже занят. Выберите другой локальный порт с помощью -L 3100:127.0.0.1:3000 и перейдите по адресу порта 3100.
Терминирующий reverse proxy — подходящее решение, если доступ нужен другим пользователям. Прокси хранит TLS (transport layer security) сертификат и перенаправляет запросы на loopback. В руководстве по self-hosting приведена конфигурация для Caddy:
console.example.com {
encode zstd gzip
reverse_proxy 127.0.0.1:3000 {
flush_interval -1 # agent turns stream for minutes; never buffer them
}
}flush_interval -1 явно отключает буферизацию ответов в Caddy; Caddy и без этого сразу передает ответы text/event-stream. Агент генерирует токены потока в течение нескольких минут, а прокси, который буферизирует ответ, удерживает эти токены до завершения генерации. Из-за этого консоль кажется зависшей, а затем выводит всё содержимое сразу. Аналогичная настройка в Nginx — proxy_buffering off; внутри блока location. Что бы вы ни выбрали, DNS-имя должно указывать на прокси, а контейнер — на loopback. В статье Сравнение Nginx, Caddy и Traefik в качестве reverse proxy описано, какой вариант лучше подходит для вашего сервера.
Запуск от имени отдельного пользователя, а не root
Демон Docker работает с правами root, а членство в группе docker равносильно получению прав root, так как участник группы может запустить контейнер, который примонтирует файловую систему хоста. Таким образом, добавление команды в группу docker фактически предоставляет права root на сервере, где хранится ваш ключ провайдера.
Простой вариант: создайте сервисную учетную запись, которая будет владельцем файла compose и .env, и храните эти файлы вне любых общих домашних каталогов.
sudo adduser --disabled-password --gecos "" harness
sudo install -d -o harness -g harness -m 750 /srv/harnessrouterНе пытайтесь добиться этого добавлением --user в docker run или user: в файле compose. Текущее руководство гласит, что контейнер должен запускаться от имени root, и начиная с 0.8.2 он отказывается запускаться иначе, о чем свидетельствует соответствующая строка в логах.
Более надежный вариант — rootless Docker, где сам демон работает от имени непривилегированного пользователя. Для этого требуется пакет uidmap для newuidmap и newgidmap, а также не менее 65536 подчиненных UID в /etc/subuid и /etc/subgid для пользователя. uidmap присутствует в архиве Ubuntu, но docker-ce-rootless-extras — нет: он поставляется из собственного apt-репозитория Docker по адресу download.docker.com, который добавляется при установке Docker engine. Если вы не устанавливали движок из этого репозитория, grep -rl download.docker.com /etc/apt/sources.list.d/ ничего не выведет, и приведенная ниже установка не найдет пакет.
sudo apt install -y uidmap docker-ce-rootless-extras
sudo loginctl enable-linger harness
sudo -iu harness
dockerd-rootless-setuptool.sh install
export DOCKER_HOST=unix:///run/user/$(id -u)/docker.sock
systemctl --user enable --now dockerloginctl enable-linger позволяет экземпляру systemd пользователя продолжать работу после выхода из системы и запускает его при загрузке. Подтвердите результат с помощью docker info, который должен отобразить rootless в разделе Security Options. В режиме rootless невозможно привязаться к портам ниже 1024 без дополнительной настройки, что в данном случае не имеет значения, так как порт 3000 находится выше этого диапазона. Настройка самой учетной записи описана в создании пользователей с минимальными привилегиями на VPS.
Что может пойти не так и что вы увидите
Контейнер завершается через секунду после запуска, а логи пусты. docker ps -a показывает Exited (1). Предыдущая точка входа (entrypoint) завершалась с ошибкой, когда HR_BACKENDS не содержала hermes, но 0.5.5 уже включает исправление, несмотря на то, что в README всё ещё упоминается эта проблема. Не пытайтесь диагностировать этот сбой только по коду завершения. В актуальном теге прочитайте последнюю строку docker logs: начиная с 0.8.2 контейнер, запущенный с --user, завершается с сообщением о том, что он должен быть запущен от имени root.
Первый запуск не завершается. Лог останавливается после строки installing, а ready on :3000 так и не появляется. Проверьте, есть ли у сервера доступ к сети для загрузки CLI агентов, так как их нет в образе. И 0.5.5, и текущие релизы допускают завершение установки с ошибками, указывая сбойные компоненты в логе и исключая их из строки backends available:. Исправьте исходящий маршрут или настройки прокси, затем перезапустите сервис.
Консоль загружается, но все задачи завершаются ошибкой. Не подключен ни один провайдер. В образе нет встроенных моделей или бесплатного уровня доступа, поэтому даже после входа в систему новый экземпляр не сможет ничего выполнить.
Консоль зависает во время генерации ответа при работе через прокси. Вывод появляется целиком одним блоком только после завершения генерации. Это происходит из-за буферизации ответов. Установите flush_interval -1 в Caddy или proxy_buffering off; в Nginx.
Вы не можете подключиться к сервису с ноутбука, хотя туннель активен. Выполните docker port harnessrouter на сервере. Если команда ничего не выводит, значит контейнер не публикует порты. Проверьте настройки проброса портов (port mapping) и сетевой режим (network mode).
Стоит ли это использовать?
Использовать это стоит, если вы действительно применяете более одного harness и хотите иметь одну точку входа и одно хранилище учетных данных вместо трех для каждого. Также это оправдано, если вы создаете продукт поверх этого и хотите, чтобы harness был параметром конфигурации, а не требовал переписывания кода. Именно это дает вам UHP, с учетом упомянутого выше предостережения о том, насколько молод этот протокол.
Использовать это не стоит, если вы применяете только один harness. Установка соответствующего CLI на сервер означает меньше движущихся частей, и между вами и инструментом не будет промежуточного входа в систему. Это также неверный подход, если вам нужно, чтобы несколько агентов взаимодействовали в рамках одной задачи, а не один API перед несколькими harness — для этого существуют другие инструменты: см. multi-agent harness, например Omnigent. В любом случае правила развертывания остаются неизменными. Привязка к loopback, измененный пароль, зафиксированный текущий релиз и отдельный пользователь.
FAQ
Безопасно ли публиковать HarnessRouter на порту 3000?
Нет. Консоль создает окружения, читает все транскрипты, запускает агенты с доступом к оболочке и файловой системе, а также хранит ключ провайдера, который вы подключили. Поэтому незащищенная консоль открывает доступ ко всему этому. Опубликуйте сервис на loopback с помощью -p 127.0.0.1:3000:3000 и обращайтесь к нему через SSH-туннель или reverse proxy с TLS termination. Правила запрета ufw сами по себе недостаточны: Docker перенаправляет трафик опубликованного контейнера в обход цепочек, которыми управляет ufw. Проверьте это с помощью sudo ss -ltnp | grep 3000, которая должна вывести 127.0.0.1:3000, и протестируйте доступ с другой машины. Используйте Docker 28.0.0 или новее, чтобы избежать старой проблемы с доступом к localhost в пределах одного L2, и убедитесь, что прямая маршрутизация не была включена.
В какой версии HarnessRouter появилась страница входа?
0.3.0. Версии 0.1.x и 0.2.0 поставлялись без какой-либо аутентификации, поэтому любой, кто их запускает, полагается лишь на то, что никто не обнаружит порт. На этой странице последние записи об этих тегах как опубликованных и доступных для скачивания датированы 12 октября 2026 года; их текущая доступность не подтверждалась на 8 ноября 2026 года. По состоянию на 19 августа 2026 года новейшим тегом был 0.5.5 от 18 августа 2026 года; на 8 ноября 2026 года latest указывал на 0.38.5. Запустите docker image ls harnessrouter/harnessrouter, чтобы увидеть, что у вас установлено, сравните это со списком тегов на Docker Hub, а не с этой страницей, и выберите собственный пароль. Текущие установки генерируют начальный пароль вместо использования старого общего пароля по умолчанию.
Почему контейнер завершает работу сразу после того, как я задаю HR_BACKENDS?
В текущем релизе этого быть не должно. Руководство по self-hosting рекомендует исключать любые бэкенды, которые вы не будете использовать, а ошибка при установке бэкенда не является критической. Ранняя реализация завершалась с кодом 1 без сообщения об ошибке, если hermes был пропущен, но исходный код 0.5.5 уже исправляет этот сбой, несмотря на то, что в README это все еще указано. В недавнем теге прочитайте docker logs: начиная с 0.8.2 контейнер, запущенный с --user, завершает работу с одной строкой сообщения о том, что он должен быть запущен от имени root.
Нужен ли HarnessRouter доступ в Интернет при первом запуске?
Да. CLI агентов загружаются при первом запуске, а не поставляются внутри образа, и каждый из них остается предметом собственной лицензии и условий использования. Как 0.5.5, так и текущие релизы указывают на неудачные установки в логах и позволяют запускаться другим бэкендам. Установленные CLI кэшируются на томе, поэтому последующие запуски обычно проходят быстрее, хотя инструментам бэкенда и выполняемым задачам все еще может потребоваться доступ к сети, а новый или ранее не установившийся бэкенд может инициировать повторную установку.
Я потерял пароль от консоли. Как мне войти снова?
Для локального входа в консоль нет функции сброса пароля через email. Остановите контейнер, удалите /data/selfhost-auth.json с тома, запустите его снова, затем войдите с помощью настроенных вами HR_AUTH_USER и HR_AUTH_PASSWORD или сгенерированного начального пароля, если вы не задали свой, и установите новый пароль на странице профиля. Если контейнер и том имеют имя harnessrouter, то это docker stop harnessrouter, затем docker run --rm -v harnessrouter:/data alpine rm -f /data/selfhost-auth.json, затем docker start harnessrouter. Прочитайте сгенерированный пароль с помощью docker exec harnessrouter cat /data/selfhost-initial-password.