GEOFlow 子域名与子目录怎么部署？反向代理配置要点

GEOFlow 可通过反向代理映射到子域名或一级目录。子域名只需转发 Web 服务；子目录还需传递路径前缀并校准 APP_URL。

子域名部署：直接转发到 GEOFlow Web

把 GEOFlow 放在一个独立子域名下，例如 https://geo.example.com，反向代理只需要将请求转发到容器的 Web 服务端口。 GEOFlow Docker 默认 Web 映射端口是 18080，因此典型的目标地址为 http://geoflow-app:8080。部署时在 .env.prod 中设置：

APP_URL=https://geo.example.com

一级目录部署：让反向代理传递前缀

如果 GEOFlow 需要部署在某个路径下，比如 https://example.com/wiki，则必须让反向代理传递 X-Forwarded-Prefix 请求头。GEOFlow 会识别该头自动为路由加上 /wiki 前缀，同时保持后台路径不变。 关键点：不要在 ADMIN_BASE_PATH 中写入目录前缀。正确的配置仍然是：

APP_URL=https://example.com/wiki
ADMIN_BASE_PATH=geo_admin

Nginx 反向代理示例配置

一个典型的 Nginx 一级目录反代配置如下（子域名只需去掉 X-Forwarded-Prefix 那一行）：

location /wiki/ {
    proxy_pass http://geoflow-app:8080/;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-Prefix /wiki;
}

检查清单

部署完成后，按下面几条快速验证配置是否正确：

1. 访问首页和后台登录页，确认路径自动带上了一级目录前缀。
2. 检查浏览器开发者工具中的资源请求，CSS/JS 路径均基于 APP_URL 生成，无 404 错误。
3. 如果后台登录后出现跳转错误路径，通常是因为 APP_URL 未包含目录前缀，或者反向代理未传递 X-Forwarded-Prefix。

常见问题

Q：子目录部署后，首页能打开但后台样式错乱？ A：确认浏览器加载的静态资源路径中是否包含了目录前缀。缺失前缀往往是 X-Forwarded-Prefix 没有传递成功，或者 Nginx 的 proxy_pass 末尾缺少 /。 Q：APP_URL 已经配置了带前缀的地址，为什么后台依然无法登录？ A：先确认外部路径与 APP_URL 一致，再检查代理是否传递 X-Forwarded-Prefix；后台仍使用 ADMIN_BASE_PATH 指定的路径。