Главная машина может быть за NAT. Никто не открывает порт.

Сделайте её главной.

На машине, которая станет главной, один раз выполните это в терминале; кнопки в дашборде для этого нет. home — имя, которое вы выбираете сами. Начните с этого: команда релея ниже работает только на главной машине.

Включите релей.

Машине нужен ключ harnsy Max (страница «Лицензия»). Команда использует наш размещённый релей, он в бете.

Перезапустите harnsy на этой машине.

Работающая главная машина читает настройку релея только при запуске. Перезапустите harnsy, чтобы она вступила в силу. Linux: systemctl --user restart harnsy.service. macOS: launchctl kickstart -k gui/$(id -u)/com.github.butschster.harnsy. Windows: schtasks /End /TN harnsy, затем schtasks /Run /TN harnsy.

Выпустите строку присоединения для другой машины.

В дашборде откройте «Узлы» и выберите «Добавить в кластер». Выберите «Узел», назовите машину (например server), задайте права и оставьте «Адрес мастера» пустым, чтобы строка несла адрес релея. Нажмите «Выпустить токен». «manage» — это доступ к shell главной машины: давайте его только своей машине.

Вы увидите «Показан один раз. Скопируйте его сейчас.» и «Выполните это на server.», а под ними строка harnsy debug cluster init server --join harnsy-relay://… --token <token>.

Проверьте, что релей подключён.

Откройте «Узлы» на главной машине. Панель релея (в дашборде он называется «посредник») показывает «ждёт», пока нет токена присоединения или лицензия не разрешает другие машины. В терминале команда печатает релей и адрес, по которому подключаются участники.

Вы увидите «подключён с …», «адрес для участников» (harnsy-relay://…) и «доступ к посреднику: продлевается сам».

Присоединитесь на другой машине.

В дашборде другой машины откройте «Узлы», выберите «Вступить в кластер мастера», вставьте строку и нажмите «Вступить». Или выполните строку в терминале. Вставляйте строку целиком: присоединение через релей без пина отклоняется.

Вы увидите «Узел вступил в … подключается…». На главной машине участник появляется в списке «Узлов», а в его строке — «путь: через посредника …».

Подготовьте главную машину.

Настройте её как в случае 1 или возьмите главную машину, до адреса которой коллега может дотянуться.

Решите, чей harnsy Max будет у коллеги.

Машина со своим ключом harnsy Max не занимает место. Машина без ключа берёт harnsy Max у главной, пока есть свободное место. Число мест задаёт ваш ключ.

Вы увидите В «Лицензии» — панель «Места для подключённых машин»: «Занято: 1 из 3.»

Выпустите токен для коллеги.

В дашборде: «Узлы» → «Добавить в кластер», «Узел», имя их машины, права, «Выпустить токен». Дайте только нужное: read и send. «manage» — это доступ к вашему shell.

Вы увидите Токен появляется один раз: «Показан один раз. Скопируйте его сейчас.»

Передайте им строку, не публично.

В строке секрет — токен. В ней же пин главной машины, поэтому их машина проверяет, что говорит именно с вашей.

Коллега присоединяется.

На их машине: «Узлы» → «Вступить в кластер мастера», вставить строку, «Вступить». Или выполнить строку в терминале.

Вы увидите «На связи.» Если у машины нет своего ключа, а у главной нет свободного места: «На связи. Мастер ещё не одолжил harnsy Max: возможно, в его лицензии нет свободного места.»

Проверьте.

На главной машине машина коллеги есть в списке «Узлов». Если она взяла место, «Лицензия» показывает его занятым. Главная машина видит имена их агентов, харнес, статус и папку; вход остаётся на их машине.

Сервер — участник: подключайте напрямую.

Участник всегда соединяется сам и не открывает порт, поэтому сервер за NAT или файрволом присоединяется к доступной главной машине напрямую. Выпустите токен и присоединитесь как в случае 2.

Сервер — главная машина: используйте релей.

Если сам сервер — главная машина и до него не дотянуться, настройте его как в случае 1. Участники подключаются к нему через адрес релея, без открытого порта.

Настройте релей как в случае 1.

Шаги 1 и 2 из случая 1; перезапуск — дальше.

Откройте порт кластера для прямых участников.

Это нужно только для машин вашей сети: главной машине, у которой только участники через релей, открытый порт не нужен. Запустите установщик ещё раз с адресом кластера. Он перепишет службу и перезапустит harnsy, а это и есть перезапуск, который нужен настройке релея. 0.0.0.0 — все адреса этой машины; чтобы открыть порт только в вашей сети, укажите адрес машины в ней, например 192.168.1.10:7789. Порт сам отдаёт TLS.

Выпустите токен для участника через релей.

Оставьте «Адрес мастера» пустым: строка несёт адрес релея.

Выпустите токен для прямого участника.

Впишите в «Адрес мастера» адрес главной машины в вашей сети.

Присоедините каждую машину её строкой.

Как в шаге 6 случая 1, каждую на своей машине.

Вы увидите В каждой строке «Узлов» указан путь: «через посредника …» или «напрямую, порт 7789».

Найдите его токен.

На главной машине: «Узлы» → «отозвать» рядом с токеном участника, и всё. В терминале сначала выведите список токенов.

В терминале отзовите по номеру.

Номер возьмите из списка.

Вы увидите Соединение участника закрывается сразу, если отозвать в дашборде, и в течение 20 секунд, если из терминала. Всё, что ждало его в очереди, отбрасывается. Место освобождается в этот момент: в «Лицензии» занято на одно меньше. Участник, который брал harnsy Max, сохраняет его, пока не кончится его последняя выдача, до 3 дней.