服务端部署环境与端口要求
部署前先确认端口、数据目录与网络要求，后续排错能少走弯路。
最后更新：2026-10-06
两种部署方式怎么选
服务端支持「电脑直接运行」与「Docker 部署」两种方式，按使用场景选择即可：
- 电脑直接运行：无需额外软件，解压即用，适合个人试用与临时演示，但需要保持窗口开启
- Docker 部署：适合长期使用与团队办公，数据集中在 ./data，备份迁移只需拷贝一个目录，支持开机自启与异常自动重启
端口与访问方式
容器内固定监听 9009 端口（HTTP，不可修改）。需要换端口时只改宿主机侧的映射，例如把 9009:9009 改成 8080:9009，或设置 SERVER_PORT=8080，容器内的 9009 保持不变。
- 部署完成后用浏览器打开 http://宿主机IP:9009 即可访问
- 客户端注册时的服务器地址必须完整填写，包含 :9009 端口，这是最容易填错的一项
- 改了对外端口，客户端地址里的端口要同步修改
数据目录与配置覆盖
Docker 部署下各挂载目录的用途如下，其中数据目录是唯一必须备份的目录：
- 数据目录 ./data → /app/data：唯一必须备份的目录
- 日志目录 ./data/logs → /app/logs：排查问题时查看
- 配置覆盖 ./etc → /app/etc/override：只读，用于高级自定义配置
- 机器标识 /etc/machine-id：只读，用于设备绑定
- 时区 TZ=Asia/Shanghai：影响日志时间
TURN 中继需要放行的端口
同一局域网内一般无需中继。若客户端不在同一网络，或处于公司、校园、酒店这类只放行少数端口的严格网络下，语音视频或文件传输会连不上，需要部署 TURN 中继。宿主机防火墙或安全组需放行：
- 3478 TCP 与 UDP：TURN / STUN 主端口
- 49152-51199 UDP：媒体中继端口段
- 443 TCP：回退端口，仅在启用时用于只放行 443 的严格网络
常见问题
Docker 部署需要什么前置条件？
只需要先安装好 Docker。容器内固定监听 9009 端口，全部数据集中在 /app/data，备份迁移只需拷贝一个目录。
更换对外端口会影响已有客户端吗？
只修改宿主机侧的端口映射即可，容器内的 9009 保持不变。已经填了旧端口的客户端需要把服务器地址里的端口同步改掉。
部署后必须备份哪些数据？
必须备份的是数据目录 ./data，它映射到容器内的 /app/data。日志目录 ./data/logs 只在排查问题时需要查看。