egressproxy

type BlockedError struct {
	Host   string
	Port   int
	Reason string
}

type Policy struct {
	// AllowHosts 允许的目标主机：精确主机名，或通配后缀 "*.example.com"。
	//
	// 通配语义**只匹配子域**：`*.example.com` 命中 `a.example.com` 与
	// `a.b.example.com`，**不**命中 `example.com`（要它请显式写一条），
	// 也**不**命中 `evilexample.com`（后缀按标签边界比，不做裸后缀比较）。
	// 单独一个 "*" 表示放行全部主机（此时 `DenyHosts` 仍然优先）——
	// 这是「只做黑名单」的唯一写法，必须显式写出来。
	AllowHosts []string
	// DenyHosts 拒绝的目标主机（语义同 AllowHosts，**优先于** AllowHosts）。
	DenyHosts []string
	// AllowPorts 允许的目标端口。空 ⇒ 只允许 443 与 80。
	//
	// 为什么空缺省不是「全部端口」：代理最常见的失手是「主机名单对了，
	// 但放行了 22 或 3306」——端口是攻击面的一部分，必须显式开。
	AllowPorts []int
	// Limited 只读模式：**明文**请求只允许 GET / HEAD。
	//
	// ⚠️ 对 `CONNECT` 不生效且无法生效：CONNECT 之后是 TLS（或任意协议），
	// 方法不可见。所以 Limited 对 HTTPS 只保证「目标主机在名单内」，
	// 不保证「只读」——这是能力的真实边界，写在这里而不是留给使用者猜。
	Limited bool
}

type Proxy struct {
	// contains filtered or unexported fields
}