diff --git a/tools/DEPLOY.md b/tools/DEPLOY.md index 82ce586..d84498e 100644 --- a/tools/DEPLOY.md +++ b/tools/DEPLOY.md @@ -171,6 +171,32 @@ server { 宝塔面板:站点 `oms.gztbyc.com` 的**网站目录**设为 `/www/wwwroot/oms.gztbyc.com/current`, 并删掉指向 `127.0.0.1:6090` 的旧 `/api` 反代,改成上面的 `include`。 +> ⚠️ 静态站点默认只有 `location / { try_files $uri $uri/ /index.html; }`,**没有 `/api/` 反代**: +> 前端改成同源 `/api` 后,所有接口都会命中 SPA 回退返回 `index.html`(表现为「配置没生效」、 +> 刷新页面正常但任何接口都拿不到数据)。缺这一段时 `curl https://<站点域名>/api/auth/wechat/enabled` +> 会返回 HTML 而不是 JSON。 +> +> 宝塔面板改「网站目录 / 伪静态」会重写站点主配置,建议把 `/api/` 反代放进 +> 站点 → 设置 → 配置文件 → **扩展配置**(实际落盘 `/www/server/panel/vhost/nginx/extension/<域名>/*.conf`), +> 用 `location ^~ /api/ { include .../nginx-upstream.conf; proxy_set_header ...; }`,面板重写主配置也不会丢。 + +### 数据库迁移 + +发布脚本默认 `runMigrations: false`(见 `config/deploy.config.local.cjs`),不会执行迁移。 +新增迁移后有两种做法: + +1. 发布前把该配置改成 `true`(发布流程第 4 步会跑 `npm run migration:up`,失败即中断本次发布); +2. 发布后到**当前活跃版本目录**手动执行: + +```bash +cd /www/wwwroot/api.oms.gztbyc.com/v1 # 版本看 current.md +npm install --no-save sequelize-cli@6.6.5 # 生产依赖是 npm install --production,不含 sequelize-cli +node_modules/.bin/sequelize-cli db:migrate +npm prune --omit=dev --no-audit --no-fund # 跑完清掉临时装的开发依赖 +``` + +迁移前建议先备份:`mysqldump ... --single-transaction | gzip > .deploy/backups/db-<时间>.sql.gz`。 + ### 服务器端 `.env`(仅首次,之后由 shared-config 管理) 需要包含:`MYSQL_*`、`REDIS_*`、`JWT_SECRET`、`UPLOAD_DIR=/uploads`(版本目录之外,