协议字段 · 配置指南

AnyTLS 怎样核对握手身份并管理空闲连接

配置 AnyTLS 时,可先核对服务端密码及 TLS 握手要求,再检查 SNI、证书验证和会话回收选项。基础示例用于理解字段关系,附加封装需按服务端设置选择。

  • password
  • TLS
  • SNI
  • 空闲会话
  • skip-cert-verify
章节索引

建立连接所需字段

AnyTLS 以 TCP 承载 TLS 连接,不能把 QUIC 或端口跳跃选项套入这一类型。先填写名称、类型、服务端地址、监听端口与密码,再处理其余设置。

password 的内容要逐项核对服务端为用户设定的值。udp 设为 true 后,会在已有 TCP 承载内传送 UDP 请求;底层传输方式仍然是 TCP。

name必填
为出站指定引用名称,供策略组或规则调用。
type: anytls必填
用 anytls 选定该出站实现,采用历史内核时还需核对其类型支持范围。
server / port必填
指定远端地址及监听位置;这里的端口需要填写整数值。
password认证
认证内容应来自服务端用户设置;未获服务端明确允许时,不能省略密码。
udp可选
允许处理 UDP 请求,其数据通过现有连接中的 UDP over TCP 方式转交。

握手名称 与证书检查

建立连接时会进行 TLS 握手。如果省略 sni,握手名称便取自 server;当 server 使用 IP 地址时,应再核对证书所需的域名,并据此设置 SNI。

sniTLS
指定 TLS 握手使用的名称;留空则采用 server 字段的内容。
alpnTLS
协商列表应与服务端支持范围吻合,填写前先确认对端要求。
client-fingerprintTLS
控制客户端在 TLS 握手中呈现的指纹;该设置与校验证书的指纹用途不同。
skip-cert-verify风险
开启 true 会省去常规的证书验证,应先理解这一改动的风险。
name-cert-verifyTLS
指定需要核验的证书名称,连接地址仍由其他字段决定。
fingerprintTLS
通过固定证书指纹约束远端证书,也就是证书钉扎。
certificate / private-keymTLS
当远端启用客户端证书认证时,需要把证书和私钥一并配置。
ech-opts可选
ECH 用来遮蔽 ClientHello 内的真实 SNI;详细子项需按所用内核的 TLS 说明核对。

区分 附加封装与Reality

TLS 特征处理还可涉及 ECH、ShadowTLS、ResTLS 或 JLS。它们各有对应设置,不能据此推断支持 Reality。

shadow-tls-opts封装
该封装的 version、password 应按服务端配置对应填写。
restls-opts封装
密码应与服务端匹配,version-hint 则按对端提供的信息设置。
jls-opts封装
该封装使用 username 和 password 作为对应的认证字段。
封装选择限制须注意
ShadowTLS、ResTLS、JLS 不能叠加选择;重复启用会使出站创建失败。

闲置连接的保留与回收

会话中可以复用多个流;检查间隔、空闲阈值与保留量用于管理连接。时间字段按秒解释,既不代表 QUIC 窗口,也不参与证书检查。

idle-session-check-interval检查间隔
控制空闲检查何时再次执行。
idle-session-timeout回收阈值
执行检查时,空闲时长超过阈值的会话会被关闭。
min-idle-session保留数量
指定回收后仍需留下的空闲会话;数值提高会留下更多连接。

基础连接示例

先让密码与握手字段符合远端要求,再确认基础连接。确有需要时,才补充 ECH 或单独选用附加封装;会话选项是否覆盖默认行为也应据此决定。

YAML
proxies:
  - name: anytls-node
    type: anytls
    server: server.example.com
    port: 443
    password: replace-with-server-password
    udp: true
    sni: server.example.com
    client-fingerprint: chrome
    alpn:
      - h2
      - http/1.1

连接异常时逐项排查

YAML 能够读入,只说明格式可解析,协议选项是否匹配还需另外判断。遇到连接失败,可先移除非必要扩展,再逐项恢复。

  • 沿用其他协议配置中的 reality-opts,会把不兼容的选项带入当前类型。
  • server 使用 IP 时遗漏证书对应的 sni,会使名称验证无法匹配。
  • 附加封装需要单独选择;同时配置互斥项,会在创建出站时遭到拒绝。
  • 空闲连接保留量应按用途设置,盲目提高会留下更多连接,并不等于获得性能提升。