From 7d557de8e4b3c25f10163ea80ab4a5873bc8f34e Mon Sep 17 00:00:00 2001 From: Roman Buryan Date: Sun, 18 Oct 2026 11:15:05 +0300 Subject: [PATCH] =?UTF-8?q?Element=20Call=20=D0=BF=D0=BE=D0=B4=D0=BD=D1=8F?= =?UTF-8?q?=D1=82=20=D0=BD=D0=B0=20VPS:=20LiveKit=20+=20=D1=82=D0=BE=D0=BA?= =?UTF-8?q?=D0=B5=D0=BD=D1=8B=20+=20=D0=BE=D0=B1=D1=8A=D1=8F=D0=B2=D0=BB?= =?UTF-8?q?=D0=B5=D0=BD=D0=B8=D0=B5=20=D0=B2=20Matrix?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Владелец создал 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 — служба токенов перезапускалась. --- docs/ELEMENT-CALL-DONE.md | 86 +++++++++++++++++++++++++++ docs/TASKS.md | 13 ++-- ops/call/fix-nginx-path.sh | 48 +++++++++++++++ ops/call/install-livekit.sh | 56 ++++++++++++++++++ ops/call/nginx-cert.sh | 115 ++++++++++++++++++++++++++++++++++++ ops/call/wellknown.py | 55 +++++++++++++++++ 6 files changed, 367 insertions(+), 6 deletions(-) create mode 100644 docs/ELEMENT-CALL-DONE.md create mode 100755 ops/call/fix-nginx-path.sh create mode 100755 ops/call/install-livekit.sh create mode 100755 ops/call/nginx-cert.sh create mode 100644 ops/call/wellknown.py diff --git a/docs/ELEMENT-CALL-DONE.md b/docs/ELEMENT-CALL-DONE.md new file mode 100644 index 0000000..26d916e --- /dev/null +++ b/docs/ELEMENT-CALL-DONE.md @@ -0,0 +1,86 @@ +# 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. diff --git a/docs/TASKS.md b/docs/TASKS.md index d53d099..7c33399 100644 --- a/docs/TASKS.md +++ b/docs/TASKS.md @@ -33,12 +33,12 @@ |---|---|---|---|---| | ЗАВЕРШИТЬ ОБНОВЛЕНИЯ | 15 | 13 | 0 | **2** | | СЕТЬ И ДОСТУП | 6 | 4 | 0 | **2** | -| ЗВОНКИ И МЕДИА | 5 | 0 | 0 | **5** | +| ЗВОНКИ И МЕДИА | 5 | 4 | 0 | **1** | | СКВОЗНАЯ СВЯЗНОСТЬ | 12 | 3 | 3 | **6** | | УЛУЧШЕНИЕ СЛУЖБ | 10 | 1 | 0 | **9** | | VPN (этапы 1–4) | 29 | 20 | 3 | **6** | | РЕЕСТР НАЙДЕННЫХ ПРОБЛЕМ | 17 | 12 | 1 | **4** | -| **ИТОГО** | **94** | **53** | **7** | **34** | +| **ИТОГО** | **94** | **57** | **7** | **30** | --- @@ -56,6 +56,7 @@ + ## 1. ЗАВЕРШИТЬ ОБНОВЛЕНИЯ | № | Задача | Состояние | @@ -93,10 +94,10 @@ | № | Задача | Состояние | |---|---|---| -| 3.1 | **Element Call** на VPS: оценка готова, нужна A-запись `call.buryans.ru` | ⬜ ждёт DNS | -| 3.1.1 | Указать LiveKit в настройках Synapse | ⬜ | -| 3.1.2 | Объявить транспорт в `.well-known` | ⬜ | -| 3.1.3 | Задать ключи связки Synapse и LiveKit | ⬜ | +| 3.1 | **Element Call** на VPS | ✅ LiveKit + токены + .well-known, ждёт проверки звонком | +| 3.1.1 | Указать LiveKit в настройках Synapse | ✅ через .well-known (nginx) | +| 3.1.2 | Объявить транспорт в `.well-known` | ✅ rtc_foci на VPS и дома | +| 3.1.3 | Ключи связки | ✅ новый ключ LiveKit, служба токенов работает | | 3.2 | Свести медиаслужбы к единому входу и правам | ⬜ | ## 4. СКВОЗНАЯ СВЯЗНОСТЬ diff --git a/ops/call/fix-nginx-path.sh b/ops/call/fix-nginx-path.sh new file mode 100755 index 0000000..6325878 --- /dev/null +++ b/ops/call/fix-nginx-path.sh @@ -0,0 +1,48 @@ +#!/bin/bash +# Исправить путь /sfu в nginx и проверить +set -uo pipefail +CONF=/etc/nginx/conf.d/call.buryans.ru.conf + +echo "=== 1. ЧТО СЕЙЧАС ===" +grep -n -A2 "location /sfu/" $CONF | sed 's/^/ /' + +echo +echo "=== 2. ПРАВЛЮ: НЕ СРЕЗАТЬ ПУТЬ ===" +# proxy_pass с завершающим слэшем заменяет /sfu/get на /get -> 404. +# Без слэша путь передаётся как есть. +sed -i 's|proxy_pass http://127.0.0.1:8080/;|proxy_pass http://127.0.0.1:8080;|' $CONF +grep -n -A1 "location /sfu/" $CONF | sed 's/^/ /' + +echo +echo "=== 3. ПРОВЕРКА И ПЕРЕЗАГРУЗКА ===" +if nginx -t 2>&1 | grep -q "successful"; then + nginx -t 2>&1 | tail -1 | sed 's/^/ /' + systemctl reload nginx && echo " nginx перезагружен" +else + echo " ОШИБКА:"; nginx -t 2>&1 | tail -3 | sed 's/^/ /'; exit 1 +fi +sleep 3 + +echo +echo "=== 4. ПРОВЕРКА ЧЕРЕЗ ДОМЕН ===" +for path in "/" "/sfu/get"; do + code=$(curl -s -o /dev/null -w '%{http_code}' --max-time 15 -X POST "https://call.buryans.ru$path" 2>/dev/null) + printf ' POST %-12s -> HTTP %s\n' "$path" "${code:-—}" +done +echo " --- что отвечает /sfu/get ---" +curl -s --max-time 10 -X POST https://call.buryans.ru/sfu/get -H "Content-Type: application/json" -d '{}' 2>/dev/null | head -c 200 | sed 's/^/ /' +echo + +echo +echo "=== 5. ПОЛНЫЙ ЧЕК ===" +echo " LiveKit снаружи: $(curl -s -o /dev/null -w '%{http_code}' --max-time 12 https://call.buryans.ru/ 2>/dev/null)" +echo " токены снаружи: $(curl -s -o /dev/null -w '%{http_code}' --max-time 12 -X POST https://call.buryans.ru/sfu/get 2>/dev/null)" +echo " (200 для LiveKit и 400/401 для токенов = всё работает)" + +echo +echo "=== 6. КОНТЕЙНЕРЫ ===" +docker ps --format ' {{.Names}} | {{.Status}}' | grep -E "livekit|lk-jwt" + +echo +echo "=== 7. КЛЮЧ LIVEKIT (для домена) ===" +grep -A2 "^keys:" /opt/element-call/livekit.yaml | tail -1 | cut -d: -f1 | sed 's/^ *//' | sed 's/^/ ключ: /' diff --git a/ops/call/install-livekit.sh b/ops/call/install-livekit.sh new file mode 100755 index 0000000..af481d3 --- /dev/null +++ b/ops/call/install-livekit.sh @@ -0,0 +1,56 @@ +#!/bin/bash +# ============================================================ +# call-step5-run.sh — запуск через docker run (без compose-плагина) +# ============================================================ +# НА VPS НЕТ плагина `docker compose` (есть только docker CLI). +# Ставить пакеты ради двух контейнеров не буду — запускаю напрямую. +# ============================================================ +set -uo pipefail +D=/opt/element-call + +KEY=$(grep -A2 "^keys:" $D/livekit.yaml | tail -2 | head -1 | tr -d ' :') +SECRET=$(grep -A2 "^keys:" $D/livekit.yaml | tail -1 | tr -d ' ') +echo "=== КЛЮЧ ===" +echo " ключ: ${KEY:0:8}... (полный в /opt/element-call/livekit.yaml)" + +echo +echo "=== 1. LIVeKIT ===" +docker rm -f livekit >/dev/null 2>&1 +docker run -d --name livekit --restart unless-stopped \ + --network host \ + -v $D/livekit.yaml:/etc/livekit.yaml:ro \ + livekit/livekit-server:latest --config /etc/livekit.yaml 2>&1 | tail -2 | sed 's/^/ /' +sleep 8 + +echo +echo "=== 2. СЛУЖБА ТОКЕНОВ ===" +docker rm -f lk-jwt >/dev/null 2>&1 +docker run -d --name lk-jwt --restart unless-stopped \ + --network host \ + -e LIVEKIT_URL=wss://call.buryans.ru \ + -e LIVEKIT_KEY="$KEY" \ + -e LIVEKIT_SECRET="$SECRET" \ + -e LIVEKIT_JWT_PORT=8080 \ + ghcr.io/element-hq/lk-jwt-service:latest 2>&1 | tail -2 | sed 's/^/ /' +sleep 8 + +echo +echo "=== 3. СОСТОЯНИЕ ===" +docker ps --format ' {{.Names}} | {{.Status}} | {{.Image}}' | grep -E "livekit|lk-jwt" + +echo +echo "=== 4. ПРОВЕРКА ИЗНУТРИ ===" +curl -s -o /dev/null -w " LiveKit :7880 -> HTTP %{http_code}\n" --max-time 8 http://127.0.0.1:7880/ 2>/dev/null +curl -s -o /dev/null -w " токены :8080/sfu/get -> HTTP %{http_code}\n" --max-time 8 -X POST http://127.0.0.1:8080/sfu/get 2>/dev/null + +echo +echo "=== 5. ЧЕРЕЗ ДОМЕН ===" +curl -s -o /dev/null -w " https://call.buryans.ru/ -> HTTP %{http_code}\n" --max-time 15 https://call.buryans.ru/ 2>/dev/null +curl -s -o /dev/null -w " https://call.buryans.ru/sfu/get -> HTTP %{http_code}\n" --max-time 15 -X POST https://call.buryans.ru/sfu/get 2>/dev/null + +echo +echo "=== 6. ЖУРНАЛЫ (если что-то не так) ===" +echo " --- livekit ---" +docker logs livekit --tail 6 2>&1 | sed 's/^/ /' +echo " --- lk-jwt ---" +docker logs lk-jwt --tail 6 2>&1 | sed 's/^/ /' diff --git a/ops/call/nginx-cert.sh b/ops/call/nginx-cert.sh new file mode 100755 index 0000000..f2d2723 --- /dev/null +++ b/ops/call/nginx-cert.sh @@ -0,0 +1,115 @@ +#!/bin/bash +# ============================================================ +# call-step3-nginx.sh — продакшен-сертификат + конфиг nginx +# ============================================================ +# ЧТО НЕ ТАК: curl без -k падает с «no alternative certificate subject +# name matches target hostname». Значит nginx пока отдаёт НЕ тот +# сертификат: certbot создал блок, но имя не совпадает. +# Кроме того, аккаунт по умолчанию — staging (недоверенный). +# +# ЧТО ДЕЛАЮ: +# 1. перевыпускаю сертификат на ПРОДАКШЕНЕ Let's Encrypt; +# 2. пишу свой конфиг для call.buryans.ru: +# /sfu/ -> lk-jwt-service (выдача токенов) +# / -> LiveKit (websocket сигнализации) +# 3. проверяю доверие сертификата и проксирование. +# ============================================================ +set -uo pipefail +DOMAIN=call.buryans.ru +CONF=/etc/nginx/conf.d/$DOMAIN.conf + +echo "=== 1. ПЕРЕВЫПУСК НА ПРОДАКШЕНЕ ===" +certbot certonly --nginx -d $DOMAIN \ + --server https://acme-v02.api.letsencrypt.org/directory \ + --non-interactive --agree-tos --force-renewal 2>&1 | tail -6 + +echo +echo "=== 2. ИЗДАТЕЛЬ СЕРТИФИКАТА ===" +openssl x509 -in /etc/letsencrypt/live/$DOMAIN/fullchain.pem -noout -issuer -subject -dates 2>/dev/null | sed 's/^/ /' + +echo +echo "=== 3. КОНФИГ NGINX ===" +cp -p /etc/nginx/conf.d/buryans-all.conf /etc/nginx/conf.d/buryans-all.conf.before-$DOMAIN 2>/dev/null +cat > $CONF <<'NGINX' +# call.buryans.ru — звонки Element Call +# /sfu/ — служба выдачи токенов (lk-jwt-service) +# / — LiveKit: websocket сигнализации +# Медиа-трафик (UDP) идёт напрямую на LiveKit, минуя nginx. + +map $http_upgrade $call_conn_upgrade { + default upgrade; + '' close; +} + +server { + listen 80; + listen [::]:80; + server_name call.buryans.ru; + # ACME-проверка для продления + location /.well-known/acme-challenge/ { + root /var/www/certbot; + } + location / { + return 301 https://$host$request_uri; + } +} + +server { + listen 443 ssl; + listen [::]:443 ssl; + http2 on; + server_name call.buryans.ru; + + ssl_certificate /etc/letsencrypt/live/call.buryans.ru/fullchain.pem; + ssl_certificate_key /etc/letsencrypt/live/call.buryans.ru/privkey.pem; + ssl_protocols TLSv1.2 TLSv1.3; + ssl_session_cache shared:SSL:10m; + + client_max_body_size 64M; + + # Выдача токенов для Matrix-пользователей + location /sfu/ { + proxy_pass http://127.0.0.1:8080/; + proxy_http_version 1.1; + proxy_set_header Host $host; + proxy_set_header X-Real-IP $remote_addr; + proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; + proxy_set_header X-Forwarded-Proto $scheme; + } + + # Сигнализация LiveKit (websocket) + location / { + proxy_pass http://127.0.0.1:7880; + proxy_http_version 1.1; + proxy_set_header Upgrade $http_upgrade; + proxy_set_header Connection $call_conn_upgrade; + proxy_set_header Host $host; + proxy_set_header X-Real-IP $remote_addr; + proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; + proxy_set_header X-Forwarded-Proto $scheme; + proxy_read_timeout 3600s; + proxy_send_timeout 3600s; + proxy_buffering off; + } +} +NGINX +echo " создан: $CONF" + +echo +echo "=== 4. ПРОВЕРКА КОНФИГУРАЦИИ ===" +if nginx -t 2>&1 | grep -q "successful"; then + nginx -t 2>&1 | tail -1 | sed 's/^/ /' + systemctl reload nginx && echo " nginx перезагружен" +else + echo " ОШИБКА:" + nginx -t 2>&1 | tail -3 | sed 's/^/ /' + rm -f $CONF + nginx -t 2>&1 | tail -1 | sed 's/^/ после откката: /' + exit 1 +fi + +echo +echo "=== 5. ДОВЕРИЕ СЕРТИФИКАТА (снаружи) ===" +code=$(curl -s -o /dev/null -w '%{http_code}' --max-time 15 "https://$DOMAIN/" 2>/dev/null) +echo " curl без -k: HTTP ${code:-—}" +curl -sS --max-time 15 "https://$DOMAIN/" 2>&1 | head -3 | sed 's/^/ /' diff --git a/ops/call/wellknown.py b/ops/call/wellknown.py new file mode 100644 index 0000000..39ee69d --- /dev/null +++ b/ops/call/wellknown.py @@ -0,0 +1,55 @@ +#!/usr/bin/env python3 +# -*- coding: utf-8 -*- +""" +Добавляет транспорт звонков в .well-known/matrix/client. + +ЗАЧЕМ: Element ищет транспорт звонков в .well-known по ключу +org.matrix.msc4143.rtc_foci. Сейчас там только m.homeserver (это отдаёт +сам Synapse). Переопределяем ответ в nginx — так JSON содержит и домашний +сервер, и наш LiveKit. + +ВАЖНО: ответ должен содержать m.homeserver, иначе Element перестанет +находить домашний сервер. Поэтому отдаём оба поля. +""" +import io +import re +import sys + +CONF = sys.argv[1] if len(sys.argv) > 1 else "/etc/nginx/conf.d/buryans-all.conf" + +JSON = ('{"m.homeserver":{"base_url":"https://matrix.buryans.ru/"},' + '"org.matrix.msc4143.rtc_foci":[{"type":"livekit",' + '"livekit_service_url":"https://call.buryans.ru/sfu"}]}') + +BLOCK = """ # Транспорт звонков Element Call (переопределяет ответ Synapse) + location = /.well-known/matrix/client { + default_type application/json; + add_header Access-Control-Allow-Origin *; + add_header Cache-Control "public, max-age=300"; + return 200 '%s'; + } + +""" % JSON + +t = io.open(CONF, encoding="utf-8").read() + +if "rtc_foci" in t: + print("уже добавлено") + sys.exit(0) + +# ищу блок server_name matrix.buryans.ru +m = re.search(r"server_name\s+matrix\.buryans\.ru\s*;", t) +if not m: + print("не нашёл блок matrix.buryans.ru") + sys.exit(1) + +# первая "location / {" после него +loc = t.find("location / {", m.end()) +if loc == -1: + print("не нашёл location / в блоке matrix") + sys.exit(1) + +line_start = t.rfind("\n", 0, loc) + 1 +t = t[:line_start] + BLOCK + t[line_start:] +io.open(CONF, "w", encoding="utf-8").write(t) +print("добавлено в %s" % CONF)