spreed/turnserver

适用于WebRTC的Coturn Docker镜像

本Docker仓库提供基于https://github.com/coturn/coturn的TURN服务器镜像，其配置适合与https://github.com/strukturag/spreed-webrtc配合使用。

构建Docker镜像

安装Docker后，运行以下命令构建镜像：

bash
docker build -t docker-webrtc-turnserver .

WebRTC的TURN服务器配置

核心要求

• IP配置：建议使用两个可路由IP（仅一个会失去RFC-5780支持）；
• TLS加密：可选，需提供完整证书链，主机名需与证书匹配（Firefox暂不支持TLS的TURN，需同时配置turns:和turn:端点）；
• 端口优化：推荐监听443端口以提升防火墙穿透效果。

配置文件示例

容器需使用主机网络，创建data/config文件（最小示例）：

ini
LISTENING_PORT=443
ALT_LISTENING_PORT=3478
LISTEN_IPS="##FIRST_IP## ##SECOND_IP##"
RELAY_IP=##FIRST_IP##
STATIC_AUTH_SECRET=##SECRET##
REALM=myturnserver
VERBOSE=1

替换##placeholders##为实际值，更多配置参考data/config.example或coturn.sh脚本。

运行TURN服务器

bash
docker run --rm --net=host --name my-webrtc-turnserver -i -v `pwd`/data:/srv -t docker.xuanyuan.run/docker-webrtc-turnserver

通过卷挂载data目录，用于读取配置和存储持久化数据。

Spreed WebRTC集成

配置步骤

1. 在TURN的config中设置STATIC_AUTH_SECRET；
2. 在Spreed WebRTC的server.conf中填入：

未启用TLS时

ini
turnSecret = ##SECRET##
turnURIs = turn:##FIRST_IP##:443?transport=udp turn:##FIRST_IP##:443?transport=tcp

启用TLS时

ini
turnSecret = ##SECRET##
turnURIs = turns:##FQDN##:443?transport=udp turns:##FQDN##:443?transport=tcp turn:##FQDN##:443?transport=udp turn:##FQDN##:443?transport=tcp

3. 禁用stunURIs（TURN自动提供STUN服务）；
4. 重启Spreed WebRTC并重新加载客户端以应用凭据。