会，c.ClientIP() 默认返回代理内网IP而非真实出口IP，因未配置SetTrustedProxies导致X-Real-IP/X-Forwarded-For被忽略，最终fallback至不安全的RemoteAddr。
直接用 c.ClientIP() 会出错吗？
会，但不是函数本身错——而是多数情况下返回的是 Nginx 或负载均衡器的内网 IP（比如 127.0.0.1 或 10.0.0.2），不是用户真实出口 IP。这是因为 Gin 默认只读 RemoteAddr，而代理转发后这个字段就失效了。
为什么 c.ClientIP() 有时返回空或内网地址
c.ClientIP() 的行为依赖于请求头是否可信。它默认按顺序检查：X-Real-IP → X-Forwarded-For → RemoteAddr。但只有当这些头来自可信代理时，Gin 才会采用；否则直接 fallback 到不安全的 RemoteAddr。
- 没配 Nginx 透传头 →
X-Real-IP和X-Forwarded-For为空 → 最终取c.Request.RemoteAddr（通常是代理的 IP） - Nginx 配了
proxy_set_header X-Real-IP $remote_addr;，但没设TrustedProxies→ Gin 认为该头不可信，跳过 - 你用了云 WAF 或 SLB（如阿里云 CLB、腾讯云 CLB），它们可能用
X-Forwarded-For，也可能用自定义头（如X-Forwarded-For被污染、或用X-Forwarded-For多层嵌套）
必须配置 TrustedProxies 才能信任请求头
Gin 不会无条件相信 X-Real-IP 或 X-Forwarded-For，必须显式声明哪些 IP 是可信代理，否则一律忽略。这是防止伪造 IP 的关键安全机制。
常见配置方式：
- 若只有单层 Nginx（直连 Gin），在启动时加：
r.SetTrustedProxies([]string{"127.0.0.1", "::1"}) - 若 Nginx 在另一台机器（如
10.10.1.5），则写：r.SetTrustedProxies([]string{"10.10.1.5"}) - 若用云厂商 SLB，且 SLB IP 段固定（如阿里云华东1是
100.64.0.0/10），可填 CIDR：r.SetTrustedProxies([]string{"100.64.0.0/10"})（注意 Gin v1.9+ 支持 CIDR） - 完全禁用信任检查（仅测试用！不推荐）：
r.SetTrustedProxies(nil)，此时c.ClientIP()会无条件取X-Real-IP
⚠️ 忘记这步是线上拿不到真实 IP 的最常见原因。
模板里怎么安全输出 IP？别在 HTML 模板里调用 c.ClientIP()
Gin 的 HTML 模板（c.HTML()）运行在响应阶段，无法直接访问 *gin.Context 方法。必须提前把 IP 作为数据传入模板。
正确做法：
- 在 handler 中先调用
ip := c.ClientIP()（确保已设TrustedProxies） - 再传给模板：
c.HTML(http.StatusOK, "index.html", gin.H{"client_ip": ip}) - 模板中用
{{.client_ip}}渲染
错误示例（模板里不能这么写）：{{.ClientIP}} 或 {{$.ClientIP}} —— 模板没有上下文方法调用能力，会静默失败或报错。
额外提醒：如果业务需要做 IP 地理位置识别或风控，建议在中间件里统一提取并存到 c.Set("real_ip", ip)，后续 handler 和日志都复用，避免重复解析和逻辑分散。
