代理协议 · 配置文档

TUIC 怎样从凭据认出协议版本并选择中继形式

TUIC 的认证凭据决定协议分支;随后再核对握手身份、QUIC 连接选项及 UDP 中继,避免跨协议套用参数。

  • uuid
  • password
  • TLS
  • QUIC
  • UDP
章节索引

从身份信息辨认协议分支

认证内容决定这里的 TUIC 分支,而不是另设 version:token 有内容便进入 v4,其余情况选择 v5。连接建立在 QUIC 与 TLS 之上。

基础连接都要提供名称、服务器、端口及 type: tuic。随后按远端采用的版本选择凭据:v4 用 token,v5 用 UUID 配合密码。

不同分支的凭据要求
版本分支需要保留的凭据应当移除的凭据如何判断分支
TUIC v4tokenuuid、passwordtoken 内有值
TUIC v5uuid、passwordtoken未提供有效 token
name必填
此出站的引用名,供规则或策略组选择。
type: tuic必填
用该类型声明建立 TUIC 连接。
server / port必填
在此设置远端主机及其 UDP 监听端口,不填写端口范围。
tokenTUIC v4
这是 v4 所用的认证标识,切换到 v5 须移除。
uuid / passwordTUIC v5
UUID 连同密码构成 v5 凭据,v4 不使用这组内容。

把连接目标与握手名称分清

实际连接到的 IP、SNI 和证书检查名称可分别设定。未另配时,sni 取 server,alpn 取 h3;修改后仍须确保各项彼此对应。

ip可选
以指定 IP 代替 server 的解析结果,默认握手名称并不会随之更改。
sniTLS
指定握手的 TLS Server Name;若连接地址为 IP 而证书使用域名,更应核对这一项。
alpn默认 h3
应按远端接受的协议填写 ALPN;没有额外要求就沿用预设。
skip-cert-verify风险
开启会取消证书检查,须先理解由此失去的身份验证。
name-cert-verifyTLS
可另行设置核验证书名称时所用的目标。
fingerprintTLS
以给定指纹约束远端提供的证书。
certificate / private-keymTLS
当远端要求 mTLS 时,客户端证书和私钥缺一不可。
ech-opts当前未生效
字段能被读入,并不代表 ECH 已参与握手;这里记录的拨号逻辑尚未应用该选项。
disable-sni高风险
该开关清除 Server Name 的同时也会取消证书检查,影响不限于 SNI 本身。

握手等待与连接存续

调整这些选项会影响握手过程、等待时限及并发流。先沿用预设,再依据远端要求或具体故障调整,避免无依据改值。

heartbeat-interval按毫秒填写
用于安排 QUIC 心跳发送周期;填写前先确认时间单位。
reduce-rtt0-RTT
此项允许 QUIC 提前发送数据,但早期数据也存在被重放的风险。
request-timeout请求等待期限
该超时由 v4 分支读取,用于等待代理请求建立;v5 不读取此值。
congestion-controller可选
可选择 new_reno、bbr 或 cubic;未指定则沿用 QUIC 库的处理方式。
bbr-profile仅 BBR
为 BBR 选取预设,可用 conservative、aggressive 或 standard。
max-open-streams并发限制
控制可同时打开多少 QUIC 流,调得过高会增加内存与调度负担。
fast-open可选
v4 分支直接读取此项,以减少建立代理请求时的等待。

中继格式与报文尺寸

TCP 流与 UDP 中继均可由 TUIC 承载。中继格式需为远端所接受,数据包大小还受路径 MTU 限制,增大上限不等于提升吞吐。

udp-relay-mode默认 native
明确写 quic 才使用该模式,否则按 native 处理中继。
max-udp-relay-packet-size负载限制
设置 UDP 中继负载的边界;实际值还受 Datagram 容量及协议头开销约束。
max-datagram-frame-size高级
此项限制 QUIC Datagram 的帧尺寸,仍须服从实现自身的上限。
disable-mtu-discovery高级
已定位为路径 MTU 故障时,才考虑关闭探测。
recv-window-conn / recv-window高级
接收窗口区分流与连接两个范围;无特殊要求时无需覆盖预设。

勿跨协议套用字段

同样以 QUIC 承载,并不意味着不同协议拥有相同的配置选项。端口、混淆、认证和保活应按 TUIC 自身的定义核对。

容易误套的设置类别
设置类别此协议的处理方式不应套入的参数
监听端口由 port 指定单一端口ports 与 hop-interval 不属于此处选项
数据混淆未定义专门的 obfs 选项不套入 gecko、salamander 或 obfs-password
会话维持使用 QUIC 流及 heartbeat-intervalidle-session-* 不适用于这里
用户认证按分支使用 token,或 UUID 配合密码auth-str 不能作为这里的认证字段

对照示例选择凭据

示例分别列出各认证分支。投入使用前,应依远端版本选留相符的配置,并移除另一套凭据。

  • 若希望使用 v5,先确认没有遗留非空 token,以免触发 v4 分支。
  • UUID 内容须符合格式要求,否则即使填了密码也可能认证失败。
  • heartbeat-interval 以毫秒计,不能将按秒理解的值直接填入。
  • 不要在启用 disable-sni 后继续假定证书仍被检查;两项行为会一同变化。
YAML
proxies:
  - name: tuic-v5
    type: tuic
    server: server.example.com
    port: 10443
    uuid: 00000000-0000-0000-0000-000000000001
    password: replace-with-v5-password
    sni: server.example.com
    alpn:
      - h3
    udp-relay-mode: native

  - name: tuic-v4
    type: tuic
    server: server.example.com
    port: 10443
    token: replace-with-v4-token
    sni: server.example.com
    alpn:
      - h3
    udp-relay-mode: native