快速开始

部署

常规部署形态:jar + MySQL + 反向代理。本站不提供容器镜像与编排文件。

说明:本页只覆盖常规(非容器化)部署:JDK + jar + MySQL + 反向代理。容器镜像与编排文件不在文档范围内,需要时请按你们自己的运维规范封装。

构建产物

./gradlew clean build
ls build/libs/

build 会跑完全部测试与守护规则,产物只有一个可执行 jar。

运行前置

项要求
JDK21(与构建同版本)
数据库MySQL 8.0+,库与账号提前建好
环境变量与 .env.example 完全对应,缺一即启动失败
目录日志目录与上传目录需可写,路径走配置项不写死

启动

java -jar minimao.jar --spring.profiles.active=prod

生产环境建议交给进程管理器托管(systemd / supervisor / Windows 服务任选),核心要求是退出能自动拉起与日志可落盘,与框架无关。

反向代理与健康检查

location / {
    proxy_pass http://127.0.0.1:8080;
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
  • 健康检查走应用自身的健康端点,不要自建 /ping Controller(会绕过鉴权默认拒绝)。
  • 上传文件大小限制要同时配置网关与应用两处,服务端白名单是最后一道。

升级与回滚

  1. 先备份数据库——迁移脚本只增不改,但备份仍是回滚的唯一保险。
  2. 停服,保留旧包(回滚就是换回旧包)。
  3. 换包启动,观察迁移日志是否全部执行成功。
  4. 启动失败立即换回旧包并恢复备份,不要在运行中改脚本。

提示:跨版本升级不改动业务代码:定制留在你的业务仓,核心仓升级只影响核心。

最后更新 2026-10-09编辑此页 →