fix(auth): Caddy 显式写入 X-Forwarded-For + uvicorn 信任 docker 网络

根因(在 smoke test 中定位):
- Caddy reverse_proxy 默认会覆盖客户端的 X-Forwarded-For 头,
  写入它自己识别的 client IP(防伪造)
- uvicorn --forwarded-allow-ips 默认只信任 127.0.0.1,
  docker 网络 172.18.0.x 不在白名单
- 结果: api 端读 X-Forwarded-For 时,看到的是 Caddy 替换后的值
  (Caddy 识别的真实 client IP),不是客户端伪造的值 — 这其实是正确的!
  但 uvicorn 不会用这个值更新 client scope

修法:
- Caddyfile: header_up X-Forwarded-For {remote_host}
  显式让 Caddy 把自己识别的 client IP 写入 X-Forwarded-For
- docker-compose api command: 加 --forwarded-allow-ips 172.18.0.0/16
  信任 docker 网络(让 uvicorn 采用 X-Forwarded-For 的值)
- api 端 get_client_ip 不变,读 X-Forwarded-For 拿真实 client IP

效果: X-Forwarded-For 在代理链中始终代表真实 client IP,
不再被任何中间件覆盖或丢弃
This commit is contained in:
xiaji
2026-06-13 19:47:11 +08:00
parent 0d5f29fd37
commit d1bf5ea2df
2 changed files with 9 additions and 3 deletions

View File

@@ -13,9 +13,13 @@
http://{$DOMAIN:NEWS_DOMAIN_FALLBACK} {
# /api/* 直接转发,保留路径(后端 FastAPI 路由就是 /api/v1/*)
reverse_proxy /api/* api:8000
reverse_proxy /api/* api:8000 {
# 把 Caddy 识别的 client IP 写入 X-Forwarded-For(覆盖任何客户端伪造)
# 后端 uvicorn --forwarded-allow-ips 信任 docker 网络后会用这个值
header_up X-Forwarded-For {remote_host}
}
# 其余走前SPA
# 其余走前<EFBFBD>?SPA
reverse_proxy /* frontend:80
encode gzip zstd

View File

@@ -61,7 +61,9 @@ services:
- ./backend/app:/app/app
- ./backend/alembic:/app/alembic
- ./backend/alembic.ini:/app/alembic.ini
command: ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8000"]
# --forwarded-allow-ips 信任 docker 网络(让 Caddy 写入的 X-Forwarded-For 被采用)
# 生产部署可改成 Caddy 容器的具体 IP(动态 IP 用子网)
command: ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8000", "--forwarded-allow-ips", "172.18.0.0/16"]
logging:
driver: json-file
options: