docs(deploy): 单域名部署补充 /openapi 反代与旧域名退役步骤

- 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>
This commit is contained in:
liufumingren 2026-11-01 23:30:21 +08:00
parent 378e1bf7b1
commit 8fb24211df

View File

@ -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`),不会执行迁移。