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 — служба токенов
    перезапускалась.
This commit is contained in:
root committed 2026-10-18 11:15:05 +03:00
1 parent 6a9ac94e01
commit 7d557de8e4
6 files changed
+367 -6

No files matched your search

+86
View File
@@ -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.
+7 -6
View File
@@ -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. СКВОЗНАЯ СВЯЗНОСТЬ
+48
View File
@@ -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/^/ ключ: /'
+56
View File
@@ -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/^/ /'
+115
View File
@@ -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/^/ /'
+55
View File
@@ -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)