Files
XHChat/docs/deployment.md
T

1.2 KiB

部署与维护

当前 Compose 启动 Nginx、Go API、PostgreSQL 和 Redis。PostgreSQL 与 Redis 仅供 Compose 网络使用。Nginx 的端口默认绑定本机。所有服务健康后,通过 /readyz 验证数据库与缓存。

使用自定义域名时,将 XHCHAT_WEB_ORIGIN 设置为实际的 HTTPS 源,使用 TLS 反向代理转发到 127.0.0.1 上的 Compose 端口。反向代理应转发 Host、WebSocket Upgrade 与 Connection,配置证书续期和 HSTS。桌面端的 XHCHAT_SERVER_URL 指向同一 HTTPS 源。应用凭据及数据库连接信息由部署方提供。数据库密码使用十六进制字符串,避免连接 URL 的保留字符。正式环境需要数据库角色分离、备份演练、容量与限流调优。

使用 docker compose logs api 检查应用日志。停止服务用 docker compose down。PostgreSQL 的数据由 Compose 命名卷保存。

使用 pg_dump 生成数据库备份,备份包含账号与设备元数据,应在受控环境加密保存。使用 pg_restore 恢复到独立数据库,执行迁移与 API 验证后切换服务。恢复时清除历史会话并重建 Redis 短期状态。阶段一暂无聊天和附件数据。