fix: API 反代保留 /api 路径修复 404；admin 容器 location /；宿主机 Nginx 反代到 8443 说明

Made-with: Cursor

nginx/README.md

@@ -44,15 +44,17 @@ sudo systemctl reload nginx
 
 若 Nginx 使用其他路径（如 `sites-enabled`），请把上述 conf 放到对应目录并 `include` 到主配置。
 
-## 3. 路由对应关系
+## 3. 两种部署方式（二选一）
 
-| 访问路径 | 后端端口 | 说明 |
-|----------|----------|------|
-| `https://yuheng.yuxindazhineng.com/` | 9528 | 前台 |
-| `https://yuheng.yuxindazhineng.com/admin/` | 9529 | 管理后台 |
-| `https://yuheng.yuxindazhineng.com/api/` | 8088 | API |
+**方式 A：仅 compose 占 443（默认）**  
+- `docker-compose.yml` 中 nginx 映射 `443:443`，请求直接进 compose 内 Nginx，再反代到 api/web/admin。  
+- 宿主机**不要**为本站点单独起 Nginx（不要用本目录的 `yuheng.yuxindazhineng.com.conf` 占 443），否则会与 compose 抢 443 或反代到已废弃的 9528/9529/8088，导致 /api/、/admin/ 404。
 
-确保 `docker compose` 已启动，且本机 8088、9528、9529 已监听。
+**方式 B：宿主机 Nginx 占 443，反代到 compose**  
+- 若宿主机已有 Nginx 监听 443（多站点），则把 compose 中 nginx 端口改为 **8443:443**，宿主机用本目录的 `yuheng.yuxindazhineng.com.conf`（已配置为整站反代到 `127.0.0.1:8443`）。  
+- 复制 conf 到 `/etc/nginx/conf.d/` 后 `nginx -t && systemctl reload nginx`。
+
+**/api/health 或 /admin/ 返回 404 时**：在服务器执行 `ss -tlnp | grep 443`，看 443 是宿主机 nginx 还是 docker。若是宿主机 nginx，要么停用该站点配置让 compose 独占 443（方式 A），要么改为方式 B（compose 用 8443，宿主机反代到 8443）。
 
 ## 4. 新服务器首次安装 Nginx