This commit is contained in:
parent
2e56811864
commit
7967d2e270
GPG key ID:
C293081F8842237C
1 changed files with 134 additions and 0 deletions
134
content/posts/eturnal.md
Normal file
134
content/posts/eturnal.md
Normal file
|
|
@ -0,0 +1,134 @@
|
||||||
|
---
|
||||||
|
title: "Настройка TLS (turns:) в Eturnal для Nextcloud Talk (Spreed)"
|
||||||
|
date: "2024-12-22"
|
||||||
|
author: "Линк"
|
||||||
|
tags: ["TURN", "nextcloud", "talk", "spreed"]
|
||||||
|
description: "Мануал для систем с пакетным менеджером **`apt`**"
|
||||||
|
cover: ""
|
||||||
|
---
|
||||||
|
|
||||||
|
**Мануал подразумевает, что у вас уже есть сервер с `apt-based` системой с установленным и настроенным Nextcloud*
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
Поскольку у меня сервер на `Debian 13`, соответственно мануал будет для систем с **`apt`**.
|
||||||
|
Чтобы установить пакет `eturnal`, необходимо прописать следующие команды:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
sudo apt install extrepo
|
||||||
|
sudo extrepo enable eturnal
|
||||||
|
sudo apt update
|
||||||
|
sudo apt install eturnal
|
||||||
|
```
|
||||||
|
(Взято с [Github](https://github.com/processone/eturnal)-репозитория eturnal)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
После установки необходимо редактировать файл конфигурации \
|
||||||
|
(Вместо **`micro`** подставьте ваш любимый терминальный текстовый редактор)
|
||||||
|
|
||||||
|
```bash
|
||||||
|
sudo micro /etc/eturnal.yml
|
||||||
|
```
|
||||||
|
|
||||||
|
Сам файл конфигурации:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# eturnal STUN/TURN server configuration file.
|
||||||
|
#
|
||||||
|
# This file is written in YAML. The YAML format is indentation-sensitive, please
|
||||||
|
# MAKE SURE YOU INDENT CORRECTLY.
|
||||||
|
#
|
||||||
|
# See: https://eturnal.net/doc/#Global_Configuration
|
||||||
|
|
||||||
|
eturnal:
|
||||||
|
|
||||||
|
## Shared secret for deriving temporary TURN credentials (default: $RANDOM):
|
||||||
|
secret: "ваш-секрет"
|
||||||
|
|
||||||
|
## The server's public IPv4 address (default: autodetected):
|
||||||
|
relay_ipv4_addr: "ваш_белый_(или_статичный)_IP"
|
||||||
|
## The server's public IPv6 address (optional):
|
||||||
|
#relay_ipv6_addr: "2001:db8::4"
|
||||||
|
|
||||||
|
listen:
|
||||||
|
-
|
||||||
|
ip: "::"
|
||||||
|
port: 3478
|
||||||
|
# port: 80
|
||||||
|
transport: udp
|
||||||
|
-
|
||||||
|
ip: "::"
|
||||||
|
port: 3478
|
||||||
|
# port: 80
|
||||||
|
transport: tcp
|
||||||
|
-
|
||||||
|
ip: "::"
|
||||||
|
port: 5349
|
||||||
|
# port: 443
|
||||||
|
transport: tls
|
||||||
|
|
||||||
|
## TLS certificate/key files (must be readable by 'eturnal' user!):
|
||||||
|
tls_crt_file: ваш_путь_до_fullchain.pem
|
||||||
|
tls_key_file: ваш_путь_до_privkey.pem
|
||||||
|
|
||||||
|
## UDP relay port range (usually, several ports per A/V call are required):
|
||||||
|
relay_min_port: 49152 # This is the default.
|
||||||
|
relay_max_port: 65535 # This is the default.
|
||||||
|
|
||||||
|
## Reject TURN relaying to the following addresses/networks:
|
||||||
|
blacklist_peers:
|
||||||
|
- recommended # Expands to various addresses/networks recommended
|
||||||
|
# to be blocked. This is the default.
|
||||||
|
|
||||||
|
## If 'true', close established calls on expiry of temporary TURN credentials:
|
||||||
|
strict_expiry: false # This is the default.
|
||||||
|
|
||||||
|
## Logging configuration:
|
||||||
|
log_level: info # critical | error | warning | notice | info | debug
|
||||||
|
log_rotate_size: 10485760 # 10 MiB (default: unlimited, i.e., no rotation).
|
||||||
|
log_rotate_count: 10 # Keep 10 rotated log files.
|
||||||
|
#log_dir: stdout # Enable for logging to the terminal/journal.
|
||||||
|
|
||||||
|
## See: https://eturnal.net/doc/#Module_Configuration
|
||||||
|
modules:
|
||||||
|
mod_log_stun: {} # Log STUN queries (in addition to TURN sessions).
|
||||||
|
#mod_stats_influx: {} # Log STUN/TURN events into InfluxDB.
|
||||||
|
#mod_stats_prometheus: # Expose STUN/TURN and VM metrics to Prometheus.
|
||||||
|
# ip: any # This is the default: Listen on all interfaces.
|
||||||
|
# port: 8081 # This is the default.
|
||||||
|
# tls: false # This is the default.
|
||||||
|
# vm_metrics: true # This is the default.
|
||||||
|
```
|
||||||
|
|
||||||
|
`1.` На месте `secret: "ваш-секрет"` замените значение **`ваш-секрет`** на вывод с команды
|
||||||
|
```bash
|
||||||
|
openssl rand -hex 32
|
||||||
|
```
|
||||||
|
и сохраните это значение, ибо потом нам оно понадобится.
|
||||||
|
|
||||||
|
`2.` На месте `relay_ipv4_addr: "ваш_белый_(или_статичный)_IP"` вставите свой IP \
|
||||||
|
`3.` На месте `tls_crt_file: ваш_путь_до_fullchain.pem` и `tls_key_file: ваш_путь_до_privkey.pem` вставьте пути для соответствующих сертификатов
|
||||||
|
|
||||||
|
Также необходимо ввести следующую команду
|
||||||
|
```bash
|
||||||
|
sudo setfacl -R -m u:eturnal:rX /etc/letsencrypt/{live,archive}
|
||||||
|
```
|
||||||
|
для того, чтобы пользователю `eturnal` были доступны сертификаты.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
После проведённых модификаций конфигурационного файла, необходимо перезапустить сервис `eturnal`:
|
||||||
|
```bash
|
||||||
|
sudo systemctl restart eturnal
|
||||||
|
```
|
||||||
|
|
||||||
|
После чего в браузере идём в `настройки сервера Nextcloud` (/settings/admin/talk) -> `Конференции` -> пункт `TURN-серверы` \
|
||||||
|
Нажимаем `+ Добавить сервер TURN`
|
||||||
|
- В первом выпадающем списке ставим `Только turns:`
|
||||||
|
- В `URL сервера TURN` ваш домен, к которому был привязан белый (статичный) IP
|
||||||
|
- В `Секретный ключ TURN-сервера` вставляем секрет, который я просил сохранить ранее в пункте 1 выше
|
||||||
|
|
||||||
|
После вводим пароль (если попросят), затем нажимаем на значок линии сердцебиения (слева от значка корзинки), и, если всё настроено правильно, получаем зелёную галочку и радуемся жизни.
|
||||||
|
|
||||||
|
Возможно, вам нужно будет открыть порты 3478 и 5349, но это уже сами разберётесь как сделать.
|
||||||
Loading…
Reference in a new issue