先让两端的 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 的连接。
| version | UDP | 连接复用选项 | 版本行为 |
|---|---|---|---|
| 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,再使用该模式接受的字段,不应把不同模式的参数混在一起。
| mode | 该模式读取的设置 | 使用要求 |
|---|---|---|
http | host | 以 HTTP 为外观,host 必须匹配对端设置 |
tls | host | 这是 simple-obfs 的 TLS 外观,与标准 HTTPS 代理用途不同 |
shadow-tls | host、password、version、alpn | Shadow TLS 接受版本 1、2、3 |
restls | host、password、version-hint、restls-script | version-hint 接受 tls12、tls13 两种写法 |
jls | host、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、外层凭据、协议版本及客户端指纹。
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