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:
parent
3404543418
commit
ed98349ea2
@ -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
2
frontend/env.d.ts
vendored
@ -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
|
||||
}
|
||||
|
||||
|
||||
@ -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 代理),原样返回。
|
||||
* 注意:只在「渲染」时使用,写回接口的字段仍要保存后端原始值。
|
||||
|
||||
@ -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`,
|
||||
|
||||
@ -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。
|
||||
*/
|
||||
|
||||
@ -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
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user