chore(deploy): 前后端发布目录统一到 oms.gztbyc.com 站点下

- 后端 deployRoot 改为 /www/wwwroot/oms.gztbyc.com/api(前端 releases/current 的兄弟目录),
  UPLOAD_DIR 同步为 .../api/uploads,nginx 扩展配置的 include 指向新 upstream
- 工具默认值与示例配置、DEPLOY.md 目录结构与示例路径一并更新
- 旧目录 /www/wwwroot/api.oms.gztbyc.com/ 迁移后可直接删除

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
This commit is contained in:
liufumingren 2026-11-01 23:46:39 +08:00
parent ed98349ea2
commit e064cb6f24
5 changed files with 35 additions and 28 deletions

View File

@ -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 动态生成

View File

@ -120,13 +120,20 @@ module.exports = {
## 后端发布(双实例蓝绿)
前后端统一放在站点目录下,后端发布目录是 `<basePath>/api`(即 `/www/wwwroot/oms.gztbyc.com/api`),
与前端 `releases/`、`current` 并列,互不干扰:
```
<deployRoot>/
├─ 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`(外部系统回调)访问。
该域名的站点配置已移除(原配置备份在 `<deployRoot>/.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`,

View File

@ -19,8 +19,7 @@
* Nginx 前置(仅首次,单站点 oms.gztbyc.com):
* 站点根目录指向 <basePath>/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',
// 前后端统一放在站点目录下:前端 <basePath>/releases + current,后端 <basePath>/api
deployRoot: '/www/wwwroot/oms.gztbyc.com/api',
// 双实例端口;nginx-upstream.conf 指向当前活跃版本的端口
ports: { v1: 6090, v2: 6091 },

View File

@ -8,7 +8,7 @@
# 注意:服务器上 shared-config/.env 首次会从老位置的 <deployRoot>/.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=

View File

@ -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),