diff --git a/backend/env.production.example b/backend/env.production.example index d65bae2..b63fc0f 100644 --- a/backend/env.production.example +++ b/backend/env.production.example @@ -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 diff --git a/frontend/env.d.ts b/frontend/env.d.ts index 6d47cd3..4c099c3 100644 --- a/frontend/env.d.ts +++ b/frontend/env.d.ts @@ -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 } diff --git a/frontend/src/utils/media.ts b/frontend/src/utils/media.ts index 2214615..fdbf25f 100644 --- a/frontend/src/utils/media.ts +++ b/frontend/src/utils/media.ts @@ -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 代理),原样返回。 * 注意:只在「渲染」时使用,写回接口的字段仍要保存后端原始值。 diff --git a/tools/DEPLOY.md b/tools/DEPLOY.md index a6af882..9178a9b 100644 --- a/tools/DEPLOY.md +++ b/tools/DEPLOY.md @@ -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`(外部系统回调)访问。 +该域名的站点配置已移除(原配置备份在 `/.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`, diff --git a/tools/config/deploy.config.example.cjs b/tools/config/deploy.config.example.cjs index 09fb8b2..e285ef2 100644 --- a/tools/config/deploy.config.example.cjs +++ b/tools/config/deploy.config.example.cjs @@ -18,7 +18,9 @@ * * Nginx 前置(仅首次,单站点 oms.gztbyc.com): * 站点根目录指向 /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。 */ diff --git a/tools/config/env.production.example b/tools/config/env.production.example index 3696f4c..af11553 100644 --- a/tools/config/env.production.example +++ b/tools/config/env.production.example @@ -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