Настройка ретранслятора
Ретранслятор (relay) передаёт данные, когда два устройства не могут соединиться напрямую. Если запустить его самому, этот трафик останется в вашей инфраструктуре. Для личного использования это бесплатно; бизнес-лицензия добавляет несколько ретрансляторов, неограниченные одновременные передачи и метрики использования. Нужен сервер с публичным IP-адресом и установленным Docker.
Установка
- 1
Откройте UDP-порт 49737
Разрешите его в файрволе сервера и в группе безопасности у вашего провайдера.
sudo ufw allow 49737/udp - 2
Создайте docker-compose.yml
services: relay: image: ghcr.io/altersend/relay:latest network_mode: host restart: unless-stopped environment: RELAY_HOST: ${RELAY_HOST:?set RELAY_HOST to this server's public IP} ALTERSEND_LICENSE: ${ALTERSEND_LICENSE:-} volumes: - relay-data:/etc/altersend-relay volumes: relay-data: - 3
Укажите адрес сервера
Compose читает .env при каждой команде, поэтому храните адрес в файле, а не передавайте его в командной строке.
echo 'RELAY_HOST=203.0.113.7' > .env - 4
Запустите ретранслятор
При первом запуске он создаёт постоянный идентификатор и сохраняет его в томе.
docker compose up -d - 5
Скопируйте код ретранслятора
В логах появятся ваш код и QR-код для телефонов, а после запуска — строка статистики каждые 30 секунд.
docker compose logs relayAlterSend relay listening relay public key: 6fad022df811a2bfbc734260df47c55499973409bc34b89f66ad791c24be2197 add this relay in AlterSend — Settings → Connection: relay:6fad022df811a2bfbc734260df47c55499973409bc34b89f66ad791c24be2197@203.0.113.7 [stats] egress 0GB | sessions=0 pairings=0 matched=0 - 6
Добавьте его в AlterSend
«Настройки» → «Ретранслятор» → «Собственный ретранслятор». Вставьте код и нажмите кнопку отправки: код сохранится, и подключение сразу проверится.
Код нужен только вашим собственным устройствам. Когда вы отправляете файл кому-то ещё, приложение само передаёт данные ретранслятора вместе с подключением.
Бизнес-лицензии
Добавьте лицензию в .env и перезапустите ретранслятор. Теперь он выводит не relay-код, а org-код. Раздайте этот один код всем устройствам команды: серверы за ним управляются централизованно и могут меняться, и никому не придётся вставлять код заново.
ALTERSEND_LICENSE=<ваша лицензия>
# необязательно: POST с объёмом и временем каждой передачи, больше ничего
REPORT_URL=https://example.com/hook
REPORT_TOKEN=<bearer-токен>[selfhost] licensed to Acme GmbH until 2027-08-27
[selfhost] published org relay record (seq 1)
add this relay in AlterSend — Settings → Connection:
org:7f6f2d059d8a549e30314fa436a98fbe1f62d314a5ec2a2b2be980075ef75226Org-код — это открытый ключ подписанной записи в сети, где хранится список ваших ретрансляторов вместе с адресами. Устройства читают список оттуда, поэтому смена серверов никогда не меняет код.
Несколько ретрансляторов
Установите ретранслятор так же на каждом сервере, с той же лицензией, чтобы ни на одном не было ограничений. Получите открытый ключ нового ретранслятора, затем опубликуйте полный список с сервера, который выдал ваш org-код. Другие серверы при первом запуске тоже выведут собственные org-коды; не обращайте на них внимания и раздавайте только самый первый.
# на новом сервере
docker compose exec relay node key.js
# на сервере, который выдал ваш org-код
docker compose exec relay node conf/publish.js \
<key1>@203.0.113.7@-5 \
<key2>@198.51.100.4@8Обновления и резервные копии
Обновление скачивает новый образ и перезапускает контейнер; идентификатор и настройки хранятся в томе, поэтому коды остаются действительными.
docker compose pull
docker compose up -dРешение проблем
В логах написано, что переменная RELAY_HOST не задана
Compose читает .env при каждой команде, а не только при up. Убедитесь, что файл лежит рядом с docker-compose.yml и содержит RELAY_HOST.
Приложение пишет, что не может связаться с ретранслятором
Почти всегда дело в UDP-порте 49737. Проверьте и файрвол сервера, и группу безопасности у провайдера, затем убедитесь через docker compose ps, что контейнер запущен.
Передачи всё равно идут напрямую
Обычно это нормально: ретранслятор передаёт данные, только когда два устройства не могут соединиться напрямую, а прямой путь, если он доступен, быстрее. Если приложение ни разу не показывает подключение через ретранслятор, проверьте, что в RELAY_HOST указан IP-адрес, а не домен: приложение сверяет адрес подключения, чтобы подписать передачу.
Кто может пользоваться моим ретранслятором?
Любой, у кого есть код вашего ретранслятора. Это не секрет, который можно сменить, поэтому относитесь к нему как к приглашению: давайте его своим устройствам и людям, с которыми работаете. Передачи в любом случае остаются под сквозным шифрованием.
