獲取請求 IP，nginx 配置方案，gin 框架，2024 版，go 語言

在使用 Gin 框架時，獲取用戶請求的真實 IP 地址涉及到多種情況，尤其在使用代理服務器（如 Nginx）時。

本文將詳細介紹如何使用 Gin 自帶方法和其他方式獲取用戶 IP，以及在面對 Nginx 轉發時如何準確獲取客戶端 IP，同時討論與 IP 相關的安全問題及處理方法。

第一章：概述

1.1 獲取用戶真實 IP 的重要性

獲取用戶的真實 IP 地址是許多應用中必不可少的功能，用於識別用戶、記錄日誌、進行安全控制等。

在使用 Gin 框架時，我們需要了解如何正確獲取用戶的 IP，並處理可能涉及的安全問題。

第二章：使用 Gin 自帶方法獲取 IP

2.1 使用 gin.Context 的 ClientIP 方法

Gin 框架提供了 gin.Context 對象的 ClientIP 方法，可直接獲取客戶端的 IP 地址。

// main.go
package main

import (
 "github.com/gin-gonic/gin"
 "net/http"
)

func getIP(c *gin.Context) {
 ip := c.ClientIP()
 c.JSON(http.StatusOK, gin.H{"ip": ip})
}

func main() {
 router := gin.Default()

 router.GET("/get-ip", getIP)

 router.Run(":8080")
}

第三章：其他方式獲取 IP

3.1 從 http.Request 中獲取

直接從 http.Request 對象中獲取客戶端 IP 地址，適用於非 Gin 框架的純 Go 應用。

// main.go
package main

import (
 "net/http"
 "strings"
)

func getIPFromRequest(w http.ResponseWriter, r *http.Request) {
 ip := r.RemoteAddr
 c.JSON(http.StatusOK, gin.H{"ip": ip})
}

func main() {
 http.HandleFunc("/get-ip", getIPFromRequest)
 http.ListenAndServe(":8080", nil)
}

3.2 使用 X-Real-IP 和 X-Forwarded-For 頭部

當應用部署在代理服務器（如 Nginx）後面時，這些服務器通常會添加 X-Real-IP 或 X-Forwarded-For 頭部，包含了真實的用戶 IP 地址。

// main.go
package main

import (
 "github.com/gin-gonic/gin"
 "net/http"
 "strings"
)

func getIPWithProxyHeaders(c *gin.Context) {
 // 嘗試從 X-Real-IP 頭部獲取真實 IP
 ip := c.GetHeader("X-Real-IP")

 // 如果 X-Real-IP 頭部不存在，則嘗試從 X-Forwarded-For 頭部獲取
 if ip == "" {
  ip = c.GetHeader("X-Forwarded-For")
 }

 // 如果兩者都不存在，則使用默認的 ClientIP 方法獲取 IP
 if ip == "" {
  ip = c.ClientIP()
 }

 c.JSON(http.StatusOK, gin.H{"ip": ip})
}

func main() {
 router := gin.Default()

 router.GET("/get-ip", getIPWithProxyHeaders)

 router.Run(":8080")
}

3.3 Nginx 轉發配置

當應用部署在 Nginx 後面時，需要配置 Nginx 以確保正確傳遞用戶 IP 地址。

# Nginx 配置文件中添加配置
server {
    listen 80;
    server_name your-server-name;

    location / {
        proxy_pass <http://your-gin-app-upstream>;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

第四章：安全問題及處理方法

4.1 防範 IP 欺騙攻擊

問題描述： 攻擊者可能僞造請求，冒充其他 IP 地址。

處理方法： 使用防火牆等措施，確保只有可信任的 IP 地址能夠訪問應用。

4.2 防範代理頭欺騙

問題描述： 攻擊者可能僞造代理頭，發送虛假 IP。

處理方法： 在代碼中僅信任可靠的代理頭，並在獲取 IP 前進行相應的驗證。

// main.go
package main

import (
 "github.com/gin-gonic/gin"
 "net/http"
 "strings"
)

func getIPWithValidatedProxyHeaders(c *gin.Context) {
 // 獲取代理頭部
 proxyHeaders := c.Request.Header.Get("X-Real-IP,X-Forwarded-For")

 // 分割代理頭部，取第一個 IP 作爲真實 IP
 ips := strings.Split(proxyHeaders, ",")
 ip := strings.TrimSpace(ips[0])

 // 如果 IP 格式合法，則使用獲取到的 IP，否則使用默認的 ClientIP 方法獲取
 if isValidIP(ip) {
  c.JSON(http.StatusOK, gin.H{"ip": ip})
 } else {
  ip = c.ClientIP()
  c.JSON(http.StatusOK, gin.H{"ip": ip})
 }
}

// isValidIP 判斷 IP 格式是否合法
func isValidIP(ip string) bool {
 // 此處添加自定義的 IP 格式驗證邏輯
 // 例如，使用正則表達式驗證 IP 格式
 // ...

 return true
}

func main() {
 router := gin.Default()

 router.GET("/get-ip", getIPWithValidatedProxyHeaders)

 router.Run(":8080")
}

結語

通過上述步驟，我們詳細介紹了在 Gin 框架中獲取用戶 IP 的多種方式，並對可能的安全問題進行了處理。在實際應用中，爲了確保 IP 獲取的準確性和安全性，需要根據具體情況進一步加強防護措施。

本文由 Readfog 進行 AMP 轉碼，版權歸原作者所有。
來源：https://mp.weixin.qq.com/s/p3ojTOO4lvp4Gtbe69rAVQ

猜你喜歡