fix(admin): 管理端入口收敛到 /admin/ 子路径，staging 端口 13521，修复生产 /admin/ 假成功
承接 rc.15 的管理端端口收敛（3000 → 13520），本轮把「入口」也收敛到一处： - staging admin 发布端口 3001 → 13521（保持「生产 + 1」错开），同步 tests/uat/run-uat.sh 的默认 UAT_ADMIN_URL。 - 管理端产物改为 /admin/ 子路径部署：vite 构建 base=/admin/（dev 仍为 /，开发与 排查习惯不变）、router history base 跟随 import.meta.env.BASE_URL、三处容器化 入口（生产 nginx / 本地整套栈 nginx / admin-web 容器内 nginx）统一为「不剥离 前缀」转发，形态一致。 - 修复生产 nginx /admin/ 的假成功：原为 alias /usr/share/nginx/html/，而那正是 nginx:alpine 纯净镜像自带的默认页目录（管理端产物不在该容器内），访问返回 200 + nginx 欢迎页 —— 浏览器不报错、状态码正常，只是打开的不是管理端，比 404 更难发现。改为 upstream admin_web + proxy_pass，并以真实两跳容器实测： /admin/ → 200 且为管理端标题与 /admin/assets/*、/admin/dashboard → 200（SPA 兜底）、/admin/brand/logo-mark.png → 200、根路径 → 显式 404（用 location = / 钉住，不依赖「本配置恰好没有 server 级 root」这一偶然事实）。 - 品牌资源引用统一走新增的 src/brand.ts（public/ 资源不受 vite base 影响，原 5 处 写死根路径，子路径部署下会裂图）；favicon 由仓库内并不存在的 /favicon.svg 改为 存在的品牌标。 - 补全 tests/uat/run-uat.sh 被截断的尾部：原文件停在 `if [ -`，bash -n 不通过、 脚本根本无法运行；顺带把此前「定义了却无人消费」的 ADMIN_URL 接到管理端可达性 实测上，并补结果汇总与非零退出码。 - ui-tests：ui-document-baseline-contracts 新增两类一致性断言（staging 发布端口 ⇄ run-uat.sh 默认入口、子路径部署的五处约束）；admin-reference-contracts 的资产 断言适配 brand 模块（断言「组件经 brand 模块引用」+「brand 模块指向正式资产」）。 6 条新增断言全部经负向注入验证（注入对应缺陷 → 守卫变红且信息指向正确对象）。 验证：UI 门控 14/14 绿；vue-tsc EXIT=0；vite build EXIT=0 且产物资源均为 /admin/ 前缀；三份 nginx 配置 nginx -t 通过。 注：docs/STATUS.md 含此前的在途文档改动（非本次工作，且其中引用了已被删除的 plans 文件），故未纳入本提交；本轮的口径更新已写入该文件待一并处理。
This commit is contained in:
WorkBuddy
@@ -87,7 +87,13 @@ services:
|
||||
depends_on:
|
||||
- backend
|
||||
ports:
|
||||
- "3001:80"
|
||||
# staging 与生产同机共存，全部端口按「生产 + 1」错开（5433/6380/8081/13521）。
|
||||
# 生产管理端为 13520（admin-web/vite.config.ts + docker-compose.prod.yml），
|
||||
# 故此处为 13521 —— 与 tests/uat/run-uat.sh 的 UAT_ADMIN_URL 默认值一致，
|
||||
# 两处均由 ui-tests/ui-document-baseline-contracts.mjs 钉住。
|
||||
# 管理端构建产物部署在 /admin/ 子路径下（见 admin-web/vite.config.ts 的 base），
|
||||
# 故直连访问地址为 http://localhost:13521/admin/ 。
|
||||
- "13521:80"
|
||||
|
||||
volumes:
|
||||
postgres_staging_data:
|
||||
|
||||
@@ -46,6 +46,12 @@ http {
|
||||
server backend:8080;
|
||||
}
|
||||
|
||||
# 管理端容器（同一 danyang-net 网络，服务名 admin-web —— 见 docker-compose.prod.yml）。
|
||||
# 本容器是 nginx:alpine 纯净镜像，自身不含管理端产物，只能靠代理取。
|
||||
upstream admin_web {
|
||||
server admin-web:80;
|
||||
}
|
||||
|
||||
# HTTP -> HTTPS redirect (uncomment for production)
|
||||
# server {
|
||||
# listen 80;
|
||||
@@ -79,6 +85,15 @@ http {
|
||||
return 503 '<h1>系统维护中</h1><p>请稍后再访问。</p>';
|
||||
}
|
||||
|
||||
# 根路径没有内容（管理端在 /admin/ 下，小程序走 /api/）。
|
||||
# 显式 404：当前之所以是 404，只是因为本配置没有 server 级 root，
|
||||
# 而 nginx 默认的 html 目录（/etc/nginx/html）不存在 —— 属偶然事实。
|
||||
# 一旦有人为了别的用途补上 root，根路径就会开始返回那个目录下的内容。
|
||||
# 用精确匹配钉住这一行为，且不影响其它未匹配路径的既有处理。
|
||||
location = / {
|
||||
return 404;
|
||||
}
|
||||
|
||||
# Health checks (no auth needed)
|
||||
location = /api/v1/health/live {
|
||||
proxy_pass http://backend;
|
||||
@@ -93,10 +108,30 @@ http {
|
||||
proxy_set_header Host $host;
|
||||
}
|
||||
|
||||
# Admin Web (SPA)
|
||||
# Admin Web (SPA) —— 子路径部署在 /admin/ 下（构建 base=/admin/，见 admin-web/vite.config.ts）。
|
||||
#
|
||||
# 2026-09-18 修正：此处原为 `alias /usr/share/nginx/html/;`，而本容器是 nginx:alpine
|
||||
# 纯净镜像 —— 那个目录里只有镜像自带的欢迎页，并没有管理端产物。结果是访问 /admin/
|
||||
# 返回 200 + nginx 欢迎页，属于"假成功"，比 404 更难被发现（页面能打开，但不是管理端）。
|
||||
# 真正的产物在 admin-web 容器内，故改为代理到 upstream。
|
||||
#
|
||||
# 代理**不剥离** /admin 前缀：管理端构建 base 为 /admin/，其 index.html 引用的资源
|
||||
# 本身就以 /admin/ 开头，由 admin-web 容器内的 nginx（admin-web/nginx-admin.conf）
|
||||
# 统一处理这个前缀，三处入口（生产 / 本地整套栈 / staging 直连）因此形态一致。
|
||||
#
|
||||
# 暴露面提醒：管理端登录页不应无条件对公网开放。当前依赖外层防火墙/WAF 控制；
|
||||
# 若需在 nginx 层收敛，在此 location 内加 allow/deny 白名单（运营办公网段 + VPN）。
|
||||
location = /admin {
|
||||
return 301 /admin/;
|
||||
}
|
||||
location /admin/ {
|
||||
alias /usr/share/nginx/html/;
|
||||
try_files $uri $uri/ /admin/index.html;
|
||||
# 只写 upstream 名，不写端口：upstream 块里已声明 `server admin-web:80;`，
|
||||
# 此处再带 :80 会让 nginx 报 `upstream "admin_web" may not have port 80` 而拒绝启动。
|
||||
proxy_pass http://admin_web;
|
||||
proxy_set_header Host $host;
|
||||
proxy_set_header X-Real-IP $remote_addr;
|
||||
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
|
||||
proxy_set_header X-Forwarded-Proto $scheme;
|
||||
}
|
||||
|
||||
# API proxy
|
||||
|
||||
@@ -90,13 +90,25 @@ http {
|
||||
proxy_set_header X-Forwarded-Proto $scheme;
|
||||
}
|
||||
|
||||
# Admin web
|
||||
location / {
|
||||
# Admin web —— 管理端产物挂在 /admin/ 子路径下（构建 base=/admin/，
|
||||
# 见 admin-web/vite.config.ts）。与生产 nginx 保持同一形态：**不剥离**前缀地
|
||||
# 转发给 admin-web 容器，由容器内的 nginx（admin-web/nginx-admin.conf）
|
||||
# 统一处理 /admin/ 前缀。三处入口（生产 / 本地整套栈 / staging 直连）因此一致。
|
||||
location = /admin {
|
||||
return 301 /admin/;
|
||||
}
|
||||
location /admin/ {
|
||||
proxy_pass http://admin_web;
|
||||
proxy_set_header Host $host;
|
||||
proxy_set_header X-Real-IP $remote_addr;
|
||||
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
|
||||
proxy_set_header X-Forwarded-Proto $scheme;
|
||||
}
|
||||
|
||||
# 其余未匹配路径（不含 /admin、/api、/ws）统一跳转到管理端入口。
|
||||
# 根路径没有内容，显式跳转以避免"打根路径拿到一个空白/错页"的假成功。
|
||||
location / {
|
||||
return 301 /admin/;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user