协议配置 · 使用指南

ShadowsocksR 旧连接怎样对齐认证与混淆设置

维护旧 SSR 服务时,连接信息还需配合流加密、Protocol 与 Obfs;各组参数应按服务端成套填写。

  • cipher
  • protocol
  • protocol-param
  • obfs
  • udp
查看分节

维护 SSR 时先辨认配置类型

旧 SSR 服务采用 ShadowsocksR 兼容出站。其处理链包含混淆、流加密与 SSR Protocol,因此只有 SS 的 cipher 和 password 并不足以构成配置。

应从正在使用的服务端取得完整 SSR 参数。现代 Shadowsocks 的字段不能靠改写 type 就转成可用的 SSR 配置。

需要同时提供的连接信息

名称、类型、地址、端口之外,还需配齐密码、流加密方法、混淆类型与 SSR Protocol,才能组成 SSR 连接配置。

name不可省略
规则引用的连接标识,同一配置内不得重复。
type不可省略
此项选择 ssr 类型。
server不可省略
填入运行 SSR 的远端主机域名或 IP。
port不可省略
填写对端 SSR 服务实际监听的端口。
cipher不可省略
按对端配置选择 SSR 所接受的流加密算法。
password不可省略
填写对端为这条 SSR 连接分配的密码。
obfs不可省略
选择与对端配套的 SSR 混淆类型,用来处理传输外观。
protocol不可省略
选择 SSR 的认证与报文封装方式。

加密、外观与认证不能混搭

SSR 除受支持的流加密算法外也接受 none。none 在内部映射为 dummy;现代 SS 的 AEAD 名称不属于可直接替换的选项。

SSR 核心字段职责
配置项承担的功能与对端配套的内容
cipher保护 SSR 流中的数据使用对端给出的流加密算法,AEAD 不能代填
password生成加密所需密钥使用这条连接对应的 SSR 密码
obfs改变报文的外观仅选用对端已启用的类型
protocol认证并封装数据仅选用对端已启用的类型

附加参数与网络连接选项

混淆和协议参数应取自对应服务端。有明确参数时完整填写,没有提供时也不应借用其他配置中的内容。

obfs-param依需求填写
将对端要求的内容传入混淆模块,具体取值由其配置决定。
protocol-param依需求填写
提供 SSR Protocol 需要的附加内容,格式必须满足对端要求。
udp依需求填写
开启数据报处理还需对端、Protocol 和沿途网络共同支持。
ip-version依需求填写
服务器写为域名时,用它选择 IPv4、IPv6 或双栈解析行为。
dialer-proxy依需求填写
指定先经过的代理或策略组,再接入 SSR 服务端。
  • plugin、plugin-opts 属于 SS 插件体系,SSR 不读取这组选项。
  • SSR 顶层也不接受协议级 tls: true,不能靠添加它获得 TLS。
  • cipher、obfs、protocol 不配套时,打开 UDP 同样不能恢复通信。

按示例逐项定位问题

下方列出基础连接字段。对端若另有 obfs-param、protocol-param,应放到同一配置层级。

  • 加密初始化未完成,先确认 cipher 是否为 SSR 接受的流加密类型。
  • 连接已建立但没有数据,应检查 protocol 及 protocol-param 是否匹配对端。
  • 外观握手异常时,同时检查 obfs、obfs-param 和远端接入地址、端口。
YAML
proxies:
  - name: ssr-node
    type: ssr
    server: server.example.com
    port: 443
    cipher: chacha20-ietf
    password: your-password
    protocol: auth_sha1_v4
    obfs: tls1.2_ticket_auth