Настройка ретранслятора

Ретранслятор (relay) передаёт данные, когда два устройства не могут соединиться напрямую. Если запустить его самому, этот трафик останется в вашей инфраструктуре. Для личного использования это бесплатно; бизнес-лицензия добавляет несколько ретрансляторов, неограниченные одновременные передачи и метрики использования. Нужен сервер с публичным IP-адресом и установленным Docker.

Установка

  1. 1

    Откройте UDP-порт 49737

    Разрешите его в файрволе сервера и в группе безопасности у вашего провайдера.

    sudo ufw allow 49737/udp
  2. 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. 3

    Укажите адрес сервера

    Compose читает .env при каждой команде, поэтому храните адрес в файле, а не передавайте его в командной строке.

    echo 'RELAY_HOST=203.0.113.7' > .env
  4. 4

    Запустите ретранслятор

    При первом запуске он создаёт постоянный идентификатор и сохраняет его в томе.

    docker compose up -d
  5. 5

    Скопируйте код ретранслятора

    В логах появятся ваш код и QR-код для телефонов, а после запуска — строка статистики каждые 30 секунд.

    docker compose logs relay
    AlterSend 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. 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:7f6f2d059d8a549e30314fa436a98fbe1f62d314a5ec2a2b2be980075ef75226

Org-код — это открытый ключ подписанной записи в сети, где хранится список ваших ретрансляторов вместе с адресами. Устройства читают список оттуда, поэтому смена серверов никогда не меняет код.

Несколько ретрансляторов

Установите ретранслятор так же на каждом сервере, с той же лицензией, чтобы ни на одном не было ограничений. Получите открытый ключ нового ретранслятора, затем опубликуйте полный список с сервера, который выдал ваш 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-адрес, а не домен: приложение сверяет адрес подключения, чтобы подписать передачу.

Кто может пользоваться моим ретранслятором?

Любой, у кого есть код вашего ретранслятора. Это не секрет, который можно сменить, поэтому относитесь к нему как к приглашению: давайте его своим устройствам и людям, с которыми работаете. Передачи в любом случае остаются под сквозным шифрованием.