chore: 清理指向 api.oms.gztbyc.com 的残留引用

- env 样板:OMS_CALLBACK_BASE_URL 改为 https://oms.gztbyc.com(后端/发布两处)
- 前端:env.d.ts 示例与 mediaUrl() 注释改为同源说明(生产 /api 不再跨域)
- DEPLOY.md:旧域名章节改为「已下线」,说明目录 /www/wwwroot/api.oms.gztbyc.com/
  只是发布目录名、与域名无关;同源章节去掉「保留 CORS 给老域名」的过时说明
- deploy.config.example.cjs:注明 include 路径与域名是否对外服务无关

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
This commit is contained in:
liufumingren 2026-11-01 23:41:08 +08:00
parent 3404543418
commit ed98349ea2
6 changed files with 26 additions and 21 deletions

View File

@ -33,7 +33,8 @@ UPLOAD_DIR=/www/wwwroot/api.oms.gztbyc.com/uploads
# —— 对外回调地址(可选)——
# 外部系统(WMS 等)回推 /openapi 时展示/使用的地址;不配则按请求 Host 动态生成
OMS_CALLBACK_BASE_URL=http://api.oms.gztbyc.com
# 单站点部署下与前端同源,Nginx 需把 /openapi 也反代到后端(见 tools/DEPLOY.md)
OMS_CALLBACK_BASE_URL=https://oms.gztbyc.com
# —— 跨域白名单(可选)——
# 生产前后端同源(https://<站点域名>/api),默认不配即可;默认只放行本地开发 localhost:5173

2
frontend/env.d.ts vendored
View File

@ -2,7 +2,7 @@
/** 环境变量(各环境取值见 .env.development / .env.production) */
interface ImportMetaEnv {
/** 后端 API 基础地址,必须带 /api 前缀,如 http://api.oms.gztbyc.com/api */
/** 后端 API 基础地址,必须带 /api 前缀;生产同源用 /api,直连后端时用 https://<后端域名>/api */
readonly VITE_API_BASE_URL?: string
}

View File

@ -2,8 +2,8 @@
* 后端静态资源地址归一化
*
* 后端返回的是相对地址(如 /api/files/raw/1/2026/09/14/xxx.png,见 backend/config 的 upload.urlPrefix),
* 生产环境前端站点(oms.gztbyc.com)与 API 站点(api.oms.gztbyc.com)不同源,
* 相对地址会被解析到前端站点域名下而 404,因此渲染前要补上 API 站点的 origin。
* 生产环境前端与后端同源(https://oms.gztbyc.com/api),相对地址直接用即可;
* 仅当 VITE_API_BASE_URL 配成绝对地址(直连后端调试)时,才需要补上该地址的 origin。
*
* 本地开发 VITE_API_BASE_URL=/api(同源,走 vite 代理),原样返回。
* 注意:只在「渲染」时使用,写回接口的字段仍要保存后端原始值。

View File

@ -193,19 +193,20 @@ server {
> 站点 → 设置 → 配置文件 → **扩展配置**(实际落盘 `/www/server/panel/vhost/nginx/extension/<域名>/*.conf`),
> 用 `location ^~ /api/ { include .../nginx-upstream.conf; proxy_set_header ...; }`,面板重写主配置也不会丢。
### 旧域名 `api.oms.gztbyc.com` 的处置
### `api.oms.gztbyc.com`(已下线)
单站点部署后,后端只需要经 `https://oms.gztbyc.com/api`(前端)与 `https://oms.gztbyc.com/openapi`
(外部系统回调)访问,`api.oms.gztbyc.com` 只是同一后端的另一个入口,可以逐步退役:
后端只经 `https://oms.gztbyc.com/api`(前端)与 `https://oms.gztbyc.com/openapi`(外部系统回调)访问。
该域名的站点配置已移除(原配置备份在 `<deployRoot>/.deploy/backup-vhost/`),`OMS_CALLBACK_BASE_URL`
已指向站点域名,域名解析(DNS)可以一并删掉。
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` 的版本)在删除站点后
会整体失效,确认没有用户的浏览器缓存旧页面再动手。
- **目录 `/www/wwwroot/api.oms.gztbyc.com/` 不要删**:`v1/`、`v2/`、`shared-config/`、
`nginx-upstream.conf`、`.deploy/backups/` 都在里面,发布脚本与站点扩展配置的 `include` 都依赖它;
它只是个目录名,与「域名是否对外服务」无关;
- 若要连目录一起改名(如挪到 `/www/wwwroot/oms.gztbyc.com/api`),必须同时改
`deploy.config.local.cjs` 的 `deployRoot`、`.env` 的 `UPLOAD_DIR`、以及扩展配置里 `include` 的 upstream 路径,
改完发一版验证;
- 旧版前端产物(`VITE_API_BASE_URL` 写死 `https://api.oms.gztbyc.com/api` 的版本)在该域名下线后
会整体失效,等用户缓存过期或被强制刷新即可。
### 数据库迁移
@ -272,13 +273,13 @@ v1/v2 共用)、可选 `OMS_CALLBACK_BASE_URL`。
| `/api/` | 反代到 egg(`include nginx-upstream.conf`,发布脚本切换 v1/v2 端口) |
- 前端构建期 `VITE_API_BASE_URL=/api`(`frontend/.env.production`)→ 浏览器请求始终同源
- 同源后**不再需要 CORS**;`backend/app/middleware/cors.js` 保留以便老域名/其他站点访问,
需要收紧时可把后端 `CORS_ORIGINS` 设为空或只留必要来源
- 同源后**不需要 CORS**:`backend/app/middleware/cors.js` 默认只放行本地开发 `localhost:5173`,
需要时用后端 `CORS_ORIGINS` 覆盖
- 后端返回的图片/头像地址仍是相对路径(`/api/files/raw/...`),同源下
`frontend/src/utils/media.ts` 的 `mediaUrl()` 原样使用
- 后端切换 v1/v2 端口只需改写 `nginx-upstream.conf` 并 reload,**前端产物无需重新构建**
- `api.oms.gztbyc.com` 现在只作为可选别名(外部回调、调试直连),指向同一后端即可;
若不再使用可下线该站点
- `api.oms.gztbyc.com` 已下线,后端只经本站点访问;发布目录仍沿用
`/www/wwwroot/api.oms.gztbyc.com/`(纯目录名,见上一节「旧域名的处置」)
- 站点改用 HTTPS 时,反向代理已带 `X-Forwarded-Proto`,前端构建产物无需改动
> 开发环境同理:`VITE_API_BASE_URL=/api` + vite dev server 把 `/api` 代理到 `http://localhost:6090`,

View File

@ -18,7 +18,9 @@
*
* Nginx 前置(仅首次,单站点 oms.gztbyc.com):
* 站点根目录指向 <basePath>/current(前端静态),`location /` 用 try_files 回退 index.html;
* `location /api/` 里 `include /www/wwwroot/api.oms.gztbyc.com/nginx-upstream.conf;`
* `location /api/` 与 `location = /openapi` 里
* `include /www/wwwroot/api.oms.gztbyc.com/nginx-upstream.conf;`
* (该路径只是后端发布目录,与 api.oms.gztbyc.com 域名是否对外服务无关)
* (该文件内容为 `proxy_pass http://127.0.0.1:<端口>;`,由发布脚本切换 v1/v2 端口)。
* 完整示例见 tools/DEPLOY.md。
*/

View File

@ -34,7 +34,8 @@ SMTP_PASS=
SMTP_FROM=
# ---- 对外回调地址(可选)----
OMS_CALLBACK_BASE_URL=http://api.oms.gztbyc.com
# 外部系统回推 /openapi 时展示/使用的地址;单站点部署下与前端同源
OMS_CALLBACK_BASE_URL=https://oms.gztbyc.com
# ---- 微信登录网关(公众号扫码登录 / 扫码绑定,可选)----
# 网关管理台单独创建「生产环境」应用后下发;通知地址固定为 https://{生产域名}/api/wx/notify