Shadowrocket 官方手册 · 术语索引

Shadowrocket 术语表

按对象区分界面词、协议名与规则语法。先确认名称出现在哪个位置，再阅读它的作用与边界；相似的英文名称不一定属于同一层设置。

界面选项 Config / Proxy / Direct

决定 Global Routing 的整体工作姿态。

匹配条件 DOMAIN-SUFFIX

判断连接是否命中某一条规则。

规则动作 PROXY / DIRECT / REJECT

规定命中以后采用的处理方式。

本页用于查词，不代替连续操作步骤。首次配置请阅读使用教程；已有订阅的更新、排序与备份见节点管理手册。

界面与开关

连接入口与工作模式

同一个名称可能既是页面入口，也是模式选项。下列解释以所在位置为判断依据；不同平台与应用状态下，入口排列可能有所不同。

Home: 查看服务器列表、选择连接对象并操作连接开关的界面。选择服务器只是确定后续连接对象，仍需启用连接并检查实际访问；开关显示开启，不等于目标服务一定可访问。

Global Routing: 决定连接整体采用哪一种处理姿态，配置、代理、直连对应界面词 Config、Proxy、Direct。需要按规则区分目标时使用 Config；排查时临时切换模式，应记录原设置并在测试后恢复。

Config: 作为页面名称时，指配置文件的导入、选择与管理入口；出现在 Global Routing 中时，表示按当前配置规则处理连接。文件已经保存不等于已经启用，应同时确认选中的配置与当前模式。

Proxy / Direct: Global Routing 中的 Proxy 表示采用代理姿态，Direct 表示采用直连姿态。它们控制整体工作方式，不是具体服务器的协议类型，也不能与规则行中的大写动作 PROXY、DIRECT 混作同一层设置。

On Demand: 按设定条件请求系统自动建立连接的功能，适合减少符合条件时的手动操作。它不负责挑选分流规则，也不会修复错误的密码或地址；手动断开后再次连接时，应检查是否仍有触发条件生效。

DNS: 将域名转换为 IP 地址的解析机制，可能参与域名访问和部分规则判断。域名打不开而直接访问地址有响应时，可以单独检查 DNS；更换解析设置并不能直接解决协议认证失败或服务器不可达。

Connectivity Test: 按选定方式检查服务器可达性的测试入口，结果与本地网络、测试目标和连接协议有关。比较结果前应统一测试条件；一次测试成功只能说明该次探测有响应，不能证明所有应用与目标都正常。

协议

服务器类型与连接参数

协议决定双方怎样认证与传输数据，不决定规则如何匹配。添加服务器时，以用户已有的服务器信息为准，不把一种协议的字段直接套到另一种协议。

Shadowsocks: 使用加密方法与密码建立代理连接的协议，地址、端口、加密方法和密码需要与服务器一致。外观相似的加密方法名称不代表可以互换，导入后仍应逐项核对服务商提供的参数。

VMess: 使用用户标识进行认证的代理协议，通常还需要按服务器要求配置传输方式与相关安全选项。用户标识正确只是条件之一，传输路径、Host 或 TLS 设置不匹配也可能造成连接失败。

VLESS: 以用户标识进行认证的代理协议，传输与安全设置需另行匹配服务器要求。它与 VMess 是不同协议，不能只更换类型名称便沿用全部参数；是否启用 TLS 及其他选项应依据实际资料判断。

Trojan: 通常结合 TLS 建立连接的代理协议，常见核对项包括地址、端口、密码与 SNI。SNI 用于 TLS 握手中的服务名称指示，不一定等于填写的连接地址；证书错误应先检查域名、时间和服务器配置。

Hysteria2: 基于 QUIC 的代理协议，使用 UDP 传输，需匹配认证与 TLS 等参数。网络限制 UDP 时，即使地址和密码正确也可能失败；带宽相关设置应按实际条件填写，不以调大数值代替连通性排查。

WireGuard: 使用公私钥与对端信息建立加密隧道的协议，配置通常还涉及隧道地址、端点和允许的地址范围。私钥属于敏感信息，不应出现在求助截图中；握手正常但访问异常时，还需检查路由与 DNS。

HTTP / SOCKS5: 两类代理协议名称，认证方式与可承载的流量范围需要结合服务器配置确认。不能仅凭协议名称判断连接是否加密，也不能默认某个 SOCKS5 服务具备 UDP 转发能力；应核对具体服务条件。

规则关键字

匹配条件与处理动作

常见规则由匹配类型、匹配值和处理动作构成，通常按列表顺序匹配。理解某一行之前，先确认当前处于 Config 模式，并检查它前面是否已有更宽泛的规则命中。

DOMAIN: 精确匹配指定域名，例如 DOMAIN,example.com,DIRECT 针对 example.com。它不自动包含所有子域名；若需要同时处理 www.example.com 等名称，应另写规则或使用合适的后缀匹配。

DOMAIN-SUFFIX: 匹配指定域名及其子域名，适合按完整域名家族设置统一动作。DOMAIN-SUFFIX,example.com,PROXY 可涵盖 example.com 与其子域名，但不是任意包含 example 字符的域名。

DOMAIN-KEYWORD: 按域名中是否包含给定字符串进行匹配，范围通常比后缀匹配更宽。关键词过短时可能命中原本不想处理的域名，因此应先确认范围，并把更精确的例外规则放在前面。

GEOIP: 依据 IP 地理数据库对目标地址分类，例如 GEOIP,CN,DIRECT 表示匹配相应分类后执行 DIRECT。数据库结果不是用户位置或服务器身份的证明，地址归属更新及解析结果都可能影响命中。

IP-CIDR / IP-CIDR6: 分别用于匹配 IPv4 与 IPv6 地址段，斜杠后的前缀长度决定覆盖范围。检查规则时要同时留意目标实际使用哪种地址族，IPv4 规则不能自动代替对应的 IPv6 规则。

FINAL: 为未命中前面规则的连接指定兜底动作，例如 FINAL,PROXY。通常应放在规则列表末尾；若位置过早，后面的具体规则可能没有机会参与匹配。

PROXY / DIRECT / REJECT: 规则中的处理动作，分别表示交给代理路径、直接连接和拒绝连接。PROXY 的最终出口还取决于当前服务器或相关策略设置；DIRECT 表示不经该代理路径，并不表示目标一定可达。

URL Rewrite: 按表达式匹配请求 URL，并依照设置进行重写或其他处理，与按目标选择连接路径的规则分流不同。它依赖请求是否可被相应机制处理，不应假定添加一行表达式就能作用于所有加密请求。

订阅与服务器

导入、测试与数据恢复

以下条目以用户已有自己的订阅或服务器信息为前提。订阅地址从你的服务商处获取；地址中的认证参数、服务器密码与私钥均应作为敏感信息保管。

Add Server: 手动添加一个服务器的入口，应先选择协议，再按资料填写对应字段。地址、端口、认证、传输与 TLS 信息属于不同部分；不适用的字段不要凭经验补填，保存后应进行连接测试。

SERVER: 可能表示服务器对象，也可能是地址字段，需要结合界面位置判断。服务器地址通常是域名或 IP，并不等于订阅链接；将整条订阅 URL 填进地址字段，不能代替 Subscribe 导入。

Scan QR Code: 识别二维码内容并导入相应信息的入口，二维码可能携带单个服务器链接或订阅地址。扫码后应检查识别出的类型与字段，再决定是否保存；包含认证参数的二维码不适合公开转发。

延迟: 在指定测试条件下得到的响应耗时，常用于比较同一次测试中的条目。数值较小不等于持续下载更快，也不保证目标网站响应更快；排序前应先统一测试方式，超时则需要继续区分网络与认证问题。

iCloud 同步: 在适用的 Apple 设备、账户与系统权限条件下，同步应用支持的数据。它不等于将全部连接状态和所有外部服务一起迁移；换机后仍应核对订阅、当前 Config 与连接权限，并保留必要的独立备份。

安装与系统放行

账户记录、架构与权限

Shadowrocket 覆盖 iPhone、iPad、Mac、Windows、安卓与 Linux。iPhone / iPad 从 App Store 获取，系统要求以 App Store 页面标注为准；其他平台安装包统一经本站 /dl/ 获取，入口与完整操作见客户端下载页。

已购项目: App Store 账户内查看与重新获取已购买应用的入口，换机或重装时应使用对应购买账户核对记录。应用购买记录不会自动恢复服务商订阅；正版核对还应检查开发者 Shadow Launch Technology Limited 与应用 ID 932747118。

Apple 芯片 / Intel: Mac 的两种处理器架构，对应 Shadowrocket 的两个 dmg 安装包。先在“关于本机”查看芯片或处理器信息再选择；架构选择解决的是兼容性，首次打开提示仍需按系统权限步骤处理。

SmartScreen: Windows 的应用信誉提示机制，提示出现并不等于已经完成对安装包内容的判断。确认文件来自本站下载入口后，可在相应提示中选择“更多信息 → 仍要运行”；受组织策略限制时应遵循设备管理要求。

隐私与安全性: macOS 处理应用首次打开限制的系统设置入口；遇到“无法验证开发者”提示，核实本站安装包来源后可查看“仍要打开”。如提示“已损坏”，确认应用位于 Applications 后，按下载页说明使用 xattr -cr /Applications/Shadowrocket.app，不要对不明文件执行命令。

允许安装未知应用: 安卓按来源应用单独授予的安装权限，例如为下载 apk 的浏览器或打开文件的文件管理器授权。应只对本次实际使用的来源开启，安装结束后可按需关闭；微信内无法下载时，改用系统浏览器打开下载页。

deb / rpm / AppImage: Linux 的不同安装包形式，deb 与 rpm 应按发行版包管理体系选择，AppImage 运行前需授予执行权限。使用 chmod +x 时应指向实际下载的 AppImage 文件；安装 deb 时可通过 sudo apt install 指定本地文件，具体操作见下载页。

需要核对安装入口时，查看全平台获取说明；需要把术语落实到操作时，继续阅读使用教程或订阅与服务器管理手册。