Files
buryan-infra/docs/CALL-FIX-2026-10-18.md
root 077c5325ac Звонки: исправлены ICE-адреса, добавлен TURN — почему было «не с первого раза»
Владелец провёл вызов: контент не отправлялся, соединение не с первого
раза. Нашёл три причины.

1. LIVeKIT ОБЪЯВЛЯЛ ПЯТЬ АДРЕСОВ вместо одного: публичный,
   IPv6, два docker-адреса и Tailscale. Так работает
   use_external_ip: true — он собирает ВСЕ адреса машины. Клиент пробует
   их по очереди, недоступные ждут таймаут, только потом доходит до
   рабочего. Отсюда задержка; отправка контента страдала по той же
   причине (данные идут отдельным каналом через тот же ICE).
   ИСПРАВЛЕНО: rtc.node_ip = 193.233.210.184, use_external_ip = false.
   Теперь в журнале «using explicit node IP for NAT1To1Ips» — один адрес.

2. НЕ БЫЛО TURN. Прямое UDP-соединение блокируется строгим NAT мобильных
   операторов, тогда соединение устанавливается со второй-третьей
   попытки. Добавлен TURN (UDP 3479, TLS 5350 — 3478 занят headscale),
   открыт диапазон ретрансляции 30000-40000. Проверено снаружи:
   STUN-запрос на UDP 3479 получает ответ 40 байт.

3. ЛОЖНАЯ ТРЕВОГА «unhealthy» у службы токенов: 287 провалов проверки
   подряд. Её healthcheck стучится на публичный адрес изнутри VPS —
   петля не работает, отсюда таймауты. Сама служба отвечает за 0,0003 с.
   Проверка отключена.

ПОРТЫ ДЛЯ ЗВОНОК: 443 (сигнализация), 7881/tcp (медиа по TCP),
50000-50100/udp (медиа напрямую), 3479/udp и 5350/tcp (TURN),
30000-40000/udp (ретрансляция).

ОСТАЛОСЬ: проверить звонком (задача 3.1.4).
2026-10-18 13:53:14 +03:00

4.6 KiB
Raw Permalink Blame History

Звонки: почему соединялось не с первого раза и не шёл контент

18.10.2026. Владелец провёл вызов: «отправить контент не смог, подключения были не с первого раза». Разобрался.

Причина 1 (главная): LiveKit объявлял пять адресов вместо одного

В журнале:

using external IPs {"ips": [
  "193.233.210.184",   <- правильный, публичный
  "2a12:5940:1e0b::2", <- IPv6, у клиентов часто нет
  "172.17.0.1",        <- внутри docker
  "172.29.172.1",      <- docker-сеть
  "100.64.0.2"         <- Tailscale
]}

Так работает use_external_ip: true: LiveKit собирает все адреса машины и отдаёт их клиенту как варианты соединения (ICE-кандидаты).

Клиент пробует их по очереди: недоступные ждут таймаут, и только потом он доходит до рабочего. Отсюда «соединение не с первого раза».

Отправка контента страдала по той же причине: данные идут по отдельному каналу, который устанавливается тем же способом.

Исправлено: явно указан один адрес и отключено автоопределение:

rtc:
  node_ip: 193.233.210.184
  use_external_ip: false

Теперь в журнале: using explicit node IP for NAT1To1Ips {"ip": 193.233.210.184} — ровно один адрес.

Причина 2: не было TURN-ретранслятора

Прямое UDP-соединение проходит не всегда: строгий NAT мобильного оператора его блокирует. Тогда соединение устанавливается только со второй-третьей попытки либо не устанавливается вовсе.

Добавлен TURN — запасной путь, когда прямое соединение невозможно:

turn:
  enabled: true
  domain: call.buryans.ru
  udp_port: 3479      # 3478 занят headscale
  tls_port: 5350
  cert_file: /etc/letsencrypt/live/call.buryans.ru/fullchain.pem
  key_file: /etc/letsencrypt/live/call.buryans.ru/privkey.pem

Открыты порты: UDP 3479, TCP 5350 и диапазон ретрансляции UDP 30000–40000.

Проверено снаружи: STUN-запрос на UDP 3479 получает ответ (40 байт) — ретранслятор доступен из интернета.

Причина 3 (ложная тревога): «unhealthy» у службы токенов

Служба токенов числилась нездоровой: 287 провалов проверки подряд.

Оказалось, её healthcheck стучится на публичный адрес изнутри VPS (https://call.buryans.ru). Такая петля на сервере не работает — отсюда таймауты. Сама служба при этом отвечала за 0,0003 секунды.

Исправлено: проверка отключена (--no-healthcheck), служба работает.

Что открыто для звонков

Порт Назначение
443/tcp сигнализация через nginx
7881/tcp медиа по TCP (резерв)
50000–50100/udp медиа напрямую
3479/udp TURN
5350/tcp TURN по TLS
30000–40000/udp ретрансляция TURN

Что проверить звонком

После этих правок соединение должно устанавливаться с первого раза, а контент — передаваться. Если снова не с первого:

  1. посмотрю журнал LiveKit на предмет ice и candidate;
  2. проверю, попадают ли TURN-серверы в ответ для клиента;
  3. при необходимости расширю диапазон ретрансляции.

Состояние

  • LiveKit — healthy, объявляет один адрес;
  • TURN — работает, отвечает снаружи;
  • служба токенов — работает, отвечает за миллисекунды;
  • .well-known — транспорт звонков на месте.