harnsy

Релей: доступ к вашим машинам откуда угодно

Компьютер дома или в офисе обычно не виден снаружи: у него нет публичного адреса, а на пути стоит роутер. Релей решает это. Ваши машины сами подключаются к нему, а он соединяет их: телефон открывает вашу панель, ноутбук работает с домашней машиной. С harnsy Max.

Что делает релей. Он только передаёт зашифрованные байты дальше. По замыслу он не может прочитать ваши сообщения, токены или панель: шифрование идёт от телефона или машины до другой вашей машины, а не до релея. Он видит, какие машины подключаются, когда и сколько данных проходит. У релея harnsy есть ещё одна точка доверия: см. «Чему вы здесь доверяете».

Две задачи (один релей может делать обе):

  • Открыть панель машины с телефона или другого компьютера по адресу вроде https://k3f9q2.n.harnsy.app.
  • Соединить машины одной команды (кластер), которые не видят друг друга напрямую, например ноутбук как главную машину и сервер как участника.

Какой релей выбрать

Релей harnsyЛичный релейСвой релей
Где работаетнаш сервер, relay.harnsy.app (бета)ваш серверваш сервер
Для чеголюбая ваша машинаодин компьютер, одно ваше имянесколько машин и их панели
Что настроитьничего: одна кнопкаодно имя в DNS, одна команда, одна строкаимя, имя с подстановкой, служба, токен на каждую машину
Нужноharnsy Maxключ harnsy Max на серверелицензия с правом «свой релей»

Начните с релея harnsy. Свой берите, когда не хотите, чтобы трафик шёл через нашу машину.

Открыть панель с телефона: релей harnsy

  1. На машине откройте панель: Настройки › Связь снаружи › «Дашборд с телефона и ноутбука», шаг «Доступ из интернета».
  2. Выберите Релей harnsy и нажмите Применить. Заполнять ничего не нужно. Примерно через 15 секунд шаг покажет «релей подключён» и адрес https://<id>.n.harnsy.app. Сертификат для него приходит сам.
  3. Привяжите телефон: на шаге «Привяжите телефон или ноутбук» нажмите «Создать код» и отсканируйте QR-код телефоном. Код действует один раз, 5 минут.
  4. Сразу создайте на телефоне ключ входа (отпечаток, лицо или PIN-код), затем войдите с ним. Все шаги и что телефон может до и после: harnsy на телефоне как приложение.

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

Чему вы здесь доверяете. Релей передаёт зашифрованные байты и не может их прочитать, но наш сервис лицензий хранит DNS-ключ зоны n.harnsy.app, поэтому тот, у кого этот ключ, мог бы получить сертификат на ваше имя. harnsy следит за публичными журналами сертификатов и поднимает тревогу, если появится сертификат, которого он не запрашивал. Свой домен или свой релей такого доверия не требуют.

Релей harnsy — бета: его адрес и лимиты (месячный объём трафика, скорость на соединение) ещё могут измениться. Что он записывает и сколько хранит: Приватность: релей harnsy.

Соединить машины через релей

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

  1. На главной машине в терминале включите релей:
    Shell
    harnsy debug cluster relay on

    Используется релей harnsy. Перезапустите harnsy на этой машине: изменение применяется при следующем запуске. Переключателя для этого в панели нет; Настройки › Машины только показывают, работает релей или нет.

  2. Откройте Настройки › Машины › «+ Подключить машину», оставьте адрес пустым и нажмите «Получить команду». Окно скажет, что связь пойдёт через релей harnsy и настраивать ничего не нужно. Выполните эту одну команду на другой машине. Шаги: Несколько машин.
  3. Проверьте: Настройки › Машины показывают каждую подключившуюся машину.

harnsy debug cluster relay показывает релей и его состояние. harnsy debug cluster relay off выключает его; участникам тогда снова нужен прямой адрес. После off тоже перезапустите harnsy. (Короткая форма harnsy cluster relay … делает то же самое.)

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

Личный релей: один компьютер по вашему имени

Мы ещё не проверяли это целиком на настоящем сервере: шаги написаны по коду harnsy и его собственной документации. Сначала попробуйте на запасном сервере и сообщите нам, если какой-то шаг не сработает.

Для одного компьютера, который должен открываться по постоянному вашему адресу, например https://harnsy.example.com, с телефона. Другим машинам ничего не предлагается.

Нужно: небольшой Linux-сервер с публичным адресом и свободным портом 443; имя, которым вы управляете; harnsy Max. Ключ на сервере занимает одно из мест ключа, как любой ваш компьютер; вернуть его можно командой hr license deactivate на сервере (hr из раздела «Свой релей», шаг 1; не больше 3 раз за 30 дней).

  1. DNS: одна A-запись, harnsy.example.com → сервер.
  2. На сервере: положите туда программу harnsy (хватит Linux-архива релиза; установщик не запускайте и harnsy serve не стартуйте), добавьте лицензию (см. «Свой релей», шаги 1 и 2), затем выполните:
    Shell
    harnsy relay serve --personal harnsy.example.com

    Первый запуск печатает одну строку привязки, которая начинается с harnsy-relay://. Это секрет: она показывается один раз и нигде не хранится. За NAT добавьте --public-ip <ip>.

  3. На вашем компьютере: Настройки › Связь снаружи › «Дашборд с телефона и ноутбука» › Свой релей › вставьте строку › Подключить. Компьютер сам получает сертификат для harnsy.example.com и открывается по адресу https://harnsy.example.com. Привяжите телефон, как выше.

Первый компьютер, подключившийся по строке, привязывается к релею насовсем; другой с той же строкой получит отказ. Потеряли строку, пока ни один компьютер ею не воспользовался? harnsy relay line на сервере напечатает новую (старая перестанет работать). Чтобы перейти на другой компьютер, выполните на сервере harnsy relay unbind: он отключит привязанный компьютер и напечатает новую строку. Если адрес сервера сменился, сделайте то же; имя для телефона останется прежним.

Свой релей: несколько машин и панели

Мы ещё не проверяли это целиком на настоящем сервере: шаги написаны по коду harnsy и его собственной документации. Сначала попробуйте на запасном сервере и сообщите нам, если какой-то шаг не сработает.

Та же программа на сервере, которым управляете вы. Трафик идёт через вашу машину, а у нашего сервиса лицензий ничего не запрашивается.

Нужно

  1. Linux-сервер с постоянным публичным адресом. Порт 443 свободен и открыт в его файрволе.
  2. Имя для него, например relay.example.com, указывающее на сервер. Для панелей ваших машин ещё имя с подстановкой, например *.n.example.com, на тот же сервер.
  3. Лицензия с правом «свой релей». Без него релей не запустится и скажет edition_relay_host. Ключ на сервере занимает одно из своих мест; вернуть его можно командой hr license deactivate (не больше 3 раз за 30 дней).
  4. Программа harnsy на сервере: хватит Linux-архива релиза. Установщик там не запускайте и harnsy serve не стартуйте.

1. Дайте релею свою папку и пользователя.

Shell
sudo useradd --system --create-home --home-dir /var/lib/harnsy-relay harnsy-relay
sudo install -m 0755 harnsy /usr/local/bin/harnsy
alias hr='sudo -u harnsy-relay env HARNSY_HOME=/var/lib/harnsy-relay harnsy'

Каждая команда hr … ниже выполняется от этого пользователя с этой папкой.

2. Добавьте лицензию.

Shell
hr license add /path/to/your-licence-file
hr license

3. Один раз запустите вручную.

Shell
hr relay serve --addr :443 --domain relay.example.com --email you@example.com

harnsy сам получает бесплатный сертификат Let's Encrypt для имени на порту 443 (порт 80 не нужен). Когда он напечатает harnsy relay on …, всё работает; остановите его через Ctrl+C. Если он остановился с сообщением о сертификате, имя ещё не указывает на этот сервер или порт 443 закрыт.

Со своим сертификатом: --cert cert.pem --key key.pem. Тогда релей печатает relay pin sha256/…: сохраните, он нужен вашим машинам.

4. Пусть запускается сам. Создайте /etc/systemd/system/harnsy-relay.service — содержимое как в английской версии выше (файл службы не переводится).

Shell
sudo systemctl daemon-reload
sudo systemctl enable --now harnsy-relay
sudo systemctl status harnsy-relay

--web-zone (имя с подстановкой без *.) и --web-acme нужны только для панелей; если только соединяете машины, уберите оба.

5. Токен для каждой машины.

Shell
hr relay token add home-pc

Команда один раз печатает строку, начинающуюся с hrelay_. Скопируйте её сразу: harnsy хранит только отпечаток. Один токен на машину, с её именем; hr relay token list показывает их, hr relay token revoke home-pc отменяет один.

6. Подключите машины.

  • Машины команды: на главной машине выполните harnsy debug cluster relay on --url https://relay.example.com --token hrelay_… (со своим сертификатом добавьте --pin sha256/…), затем перезапустите там harnsy. Остальные машины подключите, как в разделе «Соединить машины через релей».
  • Панель машины: на этой машине Настройки › Связь снаружи › «Дашборд с телефона и ноутбука» › Свой релей: адрес релея, токен, зона (n.example.com) и, только для своего сертификата, пин. Нажмите Применить. Примерно через 15 секунд шаг покажет, что релей подключён, и адрес https://<id>.n.example.com, который для этой машины не меняется.

Каждый день

  • Журнал: journalctl -u harnsy-relay. Перезапуск: sudo systemctl restart harnsy-relay; машины переподключатся сами.
  • Обновление: замените /usr/local/bin/harnsy новым harnsy и перезапустите службу.
  • Отменить машину: hr relay token revoke <имя>. Заблокировать: hr relay ban add <id> "почему"; hr relay ban list, hr relay ban remove <id>.
  • Если лицензии нет или срок кончился, работающий релей не принимает новые машины.

Работает ли

Вы видитеОбычно
шаг пишет, что не может подключиться к релеюневерный токен или пин, или релей недоступен; сообщение говорит, что именно
страница не открывается с телефонамашина спит или не в сети; или, со своим релеем, имя с подстановкой не указывает на сервер
релей не запускается: edition_relay_hostу лицензии на сервере нет права «свой релей»
ошибка сертификата на сервереимя ещё не указывает на сервер или порт 443 закрыт
личный релей отказывает второму компьютерустрока привязана к первому: harnsy relay unbind на сервере
участники перестали подключаться после relay offим снова нужен прямой адрес, или включите релей обратно

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

  • Храните токен или строку привязки как пароль: они показываются один раз; один — на одну машину.
  • Релей по замыслу не может прочитать ваш трафик; с релеем harnsy вы ещё доверяете нашему сервису лицензий, у которого хранится DNS-ключ вашего адреса (см. «Чему вы здесь доверяете»). Он видит, какие машины подключаются и сколько данных идёт. Обновляйте свой сервер релея и держите открытым в мир только порт 443.
  • Телефон, вошедший снаружи, может отдавать команды вашим агентам, а агенты могут выполнять команды на вашей машине. Поставьте на телефон блокировку экрана и сразу выходите с потерянного устройства: Настройки › Связь снаружи › Устройства.

Что это умеет →

Есть вопросы? Спросите в группе →

Anthropic, Claude Code, OpenAI, ChatGPT, Codex, OpenCode, pi, Telegram, Discord, GitHub, Apple, macOS, iOS, iPhone, Safari, Google, Android, Chrome, Microsoft, Windows, Windows Security, Defender и QR Code — названия продуктов их владельцев. harnsy не связан с ними и не одобрен ими. iOS — товарный знак Cisco, используемый Apple по лицензии; QR Code — зарегистрированный товарный знак DENSO WAVE INCORPORATED. Логотипов нет.