From 8fb24211df3dd09efed01b1309564544365ec81f Mon Sep 17 00:00:00 2001 From: liufumingren Date: Sun, 1 Nov 2026 23:30:21 +0800 Subject: [PATCH] =?UTF-8?q?docs(deploy):=20=E5=8D=95=E5=9F=9F=E5=90=8D?= =?UTF-8?q?=E9=83=A8=E7=BD=B2=E8=A1=A5=E5=85=85=20/openapi=20=E5=8F=8D?= =?UTF-8?q?=E4=BB=A3=E4=B8=8E=E6=97=A7=E5=9F=9F=E5=90=8D=E9=80=80=E5=BD=B9?= =?UTF-8?q?=E6=AD=A5=E9=AA=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Nginx 示例增加 location = /openapi(外部系统回推入口),OMS_CALLBACK_BASE_URL 指向站点域名 - 新增「旧域名 api.oms.gztbyc.com 的处置」:改回调地址 → 观察日志 → 删站点与 DNS, 但 deployRoot 目录必须保留(v1/v2、shared-config、nginx-upstream.conf、backups) Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- tools/DEPLOY.md | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) diff --git a/tools/DEPLOY.md b/tools/DEPLOY.md index d84498e..a6af882 100644 --- a/tools/DEPLOY.md +++ b/tools/DEPLOY.md @@ -165,6 +165,19 @@ server { proxy_read_timeout 300s; # 导出/批量等长请求 client_max_body_size 50m; # 上传上限,按需调整 } + + # 外部系统(WMS 等)回推入口:路径与后端 router 的 /openapi 一致, + # OMS_CALLBACK_BASE_URL 应配成本站点域名,拼出来的回调地址即 https://<站点域名>/openapi + location = /openapi { + include /www/wwwroot/api.oms.gztbyc.com/nginx-upstream.conf; + proxy_http_version 1.1; + proxy_set_header Host $host; + proxy_set_header X-Real-IP $remote_addr; + proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; + proxy_set_header X-Forwarded-Proto $scheme; + proxy_read_timeout 300s; + client_max_body_size 50m; + } } ``` @@ -180,6 +193,20 @@ server { > 站点 → 设置 → 配置文件 → **扩展配置**(实际落盘 `/www/server/panel/vhost/nginx/extension/<域名>/*.conf`), > 用 `location ^~ /api/ { include .../nginx-upstream.conf; proxy_set_header ...; }`,面板重写主配置也不会丢。 +### 旧域名 `api.oms.gztbyc.com` 的处置 + +单站点部署后,后端只需要经 `https://oms.gztbyc.com/api`(前端)与 `https://oms.gztbyc.com/openapi` +(外部系统回调)访问,`api.oms.gztbyc.com` 只是同一后端的另一个入口,可以逐步退役: + +1. `OMS_CALLBACK_BASE_URL` 改成 `https://oms.gztbyc.com`,让新配置的外部系统直接看到新地址; +2. 观察 `api.oms.gztbyc.com` 的访问日志,确认只剩扫描器、没有业务请求(`/openapi`、`/api/*`)后, + 在宝塔删除该站点并删掉 DNS 记录; +3. **目录 `/www/wwwroot/api.oms.gztbyc.com/` 不要删**:`v1/`、`v2/`、`shared-config/`、 + `nginx-upstream.conf`、`.deploy/backups/` 都在里面,发布脚本与 Nginx 的 `include` 都依赖它; + 真要改名得同时改 `deploy.config.local.cjs` 的 `deployRoot` 和扩展配置里 `include` 的路径; +4. 旧版前端产物(`VITE_API_BASE_URL` 仍写死 `https://api.oms.gztbyc.com/api` 的版本)在删除站点后 + 会整体失效,确认没有用户的浏览器缓存旧页面再动手。 + ### 数据库迁移 发布脚本默认 `runMigrations: false`(见 `config/deploy.config.local.cjs`),不会执行迁移。