HTTP 尝试获取 Client IP

HTTP 中获取 Client IP 相关策略需求, 在当下网络环境中多数只能提供建议作用. 更多的是

通过其它唯一标识来挖掘更多潜在价值.

本文主要就一个内容, 如何最大可能尝试在 HTTP 请求中获取 Client IP.

首先我们要大致了解些先验知识.

1. HTTP header key 不区分大小写

https://www.w3.org/Protocols/rfc2616/rfc2616-sec4.html#sec4.2

2. X-Forwarded-For 是 HTTP 代理事实标准

https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Headers/X-Forwarded-For

X-Forwarded-For: <client ip>, <proxy1 ip>, <proxy2 ip> 

3. 大部分网关使用的是 nginx

http {
    # 下面三行为重点, 添加后就可以获取到客户端真实 IP
    set_real_ip_from 0.0.0.0/0;
    real_ip_header X-Forwarded-For;
    real_ip_recursive on;

    # 下面三行为常见反向代理传递真实客户端 IP 的配置
    # 配置在 http{} 中, 则全局应用在下面的所有 server 中
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}

https://amos-x.com/index.php/amos/archives/nginx-realip/

https://cloud.tencent.com/developer/article/1521273

基于上面信息, 我们在项目中开始构建脚手架方法

import (
    "fmt"
    "net"
    "net/http"
    "strings"
)

// X-Forwarded-For (XFF) 在客户端访问服务器的过程中如果需要经过 HTTP 代理或者负载均衡服务器,
// 可以被用来获取最初发起请求的客户端的 IP 地址, 这个消息首部成为事实上的标准.
var xForwardedForKeys = [...]string{"X-Forwarded-For", "x-forwarded-for", "X-FORWARDED-FOR"}

// XRealIP nginx 反向代理服务 IP
var xRealIPKeys = [...]string{"X-Real-IP", "X-Real-Ip", "x-real-ip", "X-REAL-IP"}

// GetClientIP 获取客户端 ip
func GetClientIP(r *http.Request) (ip string) {
    // X-Forwarded-For: <client>, <proxy1>, <proxy2>
    for _, xForwardedForKey := range xForwardedForKeys {
        xForwardedFor := strings.TrimSpace(r.Header.Get(xForwardedForKey))
        if len(xForwardedFor) > 0 {
            xForwardedFors := strings.Split(xForwardedFor, ",")
            ip = strings.TrimSpace(xForwardedFors[0])
            if len(ip) > 0 {
                return
            }
            break
        }
    }

    for _, xRealIPKey := range xRealIPKeys {
        ip = strings.TrimSpace(r.Header.Get(xRealIPKey))
        if len(ip) > 0 {
            return
        }
    }

    // 兜底直接使用 client 请求的 ip 地址
    ip, _, _ = net.SplitHostPort(r.RemoteAddr)
    return
}