部署建议与升级

本页说明 TX-5DR 在不同部署形态下的维护边界、升级方式和备份对象。内容对应桌面版、Linux 服务器版和 Docker 三种分发形态。

常见部署阶段

阶段 1：本地桌面主机

桌面版适合在电台旁边完成初始配置。该阶段通常用于验证电台连接、音频链路、浏览器界面和基本自动化配置。

阶段 2：独立 Linux 主机

Linux 服务器版适合把电台控制主机与浏览器终端分离。该阶段通常会引入长期运行、反向代理、域名和多人访问。

阶段 3：容器化或扩展部署

Docker 形态适合将配置目录、日志目录和设备映射纳入现有容器管理流程。需要更多自动化或扩展时，可再接入插件开发流程。

三种形态的维护边界

形态	维护重点
桌面版	本地应用更新、桌面主机设备状态
Linux 服务器	服务状态、反向代理、域名、令牌和日志
Docker	镜像版本、卷目录、设备映射和端口配置

升级方式

桌面版

桌面版通常通过重新安装新版本安装包完成升级。升级前建议记录当前配置，并避开正在使用电台的时间段。

Linux 服务器

Linux 服务器版当前通过 tx5dr update 更新 nightly。执行前建议确认 tx5dr status 和日志输出正常，以便在异常时定位问题。

Docker

Docker 形态通常通过更新镜像标签并重新执行 docker compose up -d 完成。升级时应确认 ./data 卷目录保持不变。

备份对象

Linux 服务器

建议重点备份以下目录或文件：

• 配置文件
• 管理员令牌
• 插件目录
• SSL 证书（/etc/tx5dr/ssl/，尤其是自定义证书）
• 需要长期保留的日志和缓存

Docker

建议重点备份映射到宿主机的 ./data 目录。该目录通常包含配置、日志、缓存、SSL 证书和实时音频运行时文件。

公网访问相关项

需要公网访问或语音链路时，应额外检查以下项目：

• HTTPS 是否已配置（Linux 服务器版和 Docker 均默认生成自签名证书，端口 8443）
• 公网部署时建议替换为正式 SSL 证书（Let's Encrypt 或其他 CA）
• 域名与反向代理路径是否一致
• nginx 或上层反向代理是否正确转发
• LiveKit 对外端口或同源路径是否符合当前部署方式

自签名证书与公网

自签名证书适合局域网使用。如果需要公网访问，建议替换为受信任的 CA 证书，否则用户每次访问都需要手动接受安全警告。替换方式参见 Linux 服务器 HTTPS 管理 或 Docker HTTPS 配置。

后续页面

需要了解插件接口和自动化扩展时，可继续阅读 插件 API。