先核对 SS 的连接与加密信息
配置应与服务端逐项配套:用 cipher 和 password 建立 Shadowsocks 加密方式,再接入 server:port。不要把不同服务端的地址、端口或密码拼在一起。
TCP 和 UDP 都可以由基础 Shadowsocks 承载。需要改变传输外观或方式时再配置外层插件,加密方法及密码仍须保留。
name不可省略- 规则或策略组引用连接时所用的名称。
type不可省略- 此项选择
ss类型。 server不可省略- 填入提供 Shadowsocks 服务的主机域名或 IP。
port不可省略- 填写远端服务实际监听的端口。
cipher不可省略- 按对端给出的完整名称录入加密方式。
password不可省略- 填写与所选加密方式配套的服务端密码。
按对端配置选择加密方法
名称较新并不意味着可以直接替换原值。虽然内核接受多类加密方法,cipher 仍须与对端一致,否则加密握手无法完成。
| 算法分组 | 可识别的字段写法 | 使用条件 |
|---|---|---|
| AES | aes-128-gcm、aes-256-gcm、CTR、CFB、CCM、GCM-SIV | 这一组同时包含 AEAD 及兼容旧配置的流加密类型 |
| ChaCha | chacha20-ietf-poly1305、xchacha20-ietf-poly1305 | 列表还列有 ChaCha20、ChaCha8 的不同变体 |
| 2022 Blake3 | 2022-blake3-aes-128-gcm、2022-blake3-chacha20-poly1305 | 密码或密钥的写法取决于对端采用的实现 |
| LEA | lea-128-gcm、lea-192-gcm、lea-256-gcm | 两端采用相同实现后再选择这一组 |
| 兼容旧配置的选项 | aegis-128l、aegis-256、rc4-md5、none 等类型 | 沿用已有服务的配套算法,避免随意降低加密设置 |
决定 UDP 使用哪条通道
udp 负责允许处理数据报,UOT 则决定如何承载。不启用 UOT 时走 Shadowsocks 原生 UDP;启用后改以 TCP 承载,且两端须支持相同机制与版本。
udp依需求填写- 控制是否接收 UDP 任务,未开启时不处理这类流量。
udp-over-tcp依需求填写- 以 TCP 承载 UDP 的控制项,初始值是
false。 udp-over-tcp-version版本- UOT 接受版本 1、2;未指定版本采用 1。
smux进阶设置- 负责 TCP 通道复用,与 UOT 的封装用途不同,服务端也需支持相应协议。
插件选项应放在各自作用域
先确认服务端启用了哪种插件,再填写 plugin-opts。各插件的选项结构有差异;SS 顶层不能通过 tls 统一启用加密,TLS 应写在支持它的插件内部。
| plugin | 承载模式 | 配套条件 |
|---|---|---|
obfs | http 或 tls | mode、host 须按 simple-obfs 对端提供的内容填写 |
v2ray-plugin | websocket | TLS 可在插件选项内启用,QUIC 不属于此实现接受的模式 |
gost-plugin | websocket | 插件内部接受 Host、Path、请求头、Mux 及 TLS 设置 |
shadow-tls | Shadow TLS | host、password、version 为配套设置,可另填 ALPN;接受版本 1、2、3 |
restls | Restls | 提供 host、password、version-hint,并按需设置流量脚本 |
kcptun | KCP | 需与 kcptun 对端逐项匹配,此实现同时会打开 UOT |
jls | JLS | 提供 host、username、password,ALPN 则按需填写 |
plugin依需求填写- 选用的插件既要被内核接受,也要在对端实际启用。
plugin-opts依需求填写- 每种插件读取自己的选项,不能跨插件整段套用。
client-fingerprint依需求填写- 在支持的 Shadow TLS、Restls、JLS 插件中,用于模拟 TLS 客户端外观。
先建立基础连接再排查插件
示例没有加载插件。若服务端另给了插件参数,保留基础连接与加密字段,再增加 plugin 及相应的 plugin-opts。
- 初始化提示 cipher 有误,先检查名称拼写及内核是否接受该算法。
- 只有 TCP 能通信时,依次核对服务端数据报支持、客户端
udp和防火墙放行情况。 - 插件握手失败需检查 mode、host、path、TLS 与插件凭据,SS 密码正确并不代表这些选项匹配。
proxies:
- name: ss-node
type: ss
server: server.example.com
port: 443
cipher: chacha20-ietf-poly1305
password: your-password
udp: true