从身份信息辨认协议分支
认证内容决定这里的 TUIC 分支,而不是另设 version:token 有内容便进入 v4,其余情况选择 v5。连接建立在 QUIC 与 TLS 之上。
基础连接都要提供名称、服务器、端口及 type: tuic。随后按远端采用的版本选择凭据:v4 用 token,v5 用 UUID 配合密码。
| 版本分支 | 需要保留的凭据 | 应当移除的凭据 | 如何判断分支 |
|---|---|---|---|
| TUIC v4 | token | uuid、password | token 内有值 |
| TUIC v5 | uuid、password | token | 未提供有效 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-interval | idle-session-* 不适用于这里 |
| 用户认证 | 按分支使用 token,或 UUID 配合密码 | auth-str 不能作为这里的认证字段 |
对照示例选择凭据
示例分别列出各认证分支。投入使用前,应依远端版本选留相符的配置,并移除另一套凭据。
- 若希望使用 v5,先确认没有遗留非空 token,以免触发 v4 分支。
- UUID 内容须符合格式要求,否则即使填了密码也可能认证失败。
- heartbeat-interval 以毫秒计,不能将按秒理解的值直接填入。
- 不要在启用 disable-sni 后继续假定证书仍被检查;两项行为会一同变化。
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