XuqmGroup-PrivateDeploy/docs/deployment-defaults.md
2026-07-27 13:21:01 +08:00

2.2 KiB

部署信息记录模板

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


部署信息

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

租户信息

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

应用列表

应用名称 App Key

服务端口

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

宿主机 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

# 容器异常时重置(保留数据)
bash scripts/reset.sh

注意事项

  1. 注册功能已禁用TENANT_REGISTER_ENABLED=false,只能用初始化的账号登录。
  2. 数据持久化MySQL 和 Redis 数据存储在 data/ 目录,容器重启不丢失。
  3. 推送服务push-service 已启动,各厂商推送默认关闭,需填写 config/vendors/push.env 并重启。
  4. WebSocket:每一层 nginx 代理都必须透传 Upgrade / Connection 头,否则 IM 连接失败。