Files
buryan-infra/docs/ELEMENT-CALL-DONE.md
root 7d557de8e4 Element Call поднят на VPS: LiveKit + токены + объявление в Matrix
Владелец создал A-запись call.buryans.ru на Beget. Остальное сделано.

РАЗВЁРНУТО НА VPS:
  * LiveKit (медиасервер) — порт 7880;
  * lk-jwt-service — выдаёт токены пользователям Matrix (без него
    Element Call не работает: LiveKit не понимает Matrix-токены);
  * nginx: wss://call.buryans.ru -> LiveKit, /sfu/ -> служба токенов;
  * сертификат Let's Encrypt (доверенный), до 16.01.2027;
  * firewall: UDP 50000-50100 и TCP 7881 для медиа, с сохранением.

БЕЗОПАСНОСТЬ: сгенерирован НОВЫЙ случайный ключ LiveKit. В доме до сих
пор стоял демонстрационный devkey/secret123 — с ним любой мог
подключиться к серверу.

ОБЪЯВЛЕНО В MATRIX: в .well-known/matrix/client добавлен
org.matrix.msc4143.rtc_foci с адресом службы токенов. Ответ отдаёт nginx
на VPS и на домашнем хосте, чтобы в одном JSON были и домашний сервер, и
транспорт звонков. В Element Web включены флаги видеокомнат.

ПРОВЕРЕНО: https://call.buryans.ru/ -> 200 (LiveKit отвечает),
POST /sfu/get -> 400 «Missing room parameter» (служба жива и требует
параметры), .well-known содержит транспорт снаружи и дома.

ОСТАЛОСЬ: реальный звонок — нужны два устройства с входом в Matrix.

МОИ ОШИБКИ В ЗАДАЧЕ (записаны в документ):
  * сертификат сначала выпустился от staging (недоверенный) —
    перевыпустил на продакшене;
  * на VPS нет плагина docker compose — потратил шаг на выяснение,
    запустил через docker run;
  * разбор ключа из YAML через tr склеил ключ и секрет — перечитал
    через Python;
  * proxy_pass с завершающим слэшем срезал /sfu -> 404 — убрал слэш;
  * забыл LIVEKIT_FULL_ACCESS_HOMESERVERS — служба токенов
    перезапускалась.
2026-10-18 11:15:05 +03:00

87 lines
4.1 KiB
Markdown
Raw Permalink 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.
# Element Call: звонки подняты на VPS
**18.10.2026.** Владелец создал запись `call.buryans.ru` на Beget.
Остальное сделано целиком.
## Что развёрнуто
| Компонент | Где | Что делает |
|---|---|---|
| **LiveKit** | VPS, порт 7880 | медиасервер: передаёт звук и видео |
| **lk-jwt-service** | VPS, порт 8080 | выдаёт токены пользователям Matrix |
| **nginx** | VPS, 443 | `wss://call.buryans.ru` → LiveKit, `/sfu/` → служба токенов |
| **Правила firewall** | VPS | UDP 50000–50100 и TCP 7881 для медиа |
## Почему на VPS
* публичный адрес — не нужны пробросы на роутере;
* медиа не идёт через домашний канал (он слабое место: дом → VPS около
секунды);
* если домашний канал упадёт, звонки продолжат работать.
## Ключи и безопасность
Сгенерирован **новый ключ** LiveKit: `58f6e5d87fd28c0220e13bc002a44817`
(секрет — только в `/opt/element-call/livekit.yaml`, права 600).
Это важно: в доме до сих пор стоял демонстрационный
`devkey`/`secret123` — с ним любой мог подключиться к серверу. Новый ключ
случайный и нигде не опубликован.
## Как объявлено в Matrix
В `.well-known/matrix/client` добавлен транспорт:
```json
"org.matrix.msc4143.rtc_foci": [
{"type": "livekit", "livekit_service_url": "https://call.buryans.ru/sfu"}
]
```
Ответ отдаёт nginx (на VPS и на домашнем хосте), а не Synapse — так в
одном JSON и домашний сервер, и транспорт звонков.
В Element Web включены флаги видеокомнат.
## Проверено
| Проверка | Результат |
|---|---|
| `https://call.buryans.ru/` | **200** (LiveKit отвечает) |
| `POST https://call.buryans.ru/sfu/get` | **400** «Missing room parameter» — служба жива и требует параметры |
| `.well-known` снаружи | содержит транспорт ✅ |
| `.well-known` дома | содержит транспорт ✅ |
| Сертификат | Let's Encrypt, до 16.01.2027, доверенный |
| Контейнеры | livekit — работает, lk-jwt — работает |
## Что осталось проверить вам
Позвонить из Element. Проверить, что слышно и видно. Технически всё
готово, но реальный звонок я сделать не могу — нужны два устройства с
входом в Matrix.
## Мои ошибки в этой задаче
1. **Сертификат сначала выпустился от staging** — недоверенный, браузер
бы ругался. Перевыпустил на продакшене.
2. **`docker compose` на VPS не установлен** — потратил шаг, чтобы это
выяснить; запустил контейнеры через `docker run`.
3. **Разбор ключа из YAML через `tr`** склеил ключ и секрет. Перечитал
через Python.
4. **`proxy_pass` с завершающим слэшем** срезал `/sfu` → 404. Убрал слэш.
5. **Забыл `LIVEKIT_FULL_ACCESS_HOMESERVERS`** — служба токенов
перезапускалась. Добавил.
## Если понадобится откат
```bash
# на VPS
docker rm -f livekit lk-jwt
rm /etc/nginx/conf.d/call.buryans.ru.conf
nginx -t && systemctl reload nginx
# в .well-known убрать rtc_foci (копии конфигов: *.before-wellknown)
```
Домашний LiveKit после подтверждения работы можно выключить — освободит
память в CT 155.