From 378e1bf7b1fc6cfd4cd5b569da5ad03f4a140aae Mon Sep 17 00:00:00 2001 From: liufumingren Date: Sun, 1 Nov 2026 23:26:06 +0800 Subject: [PATCH] =?UTF-8?q?docs(deploy):=20=E8=A1=A5=E5=85=85=20/api=20?= =?UTF-8?q?=E5=8F=8D=E4=BB=A3=E4=B8=8E=E7=94=9F=E4=BA=A7=E8=BF=81=E7=A7=BB?= =?UTF-8?q?=E7=9A=84=E8=B8=A9=E5=9D=91=E8=AF=B4=E6=98=8E?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 静态站点默认没有 /api/ 反代,前端同源 /api 后会全部命中 SPA 回退返回 index.html, 补充现象描述与宝塔「扩展配置」放置位置(面板重写主配置不丢) - 新增「数据库迁移」小节:runMigrations=false 时如何手动执行(含 sequelize-cli 临时安装与 prune) Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- tools/DEPLOY.md | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) 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`(版本目录之外,