优化客服云权限安全与访客IP解析

2026-08-31 13:43:45 +08:00
parent 523a306d5e
commit bdf67395ab
24 changed files with 365 additions and 48 deletions
@@ -155,6 +155,12 @@ STORAGE_PUBLIC_BASE_URL=https://kefu.example.com/files

 ## HTTPS 其它方式

+### 访客 IP 显示说明
+
+本地通过 Docker 网桥访问时，访客 IP 可能显示为 `172.19.0.1`；直接在本机开发服务访问时则常见为 `127.0.0.1` 或 `::1`，这两种都表示本地回环/网桥地址，不是公网 IP。
+
+生产链路由 Caddy → 应用 Nginx → API 时，API 优先读取 `X-Forwarded-For` 最左侧地址，`X-Real-IP` 仅作为回退，因此外部访客会显示其公网地址。请保持示例反代配置中的 `X-Forwarded-For` 转发，不要在边缘代理处清空该请求头。
+
 任选其一（与上一节「Caddy 共存」二选一即可）：

 1. **CLB / CDN** 终结 HTTPS，回源 CVM `HTTP_PORT`（或仍回源 Caddy）