独立部署 / 私有化快速开始

20 分钟清单

1. 校验主机资源与端口可用性。
2. 执行安装脚本并启动服务。
3. 访问健康检查接口确认服务可用。
4. 打开官网 /guide 页面确认手册可访问。

前置条件

• 已收到私有化交付包与 License 文件。
• 已准备服务器、MySQL、Redis 和域名证书。
• 已确认生产密钥托管方式（环境变量或客户 KMS）。

详细步骤（可直接执行）

1. 执行环境预检查，确认端口、磁盘、JDK 版本符合要求。
2. 按交付文档执行安装脚本并导入配置。
3. 启动服务后访问 /actuator/health 检查状态。
4. 访问官网 /guide、管理端登录页、关键 API 路径完成冒烟。

预期结果

• 服务成功启动并健康检查通过。
• 客户可访问文档站并独立完成基础配置。
• 部署信息与版本号可追溯。

失败回滚

• 启动失败：回滚到上一个可用制品并恢复旧配置。
• 迁移失败：执行回滚 SQL 或恢复备份。
• 密钥配置错误：撤销当前环境变量并重新注入。

常见报错与处理

• 数据库连接失败：检查网络白名单和账号权限。
• Redis 连接超时：核对主机地址与端口映射。
• License 校验失败：确认 License 与部署环境匹配。

提单时请提供

• 部署环境信息（OS、JDK、DB、Redis 版本）。
• 错误日志与执行命令。
• 失败时间点和回滚动作记录。