Звонки: исправлены 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).
This commit is contained in:
root committed 2026-10-18 13:53:14 +03:00
1 parent 8873c081a2
commit 077c5325ac
2 files changed
+104 -3

No files matched your search

+98
View File
@@ -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` — транспорт звонков на месте.
+6 -3
View File
@@ -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, служба токенов работает |