dde3f9ece7
- README: 补充 reset.sh 快速入口和脚本对比表 - runbook: 新增「容器重置」章节和「故障排查」（502/crash-loop/WebSocket/镜像未生效） - configuration: 修正端口表（im=11228/push=11229/update=11230/license=11231）， 补充 SPRING_DATASOURCE_PASSWORD 设计说明，移除已废弃的 environment 密码块说明 - acceptance-checklist: 修正端口号，补充 WebSocket 多层透传说明，移除不存在的 11227 行 - deployment-defaults: 同步端口表，补充 reset.sh 和 WebSocket 注意事项 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
109 行
3.5 KiB
Markdown
109 行
3.5 KiB
Markdown
# XuqmGroup 私有化部署
|
||
|
||
## 快速开始
|
||
|
||
### 首次部署
|
||
|
||
```bash
|
||
curl -fsSL https://xuqinmin.com/xuqmGroup/XuqmGroup-PrivateDeploy/raw/branch/main/install.sh \
|
||
-o install.sh && bash install.sh
|
||
```
|
||
|
||
交互式向导依次完成：依赖检测 → 配置生成 → 镜像拉取 → 容器启动 → 租户初始化 → 全量验证。
|
||
|
||
### 升级已有部署
|
||
|
||
```bash
|
||
curl -fsSL https://xuqinmin.com/xuqmGroup/XuqmGroup-PrivateDeploy/raw/branch/main/upgrade.sh \
|
||
-o upgrade.sh && bash upgrade.sh
|
||
```
|
||
|
||
保留全部数据和配置，自动修复已知配置问题，可选拉取新镜像，完成后运行全量验证。
|
||
|
||
### 容器异常重置
|
||
|
||
```bash
|
||
bash scripts/reset.sh
|
||
```
|
||
|
||
适用于：nginx 502、服务 crash-loop、密码注入错误、升级后镜像未生效。保留数据和配置，彻底重建所有容器。
|
||
|
||
---
|
||
|
||
## 脚本说明
|
||
|
||
| 脚本 | 适用场景 |
|
||
|------|---------|
|
||
| `install.sh` | 全新服务器首次部署；或彻底清除数据重装 |
|
||
| `upgrade.sh` | 保留数据，更新部署脚本和镜像（推荐日常升级方式） |
|
||
| `scripts/reset.sh` | 保留数据，容器状态异常时快速重建恢复 |
|
||
| `scripts/update.sh` | 在安装目录内执行的局部升级（由 upgrade.sh 调用） |
|
||
| `scripts/verify.sh` | 随时重新运行全量验证 |
|
||
| `scripts/backup.sh` | 备份数据 |
|
||
| `scripts/restore.sh` | 恢复备份 |
|
||
|
||
---
|
||
|
||
## 部署架构
|
||
|
||
```
|
||
上层 nginx（任意层级，HTTPS / 域名）
|
||
│
|
||
└── 本机 IP:80 内置 nginx 容器（统一入口）
|
||
│
|
||
├── tenant-service /api/ /actuator/
|
||
├── file-service /file/
|
||
├── tenant-web /（兜底）
|
||
├── im-service /api/im/ /ws/im
|
||
├── update-service /api/v1/updates/ /api/v1/rn/
|
||
├── license-service /api/license/
|
||
└── push-service （厂商回调，按需）
|
||
```
|
||
|
||
内置 nginx 容器直接绑定宿主机 `0.0.0.0:80`，**宿主机无需配置 nginx**，上层 nginx 直接 proxy_pass 到本机 IP 即可。各业务容器（11224–11231）绑定 `127.0.0.1`，仅用于本地调试。
|
||
|
||
---
|
||
|
||
## 租户初始化方式
|
||
|
||
安装脚本启动后交互式选择：
|
||
|
||
- **新建租户**：填写邮箱、用户名、密码，首次启动自动创建
|
||
- **迁移租户**：在公有化平台安全中心生成迁移密钥（`pmk_` 开头），粘贴后自动完成导入
|
||
|
||
---
|
||
|
||
## 服务说明
|
||
|
||
| Profile | 服务 | 说明 |
|
||
|---------|------|------|
|
||
| base | tenant-service, file-service, tenant-web, nginx | 必选核心服务（含内置路由 nginx） |
|
||
| infra-mysql | mysql | 托管数据库 |
|
||
| infra-redis | redis | 托管缓存 |
|
||
| im | im-service | IM HTTP + WebSocket |
|
||
| push | push-service | 厂商推送 |
|
||
| update | update-service | 版本管理 + RN 热更新 |
|
||
| license | license-service | License 校验 |
|
||
|
||
```bash
|
||
# 后期启用 / 禁用可选服务
|
||
bash scripts/enable-service.sh im
|
||
bash scripts/disable-service.sh im
|
||
```
|
||
|
||
---
|
||
|
||
## 注意事项
|
||
|
||
- 上层 nginx 每一层都必须透传 `Upgrade` / `Connection` 头，否则 IM WebSocket 会断开，详见 [docs/runbook.md](docs/runbook.md)
|
||
- 宿主机本身无需配置 nginx
|
||
|
||
---
|
||
|
||
## 文档
|
||
|
||
- [运行手册](docs/runbook.md) — 完整部署流程、nginx 配置、故障排查、常用运维命令
|
||
- [配置说明](docs/configuration.md) — 各配置文件字段说明
|
||
- [验收清单](docs/acceptance-checklist.md) — 交付验收检查项
|
||
- [部署信息记录模板](docs/deployment-defaults.md) — 填写后交付客户存档
|
