Files
buryan-infra/docs/CALL-FIX-2026-10-18.md
T
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

99 lines
4.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Звонки: почему соединялось не с первого раза и не шёл контент
**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-кандидаты).
Клиент пробует их по очереди: недоступные ждут таймаут, и только потом
он доходит до рабочего. Отсюда «соединение не с первого раза».
**Отправка контента** страдала по той же причине: данные идут по
отдельному каналу, который устанавливается тем же способом.
**Исправлено:** явно указан один адрес и отключено автоопределение:
```yaml
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** — запасной путь, когда прямое соединение невозможно:
```yaml
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` — транспорт звонков на месте.