协议配置 · 使用指南

HTTP / HTTPS 出口如何建立隧道并识别上游

HTTP 上游如何接入、怎样发送 CONNECT、何时启用 TLS?从连接条件到凭据与证书,逐项核对配置作用。

  • CONNECT
  • TLS
  • SNI
  • 证书校验
  • mTLS
查看分节

从 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。
YAML
proxies:
  - name: http-upstream
    type: http
    server: proxy.example.com
    port: 443
    username: user
    password: pass
    tls: true
    sni: proxy.example.com