1.反代主 App 域名
在 443 端口配 SSL 证书后,把 location / 反代到主 App(Docker 模式 http://127.0.0.1:80,裸机模式 http://127.0.0.1:5180)。关键三行:proxy_http_version 1.1、proxy_set_header Upgrade $http_upgrade、proxy_set_header Connection "upgrade"——/socket.io 的 WebSocket 升级缺一个就报 400。前端容器/模板已经会把 /api 转给后端,宿主机这层不需要再单独拆 API 路由。
2.更新两个 env 并重启 api
把新域名加进 api/.env 的 CORS_ALLOWED_ORIGINS(逗号分隔),并把 PUBLIC_API_BASE_URL 改成主 App 的公网根地址(如 https://app.your-domain.com,不带 /api)。改完重启 api 生效。
3.保护运维接口
/admin/* 与主 App 走同一个后端。若要从公网调用运维接口,建议额外加 IP 白名单或 Basic Auth,避免 ADMIN_SECRET 被暴力穷举;同时确认反代显式透传自定义头:proxy_set_header X-Admin-Secret $http_x_admin_secret;(部分代理默认过滤非标准头)。
排查:前台报 Failed to fetch
打开浏览器 devtools 的 Network 看请求:若 /api 请求返回了 text/html,是 nginx 没把 /api 转给后端、落进了 SPA 兜底;若是 CORS 报错,则 CORS_ALLOWED_ORIGINS 没包含你当前访问的域名。
排查:WebSocket 400
/socket.io/ 的 location 必须显式带 Upgrade / Connection 头,且 proxy_http_version 1.1——漏任何一个都会 400。多层反代时每一层都要带。
相关问题
隐界可以自部署吗?难不难?
可以,且难度等同跑一个普通 web 服务。如果你用过 docker compose,三步即可拥有自己的实例:克隆仓库、复制 .env、docker compose up。API、前端、数据库、向量索引全部跑在你自己的机器上。