whm/web
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

fix(nginx): 变量 proxy_pass 须 rewrite 去掉 /admin，否则静态资源回退 index.html

Browse Source 
Made-with: Cursor
This commit is contained in:
whm
2026-03-23 18:28:33 +08:00
parent 2c0898fffd
commit 78055dbe68
2 changed files with 5 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
deploy/README.md
View File

@@ -15,5 +15,5 @@
2. **确认 dist 完整**：`deploy/admin/dist/assets/` 下须有与 `index.html` 中 `<script type="module">` 引用**同名**的哈希文件；发版后应**整目录**替换 `dist`（勿只拷 `index.html`）。 2. **确认 dist 完整**：`deploy/admin/dist/assets/` 下须有与 `index.html` 中 `<script type="module">` 引用**同名**的哈希文件；发版后应**整目录**替换 `dist`（勿只拷 `index.html`）。
3. **本地重建**：在项目根按 `pull-and-restart.sh` 方式在 `admin/` 执行 `npm run build`，`vite.config` 中 `base` 须为 `'/admin/'`。 3. **本地重建**：在项目根按 `pull-and-restart.sh` 方式在 `admin/` 执行 `npm run build`，`vite.config` 中 `base` 须为 `'/admin/'`。
4. **勿用旧版 `nginx/admin.conf`**：若曾把仅含 `location /` 的旧配置拷到服务器，会导致 `/assets/*.js` 全部变成 `index.html`（约 640B、MIME 错）。请以 **`deploy/admin/default.conf`** 或 **`admin/nginx.conf`** 为准，并 **`docker compose restart admin nginx`**。 4. **勿用旧版 `nginx/admin.conf`**：若曾把仅含 `location /` 的旧配置拷到服务器，会导致 `/assets/*.js` 全部变成 `index.html`（约 640B、MIME 错）。请以 **`deploy/admin/default.conf`** 或 **`admin/nginx.conf`** 为准，并 **`docker compose restart admin nginx`**。
5. **若出现 500**：外层 `yuheng.docker.conf.tpl` 仅用 **`location /admin/`** 反代即可（勿对 `/admin/assets/` 再写 `rewrite` + 变量 `proxy_pass`，部分环境会 **500**）；白屏仍以 **内层** `deploy/admin/default.conf` 的 `^~ /assets/` 为准。 5. **变量 `proxy_pass` 与路径**：外层 `yh_nginx` 对 **`location /admin/`** 须 **`rewrite ^/admin/(.*)$ /$1 break`** 再 **`proxy_pass http://$upstream_admin:80`**（无 URI 后缀）。否则 Nginx 会把 **`/admin/assets/...` 原样**传到 admin，内层只认 **`/assets/...`** → 全部回退 `index.html`（网络面板里 JS/CSS 与 document 同几百字节）。**`/api/`** 不要用 rewrite（API 需要完整 `/api/...`）。
6. **`restart.sh` 构建 admin** 已与 **`pull-and-restart.sh` 一致**（挂载**项目根**到容器，否则 `@yh-web` 无法解析）。发版后脚本会执行 **`scripts/verify-admin-dist.sh`**：若 `index.html` 引用的 chunk 在 `dist/assets/` 中缺失或过小（几百字节），会直接报错退出，避免白屏上线。 6. **`restart.sh` 构建 admin** 已与 **`pull-and-restart.sh` 一致**（挂载**项目根**到容器，否则 `@yh-web` 无法解析）。发版后脚本会执行 **`scripts/verify-admin-dist.sh`**：若 `index.html` 引用的 chunk 在 `dist/assets/` 中缺失或过小（几百字节），会直接报错退出，避免白屏上线。

6
nginx/yuheng.docker.conf.tpl
View File

@@ -26,7 +26,8 @@ server {
add_header Cache-Control "no-store"; add_header Cache-Control "no-store";
} }
# /admin/ 由下方 location 处理；勿再单独 rewrite /admin/assets（rewrite+变量 proxy_pass 易 500） # 变量 proxy_pass 不会按普通规则去掉 location 前缀，会把完整 URI /admin/assets/... 传到上游 → 内层无法匹配 /assets/ → 全站 index.html 白屏
# 须先 rewrite 去掉 /admin，再反代（与 /api/ 不同：api 需要保留 /api 前缀）
location / { location / {
set $upstream_web web; set $upstream_web web;
proxy_pass http://$upstream_web:80; proxy_pass http://$upstream_web:80;
@@ -38,8 +39,9 @@ server {
} }
location /admin/ { location /admin/ {
rewrite ^/admin/(.*)$ /$1 break;
set $upstream_admin admin; set $upstream_admin admin;
proxy_pass http://$upstream_admin:80/; proxy_pass http://$upstream_admin:80;
proxy_http_version 1.1; proxy_http_version 1.1;
proxy_set_header Host $host; proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Real-IP $remote_addr;