协议配置 · 使用指南

Shadowsocks 怎样按对端选择加密方式和传输插件

从 Shadowsocks 的地址、加密与密码开始,辨明 UDP 承载方式,再按对端要求添加插件及其专属选项。

  • cipher
  • UDP over TCP
  • plugin-opts
  • smux
  • TLS
查看分节

先核对 SS 的连接与加密信息

配置应与服务端逐项配套:用 cipher 和 password 建立 Shadowsocks 加密方式,再接入 server:port。不要把不同服务端的地址、端口或密码拼在一起。

TCP 和 UDP 都可以由基础 Shadowsocks 承载。需要改变传输外观或方式时再配置外层插件,加密方法及密码仍须保留。

name不可省略
规则或策略组引用连接时所用的名称。
type不可省略
此项选择 ss 类型。
server不可省略
填入提供 Shadowsocks 服务的主机域名或 IP。
port不可省略
填写远端服务实际监听的端口。
cipher不可省略
按对端给出的完整名称录入加密方式。
password不可省略
填写与所选加密方式配套的服务端密码。

按对端配置选择加密方法

名称较新并不意味着可以直接替换原值。虽然内核接受多类加密方法,cipher 仍须与对端一致,否则加密握手无法完成。

Shadowsocks 加密方法分组
算法分组可识别的字段写法使用条件
AESaes-128-gcm、aes-256-gcm、CTR、CFB、CCM、GCM-SIV这一组同时包含 AEAD 及兼容旧配置的流加密类型
ChaChachacha20-ietf-poly1305、xchacha20-ietf-poly1305列表还列有 ChaCha20、ChaCha8 的不同变体
2022 Blake32022-blake3-aes-128-gcm、2022-blake3-chacha20-poly1305密码或密钥的写法取决于对端采用的实现
LEAlea-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 应写在支持它的插件内部。

Shadowsocks 插件边界
plugin承载模式配套条件
obfshttp 或 tlsmode、host 须按 simple-obfs 对端提供的内容填写
v2ray-pluginwebsocketTLS 可在插件选项内启用,QUIC 不属于此实现接受的模式
gost-pluginwebsocket插件内部接受 Host、Path、请求头、Mux 及 TLS 设置
shadow-tlsShadow TLShost、password、version 为配套设置,可另填 ALPN;接受版本 1、2、3
restlsRestls提供 host、password、version-hint,并按需设置流量脚本
kcptunKCP需与 kcptun 对端逐项匹配,此实现同时会打开 UOT
jlsJLS提供 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 密码正确并不代表这些选项匹配。
YAML
proxies:
  - name: ss-node
    type: ss
    server: server.example.com
    port: 443
    cipher: chacha20-ietf-poly1305
    password: your-password
    udp: true