diff --git a/backend/env.production.example b/backend/env.production.example index b63fc0f..085ea3d 100644 --- a/backend/env.production.example +++ b/backend/env.production.example @@ -1,7 +1,8 @@ # OMS 后端生产环境变量模板(此文件提交 git,供服务器上创建真实 .env 用;真实 .env 不入库) # -# 服务器上的真实文件位置:/www/wwwroot/api.oms.gztbyc.com/.env -# cp env.production.example /www/wwwroot/api.oms.gztbyc.com/.env && vim /www/wwwroot/api.oms.gztbyc.com/.env +# 服务器上的真实文件位置:/www/wwwroot/oms.gztbyc.com/api/shared-config/.env +# cp env.production.example /www/wwwroot/oms.gztbyc.com/api/shared-config/.env && vim ... +# (通常不用手工建:本地 tools/config/env.production.local 发布时会自动传上去) # 各版本目录(v1 / v2)下必须各有一份 .env:config.default.js 的 dotenv 只读「进程工作目录」下的 .env, # 而实例的工作目录就是各自的版本目录。发布脚本会在目标版本目录缺少 .env 时自动从 deployRoot/.env 复制一份 # (已存在则不覆盖,便于个别版本目录单独调整)。 @@ -29,7 +30,7 @@ JWT_RENEW_THRESHOLD=1800 # —— 上传文件目录(必填)—— # 必须放在 deployRoot 下、版本目录之外,v1 / v2 才能共用同一份上传文件 -UPLOAD_DIR=/www/wwwroot/api.oms.gztbyc.com/uploads +UPLOAD_DIR=/www/wwwroot/oms.gztbyc.com/api/uploads # —— 对外回调地址(可选)—— # 外部系统(WMS 等)回推 /openapi 时展示/使用的地址;不配则按请求 Host 动态生成 diff --git a/tools/DEPLOY.md b/tools/DEPLOY.md index 9178a9b..1e42576 100644 --- a/tools/DEPLOY.md +++ b/tools/DEPLOY.md @@ -120,13 +120,20 @@ module.exports = { ## 后端发布(双实例蓝绿) +前后端统一放在站点目录下,后端发布目录是 `/api`(即 `/www/wwwroot/oms.gztbyc.com/api`), +与前端 `releases/`、`current` 并列,互不干扰: + ``` -/ -├─ v1/ v2/ # 两套代码目录,每次发布交替部署另一套 -├─ current.md # 当前活跃版本(v1 / v2) -├─ nginx-upstream.conf # proxy_pass http://127.0.0.1:<端口>; -├─ shared-config/ # 共享配置(见上) -└─ .deploy/ # incoming 上传包、backups 备份、state 版本记录、logs 启动日志 +/www/wwwroot/oms.gztbyc.com/ +├─ current -> releases/<版本>/ # 前端站点根目录(Nginx root 指向它) +├─ releases/ # 前端历史版本(保留 keepReleases 个) +└─ api/ # 后端发布目录(deployRoot) + ├─ v1/ v2/ # 两套代码目录,每次发布交替部署另一套 + ├─ current.md # 当前活跃版本(v1 / v2) + ├─ nginx-upstream.conf # proxy_pass http://127.0.0.1:<端口>; + ├─ shared-config/ # 共享配置(见上) + ├─ uploads/ # 上传文件(版本目录之外,v1/v2 共用) + └─ .deploy/ # incoming 上传包、backups 备份、state 版本记录、logs 启动日志 ``` 单次远程序列:确定空闲槽位 → 释放端口 → 备份旧槽位 → 清理代码(保留 `sharedDirs`)→ 解压 @@ -156,7 +163,7 @@ server { # 后端:所有接口都在 /api 下;upstream 文件由发布脚本改写(v1/v2 交替), # 文件内容即 `proxy_pass http://127.0.0.1:<端口>;` location /api/ { - include /www/wwwroot/api.oms.gztbyc.com/nginx-upstream.conf; + include /www/wwwroot/oms.gztbyc.com/api/nginx-upstream.conf; proxy_http_version 1.1; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; @@ -169,7 +176,7 @@ server { # 外部系统(WMS 等)回推入口:路径与后端 router 的 /openapi 一致, # OMS_CALLBACK_BASE_URL 应配成本站点域名,拼出来的回调地址即 https://<站点域名>/openapi location = /openapi { - include /www/wwwroot/api.oms.gztbyc.com/nginx-upstream.conf; + include /www/wwwroot/oms.gztbyc.com/api/nginx-upstream.conf; proxy_http_version 1.1; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; @@ -193,18 +200,17 @@ 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`(外部系统回调)访问。 -该域名的站点配置已移除(原配置备份在 `/.deploy/backup-vhost/`),`OMS_CALLBACK_BASE_URL` -已指向站点域名,域名解析(DNS)可以一并删掉。 +该域名的站点配置已移除(原配置备份在 `/www/wwwroot/oms.gztbyc.com/api/.deploy/backup-vhost/`), +发布目录也已从 `/www/wwwroot/api.oms.gztbyc.com/` 迁到 `/www/wwwroot/oms.gztbyc.com/api/`, +`OMS_CALLBACK_BASE_URL` 指向站点域名,域名解析(DNS)可以一并删掉。 -- **目录 `/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 路径, - 改完发一版验证; +- 迁移涉及的三处配置必须一起改,缺一处就会发布失败或 404: + `deploy.config.local.cjs` 的 `deployRoot`、`.env` 的 `UPLOAD_DIR`、站点扩展配置里 `include` 的 upstream 路径; +- 旧目录 `/www/wwwroot/api.oms.gztbyc.com/` 迁完只剩宝塔留下的 `.env`/`releases`/`proxy_cache_dir`, + 确认新目录跑通后可以直接删; - 旧版前端产物(`VITE_API_BASE_URL` 写死 `https://api.oms.gztbyc.com/api` 的版本)在该域名下线后 会整体失效,等用户缓存过期或被强制刷新即可。 @@ -217,7 +223,7 @@ server { 2. 发布后到**当前活跃版本目录**手动执行: ```bash -cd /www/wwwroot/api.oms.gztbyc.com/v1 # 版本看 current.md +cd /www/wwwroot/oms.gztbyc.com/api/v2 # 版本看 current.md npm install --no-save sequelize-cli@6.6.5 # 生产依赖是 npm install --production,不含 sequelize-cli node_modules/.bin/sequelize-cli db:migrate npm prune --omit=dev --no-audit --no-fund # 跑完清掉临时装的开发依赖 @@ -278,8 +284,8 @@ v1/v2 共用)、可选 `OMS_CALLBACK_BASE_URL`。 - 后端返回的图片/头像地址仍是相对路径(`/api/files/raw/...`),同源下 `frontend/src/utils/media.ts` 的 `mediaUrl()` 原样使用 - 后端切换 v1/v2 端口只需改写 `nginx-upstream.conf` 并 reload,**前端产物无需重新构建** -- `api.oms.gztbyc.com` 已下线,后端只经本站点访问;发布目录仍沿用 - `/www/wwwroot/api.oms.gztbyc.com/`(纯目录名,见上一节「旧域名的处置」) +- `api.oms.gztbyc.com` 已下线,前后端都放在 `/www/wwwroot/oms.gztbyc.com/` 下 + (前端 `releases/` + `current`,后端 `api/`) - 站点改用 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 e285ef2..6de4b29 100644 --- a/tools/config/deploy.config.example.cjs +++ b/tools/config/deploy.config.example.cjs @@ -19,8 +19,7 @@ * Nginx 前置(仅首次,单站点 oms.gztbyc.com): * 站点根目录指向 /current(前端静态),`location /` 用 try_files 回退 index.html; * `location /api/` 与 `location = /openapi` 里 - * `include /www/wwwroot/api.oms.gztbyc.com/nginx-upstream.conf;` - * (该路径只是后端发布目录,与 api.oms.gztbyc.com 域名是否对外服务无关) + * `include /www/wwwroot/oms.gztbyc.com/api/nginx-upstream.conf;` * (该文件内容为 `proxy_pass http://127.0.0.1:<端口>;`,由发布脚本切换 v1/v2 端口)。 * 完整示例见 tools/DEPLOY.md。 */ @@ -43,7 +42,8 @@ module.exports = { // ==================== 后端(Egg 双实例蓝绿)==================== backend: { - deployRoot: '/www/wwwroot/api.oms.gztbyc.com', + // 前后端统一放在站点目录下:前端 /releases + current,后端 /api + deployRoot: '/www/wwwroot/oms.gztbyc.com/api', // 双实例端口;nginx-upstream.conf 指向当前活跃版本的端口 ports: { v1: 6090, v2: 6091 }, diff --git a/tools/config/env.production.example b/tools/config/env.production.example index af11553..38ffa22 100644 --- a/tools/config/env.production.example +++ b/tools/config/env.production.example @@ -8,7 +8,7 @@ # 注意:服务器上 shared-config/.env 首次会从老位置的 /.env 自动初始化。 # ---- Egg 实例(端口由发布脚本注入 EGG_PORT,此处无需配置)---- -# UPLOAD_DIR=/www/wwwroot/api.oms.gztbyc.com/uploads +# UPLOAD_DIR=/www/wwwroot/oms.gztbyc.com/api/uploads # ---- MySQL ---- MYSQL_HOST= diff --git a/tools/src/lib/config.ts b/tools/src/lib/config.ts index bb73560..4e09ab1 100644 --- a/tools/src/lib/config.ts +++ b/tools/src/lib/config.ts @@ -131,7 +131,7 @@ function resolveFromRepo(value: string): string { } function normalizeBackend(raw: RawBackendConfig): BackendSection { - const deployRoot = String(raw.deployRoot || '/www/wwwroot/api.oms.gztbyc.com').replace(/\/+$/, ''); + const deployRoot = String(raw.deployRoot || '/www/wwwroot/oms.gztbyc.com/api').replace(/\/+$/, ''); const ports = { v1: Number((raw.ports && raw.ports.v1) ?? 6090), v2: Number((raw.ports && raw.ports.v2) ?? 6091),