Go / 系统课时

防范出站 SSRF

防范出站 SSRF

当服务根据用户提供的 URL 抓取内容、发送 Webhook 或执行回调时,真正的安全边界不在 HTTP 客户端本身,而在“它最终连接到哪里”。本篇用 Go 标准库建立一条可复用的出站校验链,阻止环回、内网、链路本地和恶意重定向目标。

学习目标

  • 限制出站请求允许的协议、主机与重定向次数
  • 在连接前校验 DNS 解析结果,阻止私网、环回和云元数据地址
  • 避免“先校验域名、再重新解析连接”造成的 DNS 重绑定窗口

SSRF 的关键风险点

仅检查字符串是否以 https:// 开头远远不够。攻击者可以提交 http://127.0.0.1:<PORT>、http://169.254.169.254/,也可以让一个公开域名先解析到公网地址、稍后再解析到内网地址;重定向还可能把最初安全的 URL 带到敏感目标。

因此出站请求至少要经过 URL 语法检查、目标主机策略、DNS 结果检查、实际连接地址约束和重定向复检。业务如果能枚举合法回调方,精确主机白名单优先于“允许任意公网地址”。

SSRF 出站请求安全校验链

用自定义 Transport 绑定校验与连接

下面的完整示例把校验放进 Transport.DialContext。域名解析后,只要结果中出现受保护地址就拒绝;真正拨号时直接连接到已经检查过的 IP,从而避免校验和连接之间再次解析 DNS。CheckRedirect 同时限制跳数,并重新检查每个重定向 URL 的协议和主机。

go
package main

import (
	"context"
	"errors"
	"fmt"
	"net"
	"net/http"
	"net/url"
	"strings"
	"time"
)

var allowedHosts = map[string]struct{}{
	"example.com": {},
}

func hostAllowed(host string) bool {
	_, ok := allowedHosts[strings.ToLower(host)]
	return ok
}

func validateURL(u *url.URL) error {
	if u.Scheme != "http" && u.Scheme != "https" {
		return errors.New("scheme is not allowed")
	}
	if u.Hostname() == "" {
		return errors.New("host is required")
	}
	if u.User != nil {
		return errors.New("userinfo is not allowed")
	}
	if !hostAllowed(u.Hostname()) {
		return errors.New("host is not allowed")
	}
	return nil
}

func blockedIP(ip net.IP) bool {
	return ip.IsLoopback() ||
		ip.IsPrivate() ||
		ip.IsLinkLocalUnicast() ||
		ip.IsLinkLocalMulticast() ||
		ip.IsUnspecified() ||
		ip.IsMulticast()
}

func safeClient() *http.Client {
	dialer := &net.Dialer{Timeout: 5 * time.Second}

	transport := &http.Transport{
		Proxy: nil,
		DialContext: func(ctx context.Context, network, address string) (net.Conn, error) {
			host, port, err := net.SplitHostPort(address)
			if err != nil {
				return nil, err
			}

			if !hostAllowed(host) {
				return nil, errors.New("host is not allowed")
			}

			ips, err := net.DefaultResolver.LookupIP(ctx, "ip", host)
			if err != nil {
				return nil, err
			}
			if len(ips) == 0 {
				return nil, errors.New("host resolved to no addresses")
			}

			for _, ip := range ips {
				if blockedIP(ip) {
					return nil, fmt.Errorf("blocked address: %s", ip)
				}
			}

			// 直接连接已经校验过的地址,避免再次按域名解析。
			target := net.JoinHostPort(ips[0].String(), port)
			return dialer.DialContext(ctx, network, target)
		},
	}

	return &http.Client{
		Transport: transport,
		Timeout:   10 * time.Second,
		CheckRedirect: func(req *http.Request, via []*http.Request) error {
			if len(via) > 5 {
				return errors.New("too many redirects")
			}
			return validateURL(req.URL)
		},
	}
}

func main() {
	for _, raw := range []string{
		"https://example.com/data",
		"file:///etc/passwd",
		"http://127.0.0.1/admin",
	} {
		u, err := url.Parse(raw)
		if err == nil {
			err = validateURL(u)
		}
		if err == nil && net.ParseIP(u.Hostname()) != nil && blockedIP(net.ParseIP(u.Hostname())) {
			err = errors.New("literal IP is blocked")
		}

		result := "allow"
		if err != nil {
			result = "deny"
		}
		fmt.Printf("%s -> %s\n", strings.Split(raw, ":")[0], result)
	}

	_ = safeClient()
}

预期输出:

text
https -> allow
file -> deny
http -> deny

这里的 main 只验证固定输入,因此不会访问外部网络;实际抓取时应先 url.Parse 并调用 validateURL,再使用同一个 safeClient 发送请求。

继续收紧主机与端口策略

示例用 allowedHosts 演示精确主机白名单,生产中应替换为真实合作方域名,并从受控配置加载。不要用未经边界处理的字符串后缀判断,例如 HasSuffix(host, "example.com") 会错误接受 notexample.com。端口同样应按业务收紧;多数 HTTP 回调只需要 80 和 443。

还要明确代理行为。示例将 Proxy 设为 nil,避免环境代理改变真实出站路径;如果生产环境必须通过代理访问互联网,就应把 SSRF 边界放到受控代理或统一 egress 网关,并在代理侧执行等价的目标限制。

验证敏感目标确实被拒绝

测试时至少覆盖环回地址、RFC 1918 私网、链路本地地址、IPv6 环回,以及“安全 URL 重定向到敏感地址”的情况。不要真的连接云元数据服务,可以直接测试 blockedIP 和重定向校验函数。

生产环境还应配合网络层 egress ACL、防火墙或服务网格限制。应用层校验负责表达业务意图,网络层限制负责在代码遗漏或新调用路径出现时继续兜底;两层同时存在,SSRF 才不会退化成一次字符串过滤。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

防范出站 SSRF

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通