feat(deploy): 完成私有化部署全流程验收
- 更新部署进度文档，标记P5-02/P5-03为已完成状态 - 修复中文乱码问题，MySQL数据层使用UNHEX函数配合nginx字符集设置 - 配置im-service和update-service的内部服务URL，从127.0.0.1改为Docker服务名 - 实现全功能验收，nginx为所有服务添加路由映射并返回正确的状态码 - 创建私有化部署默认信息文档，记录完整的部署配置和访问地址 - 添加部署清理脚本clean.sh，支持一键清理容器、配置和数据目录 - 更新敏感配置模板，添加详细的密码和密钥配置说明 - 优化前端实时消息轮询机制，通过WebSocket心跳检测决定是否启用HTTP轮询回退
这个提交包含在：
徐勤民
父节点
e5ffde39a0
当前提交
aa5bccae11
@ -1,14 +1 @@
|
|||||||
{
|
{}
|
||||||
"privateVersion": "2026.05.18-private.1",
|
|
||||||
"profiles": ["base"],
|
|
||||||
"mysql": {"mode": "external", "status": "UNKNOWN"},
|
|
||||||
"redis": {"mode": "external", "status": "UNKNOWN"},
|
|
||||||
"services": {
|
|
||||||
"file": true,
|
|
||||||
"im": false,
|
|
||||||
"push": false,
|
|
||||||
"update": false,
|
|
||||||
"license": false
|
|
||||||
},
|
|
||||||
"lastHealthcheck": null
|
|
||||||
}
|
|
||||||
@ -1 +0,0 @@
|
|||||||
|
|
||||||
@ -1,5 +1 @@
|
|||||||
{
|
{"healthy":false}
|
||||||
"status": "UNKNOWN",
|
|
||||||
"checks": []
|
|
||||||
}
|
|
||||||
|
|
||||||
@ -1,9 +1 @@
|
|||||||
# Deployment Progress
|
# 部署进度
|
||||||
|
|
||||||
| Time | Step | Status | Notes |
|
|
||||||
|------|------|--------|-------|
|
|
||||||
|
|
||||||
| 2026-05-18T19:48:27+0800 | configure | STARTED | rendering initial config |
|
|
||||||
| 2026-05-18T19:48:27+0800 | render-config | STARTED | rendering runtime files |
|
|
||||||
| 2026-05-18T19:48:27+0800 | render-config | DONE | runtime files rendered |
|
|
||||||
| 2026-05-18T19:48:27+0800 | configure | DONE | config ready |
|
|
||||||
|
|||||||
154
.env.example
154
.env.example
@ -1,41 +1,147 @@
|
|||||||
|
# =============================================================================
|
||||||
|
# XuqmGroup 私有化部署 — 主入口配置
|
||||||
|
#
|
||||||
|
# 使用方法：
|
||||||
|
# cp .env.example .env
|
||||||
|
# 按注释填写各项，然后执行 ./scripts/deploy-szyx.sh 或 ./scripts/install.sh
|
||||||
|
#
|
||||||
|
# 说明：
|
||||||
|
# - 所有密码/密钥请写入 config/secrets.env（不要写在本文件）
|
||||||
|
# - 域名留空或填 IP 时，服务通过 http://<IP> 访问，适合局域网/内网场景
|
||||||
|
# - COMPOSE_PROFILES 与 ENABLE_* 保持一致
|
||||||
|
# =============================================================================
|
||||||
|
|
||||||
|
# 当前部署版本号，格式：YYYY.MM.DD-private.N
|
||||||
|
# 用于镜像标签匹配和审计追溯
|
||||||
PRIVATE_VERSION=2026.05.18-private.1
|
PRIVATE_VERSION=2026.05.18-private.1
|
||||||
|
|
||||||
|
# =============================================================================
|
||||||
|
# 镜像仓库
|
||||||
|
# =============================================================================
|
||||||
|
|
||||||
|
# 私有 Docker 镜像仓库（不含协议前缀），例如：
|
||||||
|
# crpi-xxxx.cn-beijing.personal.cr.aliyuncs.com/xuqmgroup
|
||||||
REGISTRY=registry.example.com/xuqm
|
REGISTRY=registry.example.com/xuqm
|
||||||
IMAGE_TAG=2026.05.18-private.1
|
|
||||||
|
|
||||||
COMPOSE_PROFILES=base
|
# 仓库登录用户名（install.sh 会自动读取并执行 docker login）
|
||||||
|
REGISTRY_USER=
|
||||||
|
|
||||||
|
# 镜像版本标签，与业务发布版本一一对应
|
||||||
|
# 开发/体验环境可用 latest；生产环境请固定版本号
|
||||||
|
IMAGE_TAG=latest
|
||||||
|
|
||||||
|
# =============================================================================
|
||||||
|
# 服务 Profile — 选择要启动哪些容器
|
||||||
|
# =============================================================================
|
||||||
|
#
|
||||||
|
# 可选值（用逗号分隔）：
|
||||||
|
# base 必选，包含：tenant-service / file-service / tenant-web /
|
||||||
|
# ops-web / docs-site / nginx
|
||||||
|
# infra-mysql 托管 MySQL 容器（MYSQL_MODE=managed 时必选）
|
||||||
|
# infra-redis 托管 Redis 容器（REDIS_MODE=managed 时必选）
|
||||||
|
# im IM HTTP 和 WebSocket 服务
|
||||||
|
# push 厂商推送通知服务
|
||||||
|
# update 版本管理、RN 热更新、应用市场自动发布
|
||||||
|
# license License 校验服务
|
||||||
|
#
|
||||||
|
# 完整部署示例（MySQL/Redis 托管）：
|
||||||
|
# COMPOSE_PROFILES=base,infra-mysql,infra-redis,im,push,update,license
|
||||||
|
# 生产示例（外部 MySQL/Redis）：
|
||||||
|
# COMPOSE_PROFILES=base,im,push,update,license
|
||||||
|
#
|
||||||
|
COMPOSE_PROFILES=base,infra-mysql,infra-redis,im,push,update,license
|
||||||
|
|
||||||
|
# =============================================================================
|
||||||
|
# 功能开关（与 COMPOSE_PROFILES 保持对应）
|
||||||
|
# =============================================================================
|
||||||
|
# 这些开关控制 tenant-service 向 SDK 返回的能力列表
|
||||||
|
# 未部署的服务设为 false，SDK 会禁用相关功能并不发起对应请求
|
||||||
ENABLE_FILE=true
|
ENABLE_FILE=true
|
||||||
ENABLE_IM=false
|
ENABLE_IM=true
|
||||||
ENABLE_PUSH=false
|
ENABLE_PUSH=true
|
||||||
ENABLE_UPDATE=false
|
ENABLE_UPDATE=true
|
||||||
ENABLE_LICENSE=false
|
ENABLE_LICENSE=true
|
||||||
|
|
||||||
MYSQL_MODE=external
|
# =============================================================================
|
||||||
MYSQL_HOST=127.0.0.1
|
# MySQL 配置
|
||||||
|
# =============================================================================
|
||||||
|
#
|
||||||
|
# MYSQL_MODE 可选值：
|
||||||
|
# external 客户自备 MySQL，脚本仅校验连通性，不启动容器
|
||||||
|
# managed 脚本通过 Docker Compose 启动 MySQL 8.4 容器
|
||||||
|
#
|
||||||
|
# 生产环境推荐使用 external 模式，由 DBA 管理数据库
|
||||||
|
# 体验/开发环境可使用 managed 模式快速启动
|
||||||
|
#
|
||||||
|
MYSQL_MODE=managed
|
||||||
|
|
||||||
|
# 数据库主机（managed 模式填写 Docker 服务名 "mysql"；external 填真实 IP/域名）
|
||||||
|
MYSQL_HOST=mysql
|
||||||
MYSQL_PORT=3306
|
MYSQL_PORT=3306
|
||||||
|
|
||||||
|
# 数据库名，首次部署自动创建（managed 模式）
|
||||||
MYSQL_DATABASE=xuqm_private
|
MYSQL_DATABASE=xuqm_private
|
||||||
|
|
||||||
|
# 数据库用户名（managed 模式自动创建此账号）
|
||||||
MYSQL_USERNAME=xuqm
|
MYSQL_USERNAME=xuqm
|
||||||
MYSQL_PASSWORD=change-me
|
|
||||||
MYSQL_ROOT_PASSWORD=
|
# 密码请填写在 config/secrets.env 中的 MYSQL_PASSWORD / MYSQL_ROOT_PASSWORD
|
||||||
|
# 托管模式下若为空或 change-me，install.sh 会自动生成随机密码
|
||||||
|
|
||||||
|
# 数据目录（managed 模式，挂载到宿主机，重启后数据保留）
|
||||||
MYSQL_DATA_DIR=./data/mysql
|
MYSQL_DATA_DIR=./data/mysql
|
||||||
|
|
||||||
REDIS_MODE=external
|
# =============================================================================
|
||||||
REDIS_HOST=127.0.0.1
|
# Redis 配置
|
||||||
|
# =============================================================================
|
||||||
|
#
|
||||||
|
# REDIS_MODE 可选值：
|
||||||
|
# external 客户自备 Redis
|
||||||
|
# managed 脚本通过 Docker Compose 启动 Redis 7 容器
|
||||||
|
#
|
||||||
|
REDIS_MODE=managed
|
||||||
|
REDIS_HOST=redis
|
||||||
REDIS_PORT=6379
|
REDIS_PORT=6379
|
||||||
REDIS_PASSWORD=change-me
|
|
||||||
REDIS_DATABASE=0
|
REDIS_DATABASE=0
|
||||||
REDIS_DATA_DIR=./data/redis
|
REDIS_DATA_DIR=./data/redis
|
||||||
|
|
||||||
CONSOLE_DOMAIN=https://console.customer.com
|
# =============================================================================
|
||||||
OPS_DOMAIN=https://ops.customer.com
|
# 域名 / 访问地址配置
|
||||||
DOCS_DOMAIN=https://docs.customer.com
|
# =============================================================================
|
||||||
FILE_DOMAIN=https://file.customer.com
|
#
|
||||||
IM_DOMAIN=https://im.customer.com
|
# 如果没有域名，直接填写部署机器 IP（含协议），例如：
|
||||||
UPDATE_DOMAIN=https://update.customer.com
|
# CONSOLE_DOMAIN=http://192.168.1.100
|
||||||
LICENSE_DOMAIN=https://license.customer.com
|
# OPS_DOMAIN=http://192.168.1.100
|
||||||
PUSH_DOMAIN=https://push.customer.com
|
#
|
||||||
|
# 如果使用域名，填写完整 URL，例如：
|
||||||
|
# CONSOLE_DOMAIN=https://console.company.com
|
||||||
|
#
|
||||||
|
# 注意：所有 URL 不要以斜杠结尾
|
||||||
|
#
|
||||||
|
# 控制台（租户登录界面）
|
||||||
|
CONSOLE_DOMAIN=http://192.168.1.100
|
||||||
|
# 运营后台（管理员界面）
|
||||||
|
OPS_DOMAIN=http://192.168.1.100
|
||||||
|
# 文档站
|
||||||
|
DOCS_DOMAIN=http://192.168.1.100/docs
|
||||||
|
# 文件服务（上传/下载）
|
||||||
|
FILE_DOMAIN=http://192.168.1.100
|
||||||
|
# IM 服务（未部署时留空）
|
||||||
|
IM_DOMAIN=http://192.168.1.100
|
||||||
|
# 版本管理服务（未部署时留空）
|
||||||
|
UPDATE_DOMAIN=http://192.168.1.100
|
||||||
|
# License 服务（未部署时留空）
|
||||||
|
LICENSE_DOMAIN=http://192.168.1.100
|
||||||
|
# 推送服务（未部署时留空）
|
||||||
|
PUSH_DOMAIN=http://192.168.1.100
|
||||||
|
|
||||||
TENANT_BOOTSTRAP_EMAIL=admin@customer.com
|
# =============================================================================
|
||||||
TENANT_BOOTSTRAP_PASSWORD=change-me-on-first-login
|
# Bootstrap 初始租户（仅首次部署生效，幂等）
|
||||||
|
# =============================================================================
|
||||||
|
#
|
||||||
|
# 私有化部署为单租户模式，首次启动时自动创建此租户和默认 App。
|
||||||
|
# 如果通过 migrate-tenant.sh 迁移现有租户，原 bootstrap 租户数据会被替换。
|
||||||
|
#
|
||||||
|
TENANT_BOOTSTRAP_EMAIL=admin@company.com
|
||||||
|
# 密码请填写在 config/secrets.env 中的 TENANT_BOOTSTRAP_PASSWORD
|
||||||
TENANT_BOOTSTRAP_APP_KEY=ak_private_default
|
TENANT_BOOTSTRAP_APP_KEY=ak_private_default
|
||||||
|
|
||||||
|
|||||||
@ -1,5 +1,71 @@
|
|||||||
MYSQL_PASSWORD=change-me
|
# =============================================================================
|
||||||
MYSQL_ROOT_PASSWORD=
|
# XuqmGroup 私有化部署 — 敏感配置（请勿提交 Git）
|
||||||
REDIS_PASSWORD=change-me
|
#
|
||||||
SMTP_PASSWORD=
|
# 使用方法：
|
||||||
|
# cp config/secrets.env.example config/secrets.env
|
||||||
|
# chmod 600 config/secrets.env
|
||||||
|
# 按注释填写密码，然后执行部署脚本
|
||||||
|
#
|
||||||
|
# 说明：
|
||||||
|
# - 本文件通过 env_file 挂载到容器，不会出现在镜像层
|
||||||
|
# - 托管模式（managed）下：密码为空或 change-me 时，install.sh 自动生成随机密码
|
||||||
|
# - 生产环境请使用强密码（至少 16 位，含大小写字母和数字）
|
||||||
|
# =============================================================================
|
||||||
|
|
||||||
|
# =============================================================================
|
||||||
|
# MySQL 密码
|
||||||
|
# =============================================================================
|
||||||
|
|
||||||
|
# MySQL 业务账号密码（与 .env 中 MYSQL_USERNAME 对应的账号）
|
||||||
|
# managed 模式：自动创建此账号并赋权
|
||||||
|
# external 模式：必须提前在生产库中创建账号
|
||||||
|
MYSQL_PASSWORD=change-me
|
||||||
|
|
||||||
|
# MySQL root 密码（仅 managed 模式使用，用于初始化数据库）
|
||||||
|
# external 模式：留空即可
|
||||||
|
MYSQL_ROOT_PASSWORD=change-me
|
||||||
|
|
||||||
|
# =============================================================================
|
||||||
|
# Redis 密码
|
||||||
|
# =============================================================================
|
||||||
|
|
||||||
|
# Redis 认证密码
|
||||||
|
# managed 模式：自动配置到 Redis 容器
|
||||||
|
# external 模式：填写现有 Redis 的 requirepass 值
|
||||||
|
REDIS_PASSWORD=change-me
|
||||||
|
|
||||||
|
# =============================================================================
|
||||||
|
# Bootstrap 租户密码
|
||||||
|
# =============================================================================
|
||||||
|
|
||||||
|
# 初始租户登录密码（首次部署使用，后续通过控制台修改）
|
||||||
|
# 注意：此密码为明文，系统启动时会自动 bcrypt 哈希后存储
|
||||||
|
TENANT_BOOTSTRAP_PASSWORD=change-me-on-first-login
|
||||||
|
|
||||||
|
# =============================================================================
|
||||||
|
# JWT 签名密钥（可选，留空则自动生成）
|
||||||
|
# =============================================================================
|
||||||
|
|
||||||
|
# JWT HMAC-SHA384 签名密钥，至少 48 字节
|
||||||
|
# 留空时 install.sh 自动生成随机密钥并写回本文件
|
||||||
|
# 修改此值会导致所有已登录用户的 Token 失效
|
||||||
|
XUQM_JWT_SECRET=
|
||||||
|
|
||||||
|
# =============================================================================
|
||||||
|
# 内部服务 Token（可选，留空则自动生成）
|
||||||
|
# =============================================================================
|
||||||
|
|
||||||
|
# 服务间内部调用鉴权 Token
|
||||||
|
# im-service / update-service / push-service 调用 tenant-service 时使用
|
||||||
|
# 留空时 install.sh 自动生成
|
||||||
|
SDK_INTERNAL_TOKEN=
|
||||||
|
|
||||||
|
# License 服务调用 Token
|
||||||
|
LICENSE_INTERNAL_TOKEN=
|
||||||
|
|
||||||
|
# =============================================================================
|
||||||
|
# SMTP 邮件密码（发送验证码邮件）
|
||||||
|
# =============================================================================
|
||||||
|
|
||||||
|
# SMTP 账号密码（明文），请与 config/mail/smtp.env 中的 SMTP_USERNAME 对应
|
||||||
|
SMTP_PASSWORD=
|
||||||
|
|||||||
@ -59,12 +59,35 @@ environment:
|
|||||||
|
|
||||||
## Nginx 服务端口
|
## Nginx 服务端口
|
||||||
|
|
||||||
| 服务 | 容器内端口 | 说明 |
|
| 服务 | 容器内端口 | nginx 路由 |
|
||||||
|------|-----------|------|
|
|------|-----------|-----------|
|
||||||
| tenant-service | **9001** | Spring Boot `server.port=9001`，nginx 必须代理到该端口 |
|
| tenant-service | **9001** | `/api/`（兜底），`/actuator/` |
|
||||||
| file-service | **8086** | nginx 代理 `/file/` 路径时使用 |
|
| file-service | **8086** | `/file/` |
|
||||||
| ops-web | 80 | nginx 代理 `/ops` 路径时使用 |
|
| im-service | **8082** | `/api/im/`，`/ws/im/`（WebSocket） |
|
||||||
| tenant-web | 80 | nginx 代理 `/` 根路径时使用 |
|
| push-service | **8083** | 厂商回调（不直接暴露给前端） |
|
||||||
|
| update-service | **8084** | `/api/v1/updates/`，`/api/v1/rn/` |
|
||||||
|
| license-service | **8085** | 内部调用 |
|
||||||
|
| ops-web | 80 | `/ops` |
|
||||||
|
| tenant-web | 80 | `/`（根路径） |
|
||||||
|
|
||||||
|
## 可选服务内部通信
|
||||||
|
|
||||||
|
im-service 和 update-service 在调用 tenant-service 内部 API 时，需要显式覆盖默认地址：
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
# im-service
|
||||||
|
environment:
|
||||||
|
TENANT_SERVICE_URL: "http://tenant-service:9001"
|
||||||
|
PUSH_SERVICE_URL: "http://push-service:8083"
|
||||||
|
|
||||||
|
# update-service
|
||||||
|
environment:
|
||||||
|
SDK_TENANT_SERVICE_URL: "http://tenant-service:9001"
|
||||||
|
```
|
||||||
|
|
||||||
|
push-service 默认已使用 `http://tenant-service:9001`，无需额外配置。
|
||||||
|
|
||||||
|
`docker-compose.yml` 已包含上述覆盖，不需要手动修改。
|
||||||
|
|
||||||
## docs-site 镜像
|
## docs-site 镜像
|
||||||
|
|
||||||
|
|||||||
201
docs/deployment-defaults.md
普通文件
201
docs/deployment-defaults.md
普通文件
@ -0,0 +1,201 @@
|
|||||||
|
# 私有化部署默认信息
|
||||||
|
|
||||||
|
本文档记录数字医信私有化部署的默认配置，供运维和对接人员参考。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 部署信息
|
||||||
|
|
||||||
|
| 项目 | 值 |
|
||||||
|
|------|-----|
|
||||||
|
| 部署版本 | 2026.05.19-private.1 |
|
||||||
|
| 部署主机 | 192.168.116.9 |
|
||||||
|
| 部署目录 | /opt/xuqm-private |
|
||||||
|
| 部署时间 | 2026-05-19 |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 访问地址
|
||||||
|
|
||||||
|
| 功能 | 地址 |
|
||||||
|
|------|------|
|
||||||
|
| 控制台（租户登录）| http://192.168.116.9 |
|
||||||
|
| 运营后台 | http://192.168.116.9/ops |
|
||||||
|
| 文档站 | http://192.168.116.9/docs/ |
|
||||||
|
| API 入口 | http://192.168.116.9/api/ |
|
||||||
|
| Actuator 健康 | http://192.168.116.9/actuator/health |
|
||||||
|
|
||||||
|
> **说明**：采用纯 IP 部署，无需配置域名。局域网内任意机器均可通过上述地址访问完整功能。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 租户信息
|
||||||
|
|
||||||
|
| 项目 | 值 |
|
||||||
|
|------|-----|
|
||||||
|
| 租户名称 | 数字医信 |
|
||||||
|
| 登录邮箱 | szyx@bjca.org.cn |
|
||||||
|
| 登录用户名 | szyx |
|
||||||
|
| 初始密码 | 与公有化平台相同（迁移时未重置） |
|
||||||
|
| 迁移来源 | 公有化平台（39.107.53.187） |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 应用列表
|
||||||
|
|
||||||
|
| 应用名称 | App Key |
|
||||||
|
|----------|---------|
|
||||||
|
| 医网信 | ak_c6fce237cae94ef5ab71fda6 |
|
||||||
|
| 临床知识库 | ak_1178fd37b8f54cefb7031744 |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 服务列表和端口
|
||||||
|
|
||||||
|
### 对外服务（通过 nginx 统一入口）
|
||||||
|
|
||||||
|
| 服务名 | 内部端口 | nginx 路由路径 | 说明 |
|
||||||
|
|--------|----------|----------------|------|
|
||||||
|
| tenant-service | 9001 | `/api/*` `/actuator/*` | 核心 API，认证、租户、SDK 配置 |
|
||||||
|
| file-service | 8086 | `/file/*` | 文件上传下载，最大 500MB |
|
||||||
|
| im-service | 8082 | `/api/im/*` `/ws/im/*` | IM HTTP API 和 WebSocket |
|
||||||
|
| update-service | 8084 | `/api/v1/updates/*` `/api/v1/rn/*` | APP 版本管理和 RN 热更新 |
|
||||||
|
| license-service | 8085 | 内部调用 | License 有效期校验 |
|
||||||
|
| push-service | 8083 | 内部调用 | 厂商推送通知 |
|
||||||
|
| docs-site | 80 | `/docs/*` | 私有化 SDK 文档站 |
|
||||||
|
| ops-web | 80 | `/ops` | 运营后台前端 |
|
||||||
|
| tenant-web | 80 | `/` | 控制台前端（兜底路由） |
|
||||||
|
|
||||||
|
### 基础设施（Docker 内部，不对外暴露）
|
||||||
|
|
||||||
|
| 服务名 | 内部端口 | 模式 | 说明 |
|
||||||
|
|--------|----------|------|------|
|
||||||
|
| mysql | 3306 | managed | MySQL 8.4，Docker 容器托管 |
|
||||||
|
| redis | 6379 | managed | Redis 7.4，AOF 持久化 |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Docker Compose Profiles
|
||||||
|
|
||||||
|
| Profile | 包含服务 | 说明 |
|
||||||
|
|---------|----------|------|
|
||||||
|
| base | tenant-service, file-service, tenant-web, ops-web, docs-site, nginx | 必选核心服务 |
|
||||||
|
| infra-mysql | mysql | 托管数据库（MYSQL_MODE=managed 时启用） |
|
||||||
|
| infra-redis | redis | 托管缓存（REDIS_MODE=managed 时启用） |
|
||||||
|
| im | im-service | IM 服务（可选） |
|
||||||
|
| push | push-service | 推送服务（可选） |
|
||||||
|
| update | update-service | 版本管理服务（可选） |
|
||||||
|
| license | license-service | License 服务（可选） |
|
||||||
|
|
||||||
|
**当前启用的 Profiles**：`base,infra-mysql,infra-redis,im,push,update,license`（全量部署）
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 数据库
|
||||||
|
|
||||||
|
| 项目 | 值 |
|
||||||
|
|------|-----|
|
||||||
|
| 主机 | mysql（Docker 服务名） |
|
||||||
|
| 端口 | 3306 |
|
||||||
|
| 数据库名 | xuqm_private |
|
||||||
|
| 业务账号 | xuqm |
|
||||||
|
| 业务密码 | XuqmMysql@2026 |
|
||||||
|
| Root 密码 | XuqmRoot@2026 |
|
||||||
|
| 字符集 | utf8mb4 / utf8mb4_unicode_ci |
|
||||||
|
| 时区 | +08:00 |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Redis
|
||||||
|
|
||||||
|
| 项目 | 值 |
|
||||||
|
|------|-----|
|
||||||
|
| 主机 | redis（Docker 服务名） |
|
||||||
|
| 端口 | 6379 |
|
||||||
|
| 数据库 | 0 |
|
||||||
|
| 密码 | XuqmRedis@2026 |
|
||||||
|
| 持久化 | AOF（appendonly yes） |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 数据目录
|
||||||
|
|
||||||
|
| 路径 | 说明 |
|
||||||
|
|------|------|
|
||||||
|
| `./data/mysql/` | MySQL 数据文件（重启后保留） |
|
||||||
|
| `./data/redis/` | Redis AOF 文件（重启后保留） |
|
||||||
|
| `./data/uploads/` | 文件服务上传目录 |
|
||||||
|
| `./data/update/` | 版本管理包存储目录 |
|
||||||
|
| `./data/backups/` | 迁移备份 |
|
||||||
|
| `./logs/` | 审计日志 |
|
||||||
|
| `./.deploy-state/` | 部署状态和验证结果 |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 配置文件清单
|
||||||
|
|
||||||
|
| 文件 | 说明 |
|
||||||
|
|------|------|
|
||||||
|
| `.env` | 主配置文件（COMPOSE_PROFILES、域名、功能开关） |
|
||||||
|
| `config/secrets.env` | 敏感凭据（chmod 600） |
|
||||||
|
| `config/xuqm.env` | 业务服务容器内配置 |
|
||||||
|
| `config/tenant/bootstrap.env` | 初始租户配置（迁移后由真实数据替换） |
|
||||||
|
| `config/nginx/conf.d/xuqm.conf` | Nginx 路由配置 |
|
||||||
|
| `config/sdk/xuqm-private-sdk.json` | SDK 初始化配置文件 |
|
||||||
|
| `config/docs/docs-runtime.json` | 文档站运行时配置 |
|
||||||
|
| `config/vendors/push.env` | 推送厂商凭据（默认全部关闭） |
|
||||||
|
| `config/vendors/store-submit.env` | 应用市场发布凭据（默认全部关闭） |
|
||||||
|
| `config/mail/smtp.env` | 邮件服务配置 |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 常用运维命令
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 进入部署目录
|
||||||
|
cd /opt/xuqm-private
|
||||||
|
|
||||||
|
# 查看所有容器状态
|
||||||
|
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
|
||||||
|
|
||||||
|
# 重新部署（幂等）
|
||||||
|
DEPLOY_HOST=192.168.116.9 bash scripts/deploy-szyx.sh
|
||||||
|
|
||||||
|
# 手动迁移租户
|
||||||
|
bash scripts/migrate-tenant.sh \
|
||||||
|
--src-host 39.107.53.187 \
|
||||||
|
--src-user xuqm \
|
||||||
|
--src-password Xuqm@2026 \
|
||||||
|
--src-db xuqm_tenant \
|
||||||
|
--tenant szyx@bjca.org.cn
|
||||||
|
|
||||||
|
# 停止所有服务（保留数据）
|
||||||
|
docker compose -f docker-compose.yml -f docker-compose.infra.yml down
|
||||||
|
|
||||||
|
# 停止并清除所有数据（！不可恢复）
|
||||||
|
docker compose -f docker-compose.yml -f docker-compose.infra.yml down -v
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 验证结果
|
||||||
|
|
||||||
|
验证报告保存在 `.deploy-state/last-verify.json`，包含所有检查项的 PASS / WARN / FAIL 状态。
|
||||||
|
|
||||||
|
详细验证步骤见 [docs/acceptance-checklist.md](acceptance-checklist.md)。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 注意事项
|
||||||
|
|
||||||
|
1. **注册功能已禁用**：`TENANT_REGISTER_ENABLED=false`，任何人都无法自行注册账号，只能用迁移的账号登录。
|
||||||
|
2. **纯 IP 部署**：所有服务通过 `http://192.168.116.9` 访问，如需 HTTPS，请配置 SSL 证书并修改 nginx 配置（见 `docs/runbook.md`）。
|
||||||
|
3. **数据持久化**：MySQL 和 Redis 数据存储在宿主机 `./data/` 目录，容器重启不丢失。重装需手动清除。
|
||||||
|
4. **推送服务**：push-service 已启动，但各厂商推送默认关闭，需在 `config/vendors/push.env` 填写凭据并重启。
|
||||||
|
5. **中文字符集**：所有服务使用 utf8mb4，JDBC 连接串包含 `characterEncoding=UTF-8`，中文数据正常存储。
|
||||||
125
scripts/clean.sh
可执行文件
125
scripts/clean.sh
可执行文件
@ -0,0 +1,125 @@
|
|||||||
|
#!/usr/bin/env bash
|
||||||
|
# clean.sh — 清理本次私有化部署，恢复到全新状态，供重新 deploy.sh 使用
|
||||||
|
#
|
||||||
|
# 操作：
|
||||||
|
# 1. 停止并删除所有 Compose 容器及网络
|
||||||
|
# 2. 删除 deploy.sh 生成的所有配置文件
|
||||||
|
# 3. 清空 data/ 数据目录（MySQL / Redis / uploads / update），保留 .gitkeep
|
||||||
|
# 4. 清除部署状态文件和日志
|
||||||
|
|
||||||
|
set -euo pipefail
|
||||||
|
|
||||||
|
ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
|
||||||
|
cd "$ROOT_DIR"
|
||||||
|
|
||||||
|
ok() { printf ' \033[32m✓\033[0m %s\n' "$*"; }
|
||||||
|
info() { printf ' \033[1;36m→\033[0m %s\n' "$*"; }
|
||||||
|
warn() { printf ' \033[33m⚠\033[0m %s\n' "$*"; }
|
||||||
|
|
||||||
|
printf '\n\033[1;31m══════════════════════════════════════════════════\033[0m\n'
|
||||||
|
printf '\033[1;31m XuqmGroup 私有化部署清理脚本\033[0m\n'
|
||||||
|
printf '\033[1;31m══════════════════════════════════════════════════\033[0m\n'
|
||||||
|
printf ' 目录: %s\n\n' "$ROOT_DIR"
|
||||||
|
|
||||||
|
printf ' \033[33m警告：此操作将删除所有容器、配置和数据，不可恢复！\033[0m\n'
|
||||||
|
read -rp " 确认清理？输入 yes 继续: " _confirm
|
||||||
|
[ "$_confirm" = "yes" ] || { printf ' 已取消\n'; exit 0; }
|
||||||
|
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
# 1. 停止并删除 Compose 容器、网络
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
printf '\n [1/4] 停止容器并删除网络...\n'
|
||||||
|
|
||||||
|
_compose_down() {
|
||||||
|
local f="$1"; shift
|
||||||
|
if [ -f "$f" ]; then
|
||||||
|
docker compose -f "$f" "$@" down --remove-orphans --timeout 15 2>/dev/null && true
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
# 先尝试带 override，再降级到单文件
|
||||||
|
if [ -f docker-compose.override.yml ]; then
|
||||||
|
docker compose \
|
||||||
|
-f docker-compose.infra.yml \
|
||||||
|
-f docker-compose.yml \
|
||||||
|
-f docker-compose.override.yml \
|
||||||
|
down --remove-orphans --timeout 15 2>/dev/null && true
|
||||||
|
else
|
||||||
|
docker compose \
|
||||||
|
-f docker-compose.infra.yml \
|
||||||
|
-f docker-compose.yml \
|
||||||
|
down --remove-orphans --timeout 15 2>/dev/null && true
|
||||||
|
fi
|
||||||
|
|
||||||
|
ok "容器已停止"
|
||||||
|
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
# 2. 删除 deploy.sh 生成的配置文件
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
printf '\n [2/4] 删除生成的配置文件...\n'
|
||||||
|
|
||||||
|
# 顶层生成文件
|
||||||
|
rm -f .env
|
||||||
|
rm -f docker-compose.override.yml
|
||||||
|
ok ".env、docker-compose.override.yml"
|
||||||
|
|
||||||
|
# config/ 下的生成文件
|
||||||
|
rm -f config/secrets.env
|
||||||
|
rm -f config/xuqm.env
|
||||||
|
rm -f config/tenant/bootstrap.env
|
||||||
|
rm -f config/nginx/conf.d/xuqm.conf
|
||||||
|
rm -f config/sdk/xuqm-private-sdk.json
|
||||||
|
rm -f config/docs/docs-runtime.json
|
||||||
|
ok "config/secrets.env、xuqm.env、bootstrap.env、nginx conf、sdk json"
|
||||||
|
|
||||||
|
# vendors / mail 中由 deploy.sh 写入的文件（保留 .example 模板）
|
||||||
|
# deploy.sh 用 cat > 覆盖写入，清理后让脚本重新生成
|
||||||
|
rm -f config/vendors/push.env
|
||||||
|
rm -f config/vendors/store-submit.env
|
||||||
|
rm -f config/mail/smtp.env
|
||||||
|
ok "config/vendors/*.env、config/mail/smtp.env"
|
||||||
|
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
# 3. 清空数据目录（保留 .gitkeep）
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
printf '\n [3/4] 清空 data/ 数据目录...\n'
|
||||||
|
|
||||||
|
_clean_dir() {
|
||||||
|
local dir="$1"
|
||||||
|
if [ -d "$dir" ]; then
|
||||||
|
find "$dir" -mindepth 1 ! -name '.gitkeep' -exec rm -rf {} + 2>/dev/null && true
|
||||||
|
ok "$dir"
|
||||||
|
else
|
||||||
|
warn "$dir 不存在，跳过"
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
_clean_dir data/mysql
|
||||||
|
_clean_dir data/redis
|
||||||
|
_clean_dir data/uploads
|
||||||
|
_clean_dir data/update
|
||||||
|
_clean_dir data/backups
|
||||||
|
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
# 4. 清除状态文件和日志
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
printf '\n [4/4] 清除部署状态和日志...\n'
|
||||||
|
|
||||||
|
if [ -d .deploy-state ]; then
|
||||||
|
rm -rf .deploy-state
|
||||||
|
ok ".deploy-state/"
|
||||||
|
fi
|
||||||
|
|
||||||
|
if [ -f logs/audit.log ]; then
|
||||||
|
rm -f logs/audit.log
|
||||||
|
ok "logs/audit.log"
|
||||||
|
fi
|
||||||
|
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
# 完成
|
||||||
|
# ---------------------------------------------------------------------------
|
||||||
|
printf '\n\033[1;32m══════════════════════════════════════════════════\033[0m\n'
|
||||||
|
printf '\033[1;32m 清理完成！\033[0m\n'
|
||||||
|
printf '\033[1;32m══════════════════════════════════════════════════\033[0m\n'
|
||||||
|
printf ' 现在可以重新运行一键部署：\n'
|
||||||
|
printf '\n bash scripts/deploy.sh\n\n'
|
||||||
正在加载...
在新工单中引用
屏蔽一个用户
