整改基线:封存可信代理地址解析与远程回归候选

This commit is contained in:
xuans committed 2026-09-18 00:52:10 +08:00
1 parent 33866d0970
commit 89e5d6c0c8
8 files changed
+355 -21

No files matched your search

+78
View File
@@ -0,0 +1,78 @@
package clientip
import (
"net"
"net/http"
"net/netip"
"strings"
)
// Resolve 仅信任显式配置的代理,并从右向左寻找转发链中的首个非可信地址。
// 原始 RemoteAddr 保持不变,初始化和本机访问控制仍应检查真实连接来源。
func Resolve(request *http.Request, trustedCIDRs []string) string {
if request == nil {
return ""
}
peer := normalizePeer(request.RemoteAddr)
address, err := netip.ParseAddr(peer)
if err != nil || len(trustedCIDRs) == 0 {
return peer
}
networks := make([]netip.Prefix, 0, len(trustedCIDRs))
for _, value := range trustedCIDRs {
network, err := netip.ParsePrefix(value)
if err != nil {
return peer
}
networks = append(networks, network)
}
trusted := func(address netip.Addr) bool {
for _, network := range networks {
if network.Contains(address.Unmap()) {
return true
}
}
return false
}
if !trusted(address) {
return peer
}
values := request.Header.Values("X-Forwarded-For")
if len(values) != 1 || len(values[0]) > 4096 {
return peer
}
parts := strings.Split(values[0], ",")
if len(parts) > 32 {
return peer
}
chain := make([]netip.Addr, 0, len(parts))
for _, value := range parts {
address, err := netip.ParseAddr(strings.TrimSpace(value))
if err != nil || address.Zone() != "" {
return peer
}
address = address.Unmap()
if address.IsUnspecified() || address.IsMulticast() {
return peer
}
chain = append(chain, address)
}
for index := len(chain) - 1; index >= 0; index-- {
if !trusted(chain[index]) || index == 0 {
return chain[index].String()
}
}
return peer
}
func normalizePeer(value string) string {
value = strings.TrimSpace(value)
if host, _, err := net.SplitHostPort(value); err == nil {
value = host
}
value = strings.Trim(value, "[]")
if address, err := netip.ParseAddr(value); err == nil {
return address.Unmap().String()
}
return value
}
+68
View File
@@ -0,0 +1,68 @@
package clientip
import (
"net/http"
"net/http/httptest"
"strings"
"testing"
)
func TestResolve(t *testing.T) {
tests := []struct {
name string
peer string
trusted []string
headers []string
want string
}{
{"direct ipv4", "192.0.2.1:1234", nil, nil, "192.0.2.1"},
{"direct ipv6", "[2001:db8::1]:1234", nil, nil, "2001:db8::1"},
{"mapped ipv4", "[::ffff:192.0.2.1]:1234", nil, nil, "192.0.2.1"},
{"host compatibility", "proxy.example:443", nil, nil, "proxy.example"},
{"no implicit loopback trust", "127.0.0.1:1234", nil, []string{"192.0.2.1"}, "127.0.0.1"},
{"untrusted ignores spoof", "192.0.2.1:1234", []string{"127.0.0.1/32"}, []string{"198.51.100.1"}, "192.0.2.1"},
{"single proxy", "127.0.0.1:1234", []string{"127.0.0.1/32"}, []string{"192.0.2.1"}, "192.0.2.1"},
{"mapped proxy", "[::ffff:127.0.0.1]:1234", []string{"127.0.0.1/32"}, []string{"::ffff:192.0.2.1"}, "192.0.2.1"},
{"ipv6 proxy", "[::1]:1234", []string{"::1/128"}, []string{"2001:0db8::1"}, "2001:db8::1"},
{"untrusted intermediate", "127.0.0.1:1234", []string{"127.0.0.1/32"}, []string{"198.51.100.5, 192.0.2.1"}, "192.0.2.1"},
{"trusted intermediate", "127.0.0.1:1234", []string{"127.0.0.1/32", "10.0.0.0/24"}, []string{"192.0.2.1, 10.0.0.2"}, "192.0.2.1"},
{"all trusted", "127.0.0.1:1234", []string{"127.0.0.0/8"}, []string{"127.0.0.2"}, "127.0.0.2"},
{"empty header", "127.0.0.1:1234", []string{"127.0.0.1/32"}, []string{""}, "127.0.0.1"},
{"missing header", "127.0.0.1:1234", []string{"127.0.0.1/32"}, nil, "127.0.0.1"},
{"duplicate header", "127.0.0.1:1234", []string{"127.0.0.1/32"}, []string{"192.0.2.1", "192.0.2.2"}, "127.0.0.1"},
{"port rejected", "127.0.0.1:1234", []string{"127.0.0.1/32"}, []string{"192.0.2.1:80"}, "127.0.0.1"},
{"zone rejected", "127.0.0.1:1234", []string{"127.0.0.1/32"}, []string{"fe80::1%eth0"}, "127.0.0.1"},
{"unspecified rejected", "127.0.0.1:1234", []string{"127.0.0.1/32"}, []string{"0.0.0.0"}, "127.0.0.1"},
{"mapped unspecified rejected", "127.0.0.1:1234", []string{"127.0.0.1/32"}, []string{"::ffff:0.0.0.0"}, "127.0.0.1"},
{"mapped multicast rejected", "127.0.0.1:1234", []string{"127.0.0.1/32"}, []string{"::ffff:224.0.0.1"}, "127.0.0.1"},
{"multicast rejected", "127.0.0.1:1234", []string{"127.0.0.1/32"}, []string{"ff02::1"}, "127.0.0.1"},
{"malformed chain", "127.0.0.1:1234", []string{"127.0.0.1/32"}, []string{"unknown, 192.0.2.1"}, "127.0.0.1"},
{"empty chain element", "127.0.0.1:1234", []string{"127.0.0.1/32"}, []string{"192.0.2.1,"}, "127.0.0.1"},
{"invalid configuration", "127.0.0.1:1234", []string{"127.0.0.1/32", "invalid"}, []string{"192.0.2.1"}, "127.0.0.1"},
{"oversized header", "127.0.0.1:1234", []string{"127.0.0.1/32"}, []string{strings.Repeat(" ", 4096) + "192.0.2.1"}, "127.0.0.1"},
{"too many hops", "127.0.0.1:1234", []string{"127.0.0.1/32"}, []string{strings.Repeat("192.0.2.1,", 32) + "192.0.2.1"}, "127.0.0.1"},
}
for _, test := range tests {
t.Run(test.name, func(t *testing.T) {
request := httptest.NewRequest(http.MethodGet, "https://mail.example.com/", nil)
request.RemoteAddr = test.peer
for _, header := range test.headers {
request.Header.Add("X-Forwarded-For", header)
}
request.Header.Set("X-Real-IP", "203.0.113.9")
request.Header.Set("Forwarded", "for=203.0.113.9")
if got := Resolve(request, test.trusted); got != test.want {
t.Fatalf("解析结果为 %q,预期 %q", got, test.want)
}
if request.RemoteAddr != test.peer {
t.Fatal("解析过程修改了真实连接来源")
}
})
}
}
func TestResolveNilRequest(t *testing.T) {
if Resolve(nil, []string{"127.0.0.1/32"}) != "" {
t.Fatal("空请求应返回空地址")
}
}
@@ -0,0 +1,126 @@
package clientip
import (
"encoding/json"
"fmt"
"net"
"net/http"
"net/http/httptest"
"os"
"os/exec"
"path/filepath"
"runtime"
"testing"
"time"
)
// 此测试仅在远程隔离网络运行,不读取宿主机配置或连接生产应用。
func TestResolveThroughNginx(t *testing.T) {
if runtime.GOOS != "linux" {
t.Skip("真实 Nginx 验收仅在 Linux 隔离环境执行")
}
nginx, err := exec.LookPath("nginx")
if err != nil {
t.Skip("当前环境未安装 Nginx,不能声明真实代理验收通过")
}
directory, err := os.MkdirTemp("", "smail-clientip-nginx-")
if err != nil {
t.Fatal(err)
}
t.Logf("隔离 Nginx 目录:%s", directory)
backend := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, request *http.Request) {
w.Header().Set("Content-Type", "application/json")
_ = json.NewEncoder(w).Encode(map[string]string{
"client": Resolve(request, []string{"127.0.0.1/32"}),
"peer": normalizePeer(request.RemoteAddr),
})
}))
defer backend.Close()
listener, err := net.Listen("tcp4", "127.0.0.1:0")
if err != nil {
t.Fatal(err)
}
address := listener.Addr().String()
_ = listener.Close()
configuration := fmt.Sprintf(`daemon off;
master_process off;
pid %s/nginx.pid;
error_log stderr;
events { worker_connections 64; }
http {
access_log off;
client_body_temp_path %s/body;
proxy_temp_path %s/proxy;
fastcgi_temp_path %s/fastcgi;
uwsgi_temp_path %s/uwsgi;
scgi_temp_path %s/scgi;
server {
listen %s;
location / {
proxy_pass %s;
proxy_set_header X-Forwarded-For $remote_addr;
proxy_set_header X-Real-IP $remote_addr;
}
}
}
`, directory, directory, directory, directory, directory, directory, address, backend.URL)
path := filepath.Join(directory, "nginx.conf")
if err := os.WriteFile(path, []byte(configuration), 0600); err != nil {
t.Fatal(err)
}
logFile, err := os.Create(filepath.Join(directory, "nginx.log"))
if err != nil {
t.Fatal(err)
}
defer logFile.Close()
command := exec.Command(nginx, "-p", directory+"/", "-c", path)
command.Stdout, command.Stderr = logFile, logFile
if err := command.Start(); err != nil {
t.Fatal(err)
}
defer func() {
_ = command.Process.Kill()
_ = command.Wait()
}()
deadline := time.Now().Add(5 * time.Second)
for {
connection, err := net.DialTimeout("tcp", address, 100*time.Millisecond)
if err == nil {
_ = connection.Close()
break
}
if time.Now().After(deadline) {
output, _ := os.ReadFile(logFile.Name())
t.Fatalf("隔离 Nginx 未就绪:%s", output)
}
time.Sleep(25 * time.Millisecond)
}
for _, source := range []string{"127.0.0.2", "127.0.0.3"} {
t.Run(source, func(t *testing.T) {
dialer := &net.Dialer{LocalAddr: &net.TCPAddr{IP: net.ParseIP(source)}, Timeout: time.Second}
transport := &http.Transport{DialContext: dialer.DialContext, DisableKeepAlives: true}
defer transport.CloseIdleConnections()
client := &http.Client{Transport: transport, Timeout: 3 * time.Second}
request, err := http.NewRequest(http.MethodGet, "http://"+address+"/", nil)
if err != nil {
t.Fatal(err)
}
request.Header.Add("X-Forwarded-For", "198.51.100.5")
request.Header.Add("X-Forwarded-For", "203.0.113.8")
request.Header.Set("X-Real-IP", "198.51.100.6")
request.Header.Set("Forwarded", "for=198.51.100.7")
response, err := client.Do(request)
if err != nil {
t.Fatal(err)
}
defer response.Body.Close()
var result map[string]string
if err := json.NewDecoder(response.Body).Decode(&result); err != nil {
t.Fatal(err)
}
if response.StatusCode != http.StatusOK || result["client"] != source || result["peer"] != "127.0.0.1" {
t.Fatalf("真实代理地址校验失败:状态=%d,结果=%v", response.StatusCode, result)
}
})
}
}