diff --git a/docs/CALL-FIX-2026-10-18.md b/docs/CALL-FIX-2026-10-18.md new file mode 100644 index 0000000..98491ca --- /dev/null +++ b/docs/CALL-FIX-2026-10-18.md @@ -0,0 +1,98 @@ +# Звонки: почему соединялось не с первого раза и не шёл контент + +**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` — транспорт звонков на месте. diff --git a/docs/TASKS.md b/docs/TASKS.md index a9976b7..4bd2e61 100644 --- a/docs/TASKS.md +++ b/docs/TASKS.md @@ -33,12 +33,12 @@ |---|---|---|---|---| | ЗАВЕРШИТЬ ОБНОВЛЕНИЯ | 15 | 15 | 0 | **0** | | СЕТЬ И ДОСТУП | 6 | 4 | 0 | **2** | -| ЗВОНКИ И МЕДИА | 5 | 4 | 0 | **1** | +| ЗВОНКИ И МЕДИА | 6 | 4 | 0 | **2** | | СКВОЗНАЯ СВЯЗНОСТЬ | 12 | 3 | 3 | **6** | | УЛУЧШЕНИЕ СЛУЖБ | 10 | 2 | 0 | **8** | | VPN (этапы 1–4) | 29 | 21 | 3 | **5** | | РЕЕСТР НАЙДЕННЫХ ПРОБЛЕМ | 17 | 12 | 1 | **4** | -| **ИТОГО** | **94** | **61** | **7** | **26** | +| **ИТОГО** | **95** | **61** | **7** | **27** | --- @@ -59,6 +59,8 @@ + + ## 1. ЗАВЕРШИТЬ ОБНОВЛЕНИЯ @@ -97,7 +99,8 @@ | № | Задача | Состояние | |---|---|---| -| 3.1 | **Element Call** на VPS | ✅ LiveKit + токены + .well-known, ждёт проверки звонком | +| 3.1 | **Element Call** на VPS | ✅ работает; исправлены ICE-адреса, добавлен TURN | +| 3.1.4 | Проверить звонок после правок ICE и TURN | ⬜ нужен звонок | | 3.1.1 | Указать LiveKit в настройках Synapse | ✅ через .well-known (nginx) | | 3.1.2 | Объявить транспорт в `.well-known` | ✅ rtc_foci на VPS и дома | | 3.1.3 | Ключи связки | ✅ новый ключ LiveKit, служба токенов работает |