开源发行 / 一键部署快速开始

20 分钟清单

1. 下载 release/community 发行包。
2. 配置 .env 并执行安装脚本。
3. 访问 /actuator/health 检查服务状态。
4. 打开后台完成初始化账号设置。

前置条件

• 已准备可用服务器或 Docker 运行环境。
• 已下载完整发行包并校验文件完整性。
• 已准备数据库、Redis 连接参数。

详细步骤（可直接执行）

1. 解压发行包并复制 .env.example 为 .env。
2. 按环境填写数据库、Redis、端口等配置。
3. 执行 install.sh 或 bt-install.sh 完成部署。
4. 访问 /actuator/health 和后台登录页完成首轮验证。

预期结果

• 5 分钟内可完成首次部署启动。
• 安装脚本可重复执行且不破坏环境。
• 管理后台可正常登录并进行基础配置。

失败回滚

• 安装失败：执行 rollback.sh 恢复安装前状态。
• 升级失败：回滚到上一发行包版本并恢复配置。
• 配置错误：恢复 .env 备份后重新执行安装。

常见报错与处理

• 端口占用：修改 APP_PORT 并重启服务。
• 数据库初始化失败：检查账号权限和库字符集。
• 健康检查失败：查看应用日志定位启动异常。

提单时请提供

• 操作系统与部署方式（脚本/宝塔/Docker）。
• .env 脱敏配置与安装日志。
• 健康检查结果和错误截图。