Source: https://harnsy.dev/ru/docs/relay

> Доступ к машинам harnsy за роутером откуда угодно: они сами подключаются к релею, а он передаёт только зашифрованные байты. С harnsy Max.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

1. На главной машине в терминале включите релей:
   Shell
   
   ```bash
   harnsy debug cluster relay on
   ```
   Используется релей harnsy. Перезапустите harnsy на этой машине: изменение применяется при следующем запуске. Переключателя для этого в панели нет; Настройки › Машины только показывают, работает релей или нет.
2. Откройте Настройки › Машины › «+ Подключить машину», оставьте адрес пустым и нажмите «Получить команду». Окно скажет, что связь пойдёт через релей harnsy и настраивать ничего не нужно. Выполните эту одну команду на другой машине. Шаги: [Несколько машин](https://harnsy.dev/ru/docs/several-machines).
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
   
   ```bash
   harnsy relay serve --personal harnsy.example.com
   ```
   Первый запуск печатает одну **строку привязки**, которая начинается с `harnsy-relay://`. Это секрет: она показывается один раз и нигде не хранится. За NAT добавьте `--public-ip &lt;ip&gt;`.
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

```bash
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

```bash
hr license add /path/to/your-licence-file
hr license
```

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

Shell

```bash
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

```bash
sudo systemctl daemon-reload
sudo systemctl enable --now harnsy-relay
sudo systemctl status harnsy-relay
```

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

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

Shell

```bash
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://&lt;id&gt;.n.example.com`, который для этой машины не меняется.

**Каждый день**

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

## Работает ли

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

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

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

[Что это умеет →](https://harnsy.dev/ru/features/relay)

[Есть вопросы? Спросите в группе →](https://t.me/+Cs5Mimdes5UwOGVi)

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. Логотипов нет.
