lnobach/spreed-signaling

Nextcloud Talk高性能信令后端镜像说明

镜像概述

该镜像提供Docker化的Nextcloud Talk高性能信令后端，适用于私人或小型办公场景。当您的Nextcloud服务器位于网络较弱的环境（如家庭或办公室分支）时，默认后端可能因流量过大导致音视频卡顿。通过将视频会议会话外包到具有强网络连接的专用云服务器，您可在保持对服务器完全控制的同时，提升通话体验。

核心功能

该镜像通过docker-compose自动部署以下微服务：

• spreedbackend: Nextcloud Talk的信令后端（基于strukturag开源实现）。
• janus: WebRTC网关，处理实时音视频通信。
• nginx: 反向代理，对外暴露HTTP(S)服务。
• nats: NATS流服务器，为信令后端提供消息支持。
• coturn: TURN中继服务，解决NAT穿越问题。

使用场景

• 私人Nextcloud服务器用户，其网络环境无法支撑大量视频会议流量。
• 小型办公室需要稳定的视频会议服务，但本地服务器带宽有限。

当前不足

• WebRTC DTLS加密的证书检查处于禁用状态，可防止简单窃听，但无法抵御MITM***。
• 部分Docker进程以root身份运行，需进一步优化安全性。

配置说明

UI方式设置

1. 将vars.bash.example复制为vars.bash，并根据注释调整变量（如域名、密钥等）。
2. 运行./make.sh生成cloud-config.yaml。
3. 创建弹性IP（v4和v6），并将DNS A/AAAA记录指向该IP。
4. 使用CentOS 8镜像创建新VM，将cloud-config.yaml作为用户数据传入（强制启用SSH公钥认证）。
5. 分配弹性IP给VM，等待几分钟完成部署。
6. 在Nextcloud设置的“Talk”标签中，输入信令服务器URL https://<域名>/standalone-signaling并填写密钥。

Terraform方式设置

支持Hetzner Cloud等云提供商，详情请参考terraform/<provider>/README.md（如terraform/hetzner目录）。

Nextcloud配置步骤

1. 进入Nextcloud设置的“Talk”部分。
2. 添加新STUN服务器：<域名>:5349（可删除其他默认服务器）。
3. 添加新TURN服务器：<域名>:5349，并填写变量turn_sharedsecret中设置的共享密钥。
4. 配置信令服务器：
   • URL：https://<域名>/standalone-signaling
   • 启用SSL证书检查
   • 填写变量nc_sharedsecret中设置的共享密钥。

故障排除与提示

• 部署过程中，可通过tail -f /var/log/messages | grep cloud-init查看cloud-init输出。
• 若服务异常，可通过ssh -t root@<IP> "cd /opt/app; docker-compose logs --tail=100 -f"查看容器日志。
• 建议使用弹性IP以保持实例重建后的公网地址，若无需则删除cloud-config中/opt/app/tools/set_elastic_address的执行命令。