XuqmGroup-PrivateDeploy/docs/deployment-defaults.md
徐勤民 a327a262dd feat(deploy): 移除 ops-web、修复 SDK URL 注入、新增一键升级
核心变更:
- 完全移除 ops-web 容器(私有化部署无需运营后台)
- nginx sub_filter 替换前端 JS bundle 中的公网 SDK URL
- deploy.sh 写入正确的 SDK_IM_WS_URL / SDK_IM_API_URL / SDK_FILE_SERVICE_URL
- 新增 scripts/update.sh:热更新脚本,修复配置 + 可选拉镜像 + 重启 + 验证
- 新增 upgrade.sh:一键升级入口,curl 下载后直接执行,流程同 install.sh
- install.sh 检测已有部署(.env 存在),自动路由到 update.sh 而非重跑向导
- 关键配置文件(.env / secrets.env / xuqm.env)在 tarball 解压前备份后恢复

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-20 18:25:12 +08:00

2.0 KiB

部署信息记录模板

部署完成后将此文件复制填写,不要将含有真实凭据的版本提交到 Git


部署信息

项目
部署版本 (见 VERSION 文件)
部署主机
部署目录 /opt/xuqm-private
部署时间
外部访问地址

租户信息

项目
租户名称
登录邮箱
登录用户名
初始密码 (见 config/secrets.env 或部署时设置)
迁移来源 新建 / 公有化平台迁移

应用列表

应用名称 App Key

服务端口

宿主机端口 服务 容器内端口
11224 tenant-service 9001
11225 file-service 8086
11226 tenant-web 80
11227 im-service 8082
11229 update-service 8084
11230 license-service 8085
11231 push-service 8083

宿主机 nginx 配置参考见 docs/runbook.md


数据目录

路径 说明
data/mysql/ MySQL 数据文件
data/redis/ Redis AOF 文件
data/uploads/ 文件服务上传目录
data/update/ 版本管理包存储
data/backups/ 备份文件
logs/ 审计日志

常用运维命令

# 查看所有容器状态
docker compose -f docker-compose.yml -f docker-compose.infra.yml ps

# 查看服务日志
docker compose -f docker-compose.yml -f docker-compose.infra.yml logs --tail 100 tenant-service

# 运行全量验证
bash scripts/verify.sh

# 停止所有服务(保留数据)
docker compose -f docker-compose.yml -f docker-compose.infra.yml down

注意事项

  1. 注册功能已禁用TENANT_REGISTER_ENABLED=false,只能用初始化的账号登录。
  2. 数据持久化MySQL 和 Redis 数据存储在 data/ 目录,容器重启不丢失。
  3. 推送服务push-service 已启动,各厂商推送默认关闭,需填写 config/vendors/push.env 并重启。