从 HTTP 代理到目标主机
上游地址由 server:port 给出;连通该地址之后,HTTP CONNECT 才负责申请通往目标主机的 TCP 通道。目标采用 HTTP 或 HTTPS,并不决定此处的代理类型。
type: http 本身采用明文;是否保护客户端与上游之间的链路,需要另看 TLS 设置。增加 tls: true 才启用这段链路的加密。此类出站不能转发 UDP。
建立连接前的必要设置
无认证的 HTTP 连接也需要名称、类型、地址及端口。名称承担规则和策略组中的引用功能,同一配置内应避免重复。
name不可省略- 引用连接时使用的标识,可交给
proxy-groups或规则选择。 type不可省略- 此项选择
http类型。 server不可省略- 填入提供 HTTP 代理服务的主机域名或 IP。
port不可省略- 填写上游实际监听的位置;TLS 是否开启另由加密选项控制。
向上游提交身份与请求头
Basic 身份验证需要用户名和密码共同参与。headers 用来定制 CONNECT 的头部,网关要求的 Host、User-Agent、Proxy-Connection 等内容在此设置。
username依需求填写- 填入上游分配的用户名。发送 Basic 信息的前提是账号与密码均已填写。
password依需求填写- 填入认证密码,与
username一起使用。 headers依需求填写- 这里接收 CONNECT 头部的键值对,目标网页普通请求的头部不属于此处。
核验上游身份与加密链路
证书检查和 SNI 指向的是提供代理服务的上游。启用 TLS 后应继续验证证书链与名称,最终访问网站的证书不在这组选项的检查范围内。
tls依需求填写- 上游支持 TLS 时,可用
true建立加密连接。 sni依需求填写- 指定握手所用的服务名称;未单独填写便取
server的值。 name-cert-verify依需求填写- 证书中的 DNSName 可另设检查目标,SNI 仍沿用自身设置。
skip-cert-verify慎重启用- 临时定位故障且已知风险时才考虑关闭验证。
fingerprint依需求填写- 这里填写整张证书的 SHA-256 摘要,与模拟浏览器的客户端指纹用途不同。
certificate / private-key依需求填写- PEM 文本或文件路径均可使用;证书与私钥配齐后进行 mTLS 身份验证。
带 TLS 和身份验证的写法
下方配置把 Basic 验证与上游 TLS 放在一起。没有账号要求时去掉 username 和 password;连接明文上游时则去掉 tls 以及 sni。
- 握手停在 TLS 阶段,应先核实上游监听的是否为 HTTPS 代理。
- 407 Proxy Authentication Required 表明需要检查凭据及上游接受的验证方式。
- 若返回 CONNECT method not allowed,需确认该服务承担正向代理功能并接受 CONNECT。
proxies:
- name: http-upstream
type: http
server: proxy.example.com
port: 443
username: user
password: pass
tls: true
sni: proxy.example.com