协议配置 · 使用指南

SOCKS5 出站代理的 TCP 通道和数据报中继怎样选

SOCKS5 的 TCP 通道、UDP 中继与 TLS 包装各有前提;按上游能力核对接入地址、身份凭据及证书设置。

  • CONNECT
  • UDP Associate
  • TLS
  • 证书校验
  • ip-version
查看分节

先区分 TCP 通道与 UDP 中继

上游接到 SOCKS5 CONNECT 后处理 TCP 请求。udp 开启时则通过 UDP ASSOCIATE 申请数据报中继,与之配套的 TCP 控制通道需要保持连接。

原生 SOCKS5 不为客户端和上游之间的链路加密。对端支持外层 TLS 监听时,才可通过 tls: true 包装 SOCKS5 握手。

地址信息与身份凭据分别填写

先准备名称、类型、服务器及端口即可建立无认证配置。只有上游启用用户名密码验证时,才需补充相应凭据。

name不可省略
这条连接的引用标识,不得与同一配置中的其他名称重复。
type不可省略
此项选择 socks5 类型。
server不可省略
填入提供 SOCKS5 服务的上游主机域名或 IP。
port不可省略
填写上游实际接受 SOCKS5 连接的端口。
username依需求填写
对端要求账号密码验证时,录入提供的用户名。
password依需求填写
录入与该用户名配套的服务端密码。

对上游的 TLS 身份作验证

这里检查上游 SOCKS5 服务的证书。独立 sni 选项不属于此出站实现,TLS ServerName 会默认取 server。

tls依需求填写
只有上游以 TLS 包装 SOCKS5 时才设为 true。
skip-cert-verify慎重启用
明确需要临时定位证书故障时才考虑关闭验证。
name-cert-verify依需求填写
可另设证书 DNSName 检查目标,接入地址仍使用原配置。
fingerprint依需求填写
接收整张证书的 SHA-256 摘要,与 uTLS 模拟浏览器所用的指纹有别。
certificate / private-key依需求填写
客户端证书与私钥一起提供后,可在上游 TLS 连接中进行证书认证。

核对中继地址和 IP 选择

UDP Associate 响应会给出中继地址。若其中地址未指定,客户端以原上游地址补全;对端仍需放行中继端口与请求来源。

udp依需求填写
允许处理数据报任务,未开启时不接收 UDP。
ip-version依需求填写
server 使用域名时,可选择 IPv4、IPv6、双栈及地址偏好。
dialer-proxy依需求填写
先经指定代理或策略组,再建立到 SOCKS5 上游的连接。

带账号密码的连接写法

示例同时请求认证和 UDP 中继。不需要数据报或上游不支持时移除 udp;对端以 TLS 监听时,再配置 tls: true 及证书检查项。

  • TCP 能通信而 UDP 无法传递时,先核实上游是否接受 UDP Associate。
  • TLS 握手不成功,先查该端口是否确实以 TLS 包装 SOCKS5。
  • 身份验证失败应核对对端支持的认证方式,此出站不会自动接入第三方认证插件。
YAML
proxies:
  - name: socks-upstream
    type: socks5
    server: proxy.example.com
    port: 1080
    username: user
    password: pass
    udp: true