Golang怎么用Gin实现IP白名单限制_Golang如何在中间件中过滤非法来源IP地址【操作】-Golang-PHP中文网

在 gin 中间件中判断请求 ip 是否合法需先配置 engine.forwardedbyclientip = true，再解析 x-real-ip 或 x-forwarded-for 获取真实 ip，然后用封装的 ipwhitelist 中间件支持 cidr 和单 ip 校验。

golang怎么用gin实现ip白名单限制_golang如何在中间件中过滤非法来源ip地址【操作】

怎么在 Gin 中间件里判断请求 IP 是否合法

Gin 本身不直接暴露真实客户端 IP，ctx.ClientIP() 返回的可能是反向代理后的地址，直接用它做白名单会失效。必须先确认你的服务是否在 Nginx、Cloudflare 等代理后面——绝大多数生产环境都是。

实操建议：

如果用了反向代理，确保 Nginx 配置了 proxy_set_header X-Real-IP $remote_addr; 和 proxy_set_header X-Forwarded-For $remote_addr;
在 Gin 启动时调用 engine.ForwardedByClientIP = true，否则 ctx.ClientIP() 不会解析 X-Forwarded-For
白名单检查应放在中间件最前面，避免后续逻辑误执行

写一个可复用的 IP 白名单中间件函数

别每次都在路由里手写 if 判断，封装成中间件才符合 Gin 的设计习惯。关键点是：支持 CIDR（如 192.168.1.0/24），支持 IPv4 和 IPv6，且不依赖外部包。

示例逻辑（精简版）：

func IPWhitelist(ips ...string) gin.HandlerFunc {
    parsed := make([]*net.IPNet, 0, len(ips))
    for _, ip := range ips {
        if _, net, err := net.ParseCIDR(ip); err == nil {
            parsed = append(parsed, net)
        } else if ipAddr := net.ParseIP(ip); ipAddr != nil {
            // 单 IP 转成 /32 或 /128
            mask := net.CIDRMask(32, 32)
            if ipAddr.To4() == nil {
                mask = net.CIDRMask(128, 128)
            }
            parsed = append(parsed, &net.IPNet{IP: ipAddr, Mask: mask})
        }
    }
    return func(c *gin.Context) {
        realIP := c.ClientIP()
        ip := net.ParseIP(realIP)
        if ip == nil {
            c.AbortWithStatusJSON(http.StatusForbidden, gin.H{"error": "invalid ip"})
            return
        }
        allowed := false
        for _, net := range parsed {
            if net.Contains(ip) {
                allowed = true
                break
            }
        }
        if !allowed {
            c.AbortWithStatus(http.StatusForbidden)
            return
        }
        c.Next()
    }
}

使用：r.Use(IPWhitelist("127.0.0.1", "192.168.0.0/16"))

为什么 `c.ClientIP()` 有时返回 127.0.0.1 或 ::1

这是最常见的坑：本地开发时用 curl http://localhost:8080，或测试时没走代理，c.ClientIP() 就会退化为 c.Request.RemoteAddr 解析结果，也就是本机回环地址。

Golang Spf13 Viper

Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。

下载

排查步骤：

打印 c.Request.Header.Get("X-Forwarded-For") 和 c.Request.Header.Get("X-Real-IP")，看是否有值
检查 engine.ForwardedByClientIP 是否设为 true（默认是 false）
确认没有多个 X-Forwarded-For 值被拼接（比如 Nginx 多次追加），c.ClientIP() 默认只取第一个

调试时可在中间件开头加：log.Printf("real-ip: %s, xff: %s, remote: %s", c.ClientIP(), c.Request.Header.Get("X-Forwarded-For"), c.Request.RemoteAddr)