先区分 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。
- 身份验证失败应核对对端支持的认证方式,此出站不会自动接入第三方认证插件。
proxies:
- name: socks-upstream
type: socks5
server: proxy.example.com
port: 1080
username: user
password: pass
udp: true