协议配置 · 使用指南

Snell 的两端版本会影响哪些 UDP 与复用选项

Snell 配置应先匹配密钥与协议版本,再确认数据报和复用能力,并区分外层混淆密码与基础 PSK。

  • psk
  • version
  • udp
  • obfs-opts
  • reuse
查看分节

先让两端的 Snell 版本匹配

Snell 使用 psk 作为预共享密钥,version 决定通信报文格式。地址、监听端口、密钥及版本应从对应服务端成套取得。

UDP 和复用能力随版本变化。当前实现未收到 version 时采用 v1 兼容旧配置,因此版本值会改变连接行为,应明确填写。

连接地址与密钥的填写要求

基础连接信息加上 PSK 才能组成 Snell 配置。另将版本明确写出,可避免省略后自动选用 v1。

name不可省略
供策略组或规则选择这条连接的标识。
type不可省略
此项选择 snell 类型。
server不可省略
填入运行 Snell 的主机域名或 IP。
port不可省略
填写 Snell 远端服务监听的端口。
psk不可省略
填写服务端分配的预共享密钥,内容必须完整匹配。
version应明确指定
版本可填 1、2、3、4、5;没有这一项会按 1 处理。

按版本判断 UDP 与复用能力

先按版本查明 UDP 和 reuse 是否可用。当前实现借助 v5 服务端兼容 v4 的能力,以 v4 客户端路径处理标为 v5 的连接。

Snell 版本能力
versionUDP连接复用选项版本行为
1不可使用无此选项省略 version 后采用的版本
2不可使用固定开启复用v2 始终复用连接,不读取 reuse 的开关值
3可启用无此选项允许启用 udp: true
4可启用可配置reuse 初始为 false,应按对端能力决定是否开启
5可启用可配置由 v4 客户端路径接入兼容的 v5 对端
udp依版本决定
v3、v4、v5 可处理 UDP;在 v1、v2 中开启会阻止初始化。
reuse依版本决定
用于 v4、v5 的复用设置,初始为 false。

外层混淆按模式分别配置

obfs-opts 保存外层混淆参数。先确定对端的 mode,再使用该模式接受的字段,不应把不同模式的参数混在一起。

Snell 混淆模式
mode该模式读取的设置使用要求
httphost以 HTTP 为外观,host 必须匹配对端设置
tlshost这是 simple-obfs 的 TLS 外观,与标准 HTTPS 代理用途不同
shadow-tlshost、password、version、alpnShadow TLS 接受版本 1、2、3
restlshost、password、version-hint、restls-scriptversion-hint 接受 tls12、tls13 两种写法
jlshost、username、password、alpn身份验证内容应逐项匹配 JLS 对端
obfs-opts依需求填写
不需要外层混淆时,可省略整组 Snell 混淆选项。
client-fingerprint依需求填写
TLS 外观模式可用此项模拟客户端指纹,需配合支持它的混淆模式。
obfs-opts.host依需求填写
用于构造混淆域名外观,取值来自对端的配套设置。
obfs-opts.password模式相关
这是 Shadow TLS、Restls 的外层认证密码,应与 Snell 的 psk 分开填写。

核对 v4 示例中的混淆选项

示例指定 v4、允许 UDP,并加上 simple-obfs 的 TLS 外观。如果对端不使用混淆,应移除整个 obfs-opts 对象。

  • 先用对端提供的 psk 核对认证,Shadow TLS、Restls 的外层凭据不能填入 psk。
  • TCP 正常而 UDP 无法初始化时,先确认 version 是否采用 3、4、5 中的兼容版本。
  • 混淆握手未完成,应分别检查 mode、host、外层凭据、协议版本及客户端指纹。
YAML
proxies:
  - name: snell-node
    type: snell
    server: server.example.com
    port: 44046
    psk: your-psk
    version: 4
    udp: true
    obfs-opts:
      mode: tls
      host: example.com