Shadowrocket 官方手册

Shadowrocket 术语表

按界面、协议与规则查词。先辨认术语所在的层级，再查看它影响的是连接对象、路由方式，还是配置内容。

界面词与规则关键字保留英文原文。操作以 iPhone / iPad 界面为例，其他平台的入口位置可能不同；完整步骤见使用手册。

界面与开关

这些名称出现在页面、菜单或连接设置中。相似名称不一定作用于同一范围。

Home: 查看服务器列表、选择连接对象并操作连接开关的主要页面。选中一个条目只表示确定了连接对象，不等于连接已经建立；还需检查连接开关与状态。导入后先在这里核对条目，再进行测试。

Global Routing: 决定客户端如何处理连接的全局路由设置。它包含 Config（配置）、Proxy（代理）、Direct（直连）三种姿态，不是服务器协议的选择器。排查流量是否按预期分流时，应先确认这里的姿态，再检查具体规则。

Config / Proxy / Direct: Config 按当前配置文件匹配规则；Proxy 将流量交由代理处理；Direct 直接连接目标。这里的首字母大写名称属于 Global Routing 界面选项，与规则里全大写的 PROXY、DIRECT 不是同一个层级。临时切换姿态后，记得恢复日常使用的设置。

On Demand: 根据已设置的网络条件触发连接，中文可理解为按需连接。它控制何时尝试建立连接，不负责决定某个域名走哪条规则。若手动关闭后连接又被触发，先检查 On Demand 的条件，再排查其他设置。

Connectivity Test: 按所选方法检查服务器的连通性，结果受测试目标、当前网络和服务器状态影响。测试显示的耗时不是下载带宽，也不能保证所有网站都可访问。比较结果时保持测试方法一致；出现超时，应继续检查地址、端口与认证参数。

Data: 查看客户端流量与连接记录的入口，可用于观察请求是否发生、流量是否经过预期路径。客户端统计的范围与服务商账户账单可能不同，不能据此推算订阅剩余额度。分享记录前，应移除服务器地址、个人域名与认证信息。

Settings: 管理客户端常用选项的设置入口。部分行为还受当前 Config 配置文件控制，因此修改一个开关后，应同时确认是否存在相关配置项。排错时一次只改一处，并记录原值，避免多个变化叠加后无法判断原因。

协议

协议名称描述连接方式，不代表线路质量。按用户已有的服务器资料填写，不凭名称猜测参数。

Shadowsocks: 使用服务器地址、端口、加密方法与密码等参数建立代理连接的协议。导入后应核对加密方法是否与服务器一致，而不只是检查密码。部分条目还带额外参数，应按原始资料保留；分享链接常以 ss:// 开头。

VMess: 以 UUID 等信息识别用户的代理协议，分享链接常以 vmess:// 开头。除地址与端口外，传输方式、路径、Host 与 TLS 等设置也可能影响连接。UUID 正确但传输参数不一致时，连接仍可能失败。

VLESS: 采用 UUID 身份信息的代理协议，分享链接常以 vless:// 开头。协议名不意味着传输已自动具备某种安全设置，仍须核对服务器指定的传输与安全参数。不要直接套用另一个条目的设置，即使两者地址相同。

Trojan: 通常结合 TLS 使用、以密码认证的代理协议，分享链接常以 trojan:// 开头。连接需要服务器地址、端口、密码及对应的 TLS 参数；服务器名称等信息也要与原始资料一致。证书错误应检查域名和设备时间，不应直接跳过验证。

Hysteria2: 基于 QUIC 的代理协议，连接依赖当前网络对 UDP 的支持。认证信息、服务器名称以及其他附加参数应与服务器端匹配。某个网络下无法连接，并不能单凭协议名称判断服务器失效，应结合网络环境与实际测试结果排查。

WireGuard: 使用密钥对与 Peer 信息建立加密隧道的协议。配置通常涉及私钥、公钥、端点和地址范围，字段作用不同，不能互相替换。私钥属于敏感信息，不应放入公开截图、日志或求助内容。

HTTP / SOCKS5: 两类常见代理协议，通常使用服务器地址与端口，部分服务器还要求用户名和密码。认证方式、传输加密与 UDP 支持要按具体服务器能力核对，不能把协议名称当作加密保证。选择条目类型时，应与用户已有的服务器说明一致。

规则关键字

先写匹配条件，再指定处理策略。阅读规则时同时检查位置，较早命中的规则通常先决定结果。

Rule: 将连接目标与处理策略对应起来的一条规则。常见形式是“类型、匹配内容、策略”，例如 DOMAIN,example.com,DIRECT。在 Global Routing 为 Config 时，按当前配置中的规则顺序匹配；规则存在并不代表每次连接都会命中它。

DOMAIN: 精确匹配指定域名，例如 DOMAIN,example.com,DIRECT。这条规则不会自动覆盖 www.example.com 等子域名。需要覆盖整个域名及其下级域名时，应查看 DOMAIN-SUFFIX，而不是反复添加不完整的精确规则。

DOMAIN-SUFFIX: 匹配指定域名及其子域名，例如 DOMAIN-SUFFIX,example.com,PROXY。它可覆盖 example.com 与 www.example.com，但不是任意字符串包含匹配。添加后还要检查前面是否已有更早命中的规则。

DOMAIN-KEYWORD: 匹配域名中包含的指定关键词，例如 DOMAIN-KEYWORD,example,PROXY。匹配范围通常比指定域名后缀更宽，可能覆盖原本没有计划处理的域名。仅针对一个站点及其子域名时，优先确认是否应使用更明确的匹配条件。

GEOIP: 依据 IP 地理数据库中的国家或地区归属匹配目标，例如 GEOIP,CN,DIRECT。它判断的是 IP 数据库归属，不是页面所用文字、域名后缀或用户当前位置。解析结果、数据库内容与规则顺序都可能影响最终命中。

IP-CIDR / IP-CIDR6: 分别用于匹配 IPv4 与 IPv6 地址段，斜杠后的数字表示前缀长度。例如 IP-CIDR,192.0.2.0/24,DIRECT 指定一个 IPv4 地址段。域名解析成不同地址后可能命中不同规则，因此地址段规则应结合 DNS 结果理解。

FINAL: 前面的规则均未命中时采用的最终规则，例如 FINAL,PROXY。它通常放在规则列表末尾，用于说明剩余连接怎样处理。FINAL 不是一条指定域名的规则；若大量请求落到这里，应回查前面的条件是否覆盖了实际目标。

PROXY / DIRECT / REJECT: 规则中的处理策略：PROXY 交由代理处理，DIRECT 直接连接，REJECT 拒绝连接。它们位于规则的策略位置，不负责描述服务器采用哪种协议。全大写的 DIRECT 只作用于命中该规则的连接，不等同于把 Global Routing 改为 Direct。

订阅与配置

区分服务器列表、规则文件与同步数据。导入前应已持有自己的订阅或服务器信息。

Server / Add Server: Server 指由协议、地址、端口与认证等参数组成的服务器条目，Add Server 是手动添加条目的入口。中文说明中的“节点”通常指这类条目，不是应用购买时附带的服务。添加后先核对字段并测试连通性，再选择它进行连接。

Config: 在配置文件语境中，Config 承载规则、DNS 等设置，不等于服务器订阅列表。在 Global Routing 语境中，同名的 Config 则表示按配置分流的姿态。导入文件后还需确认它是否已被选用；只有存在文件而未启用，不能说明其中的规则正在生效。

DNS: 把域名解析成 IP 地址的机制，解析结果可能参与后续的 IP 类规则匹配。能连接服务器但部分域名无法打开时，DNS 是应检查的环节之一。修改解析设置时保留原值，分别验证域名解析与目标访问，避免把所有失败都归因于服务器。

Scan QR Code: 通过二维码读取服务器或订阅信息的导入入口，使用相机扫描时需要相应权限。二维码只是信息载体，不保证内容一定完整、有效或适合当前客户端。导入前确认来源，导入后核对条目类型；包含凭据的二维码不应公开转发。

URL Rewrite: 根据匹配条件重写请求地址或执行指定处理的功能，不等同于决定直连或代理的普通路由规则。修改 HTTPS 请求内容还可能涉及额外配置与授权，并非添加一条 Rewrite 就会生效。仅在理解规则来源、匹配范围和影响后使用，并保留可恢复的原配置。

iCloud 同步: 通过 iCloud 在适用设备间同步应用支持的数据，不等同于向服务商刷新订阅。可同步的内容以应用实际选项为准，并受账户、系统权限与网络状态影响。不要把同步当作完整备份；更换设备前另行保存必要的配置资料，并保护其中的凭据。

平台与安装

Shadowrocket 覆盖 iPhone、iPad、Mac、Windows、安卓与 Linux。获取渠道与系统权限是两个不同环节。

App Store / 已购项目: App Store 是 iPhone / iPad 的获取渠道，“已购项目”用于查看对应账户的购买记录。核对产品页中的开发者 Shadow Launch Technology Limited、官方图标与应用 ID 932747118。换机或重装时，先确认使用原购买账户，再查找已购记录；购买记录与应用内服务器资料不是同一份数据。

Apple 芯片 / Intel: Mac 安装包的两种处理器适配类型，可在“关于本机”查看芯片或处理器信息后选择对应 dmg。首次打开若提示无法验证开发者，先确认安装包来自本站，再在“隐私与安全性”查看“仍要打开”。若提示已损坏，先重新下载，仍有问题时按安装放行说明检查，不应把系统拦截当成连接故障。

SmartScreen / 允许安装未知应用: 前者是 Windows 的风险提示机制，后者是安卓针对安装来源的授权选项。确认使用本站安装包后，Windows 可在提示提供相应选项时选择“更多信息 → 仍要运行”；安卓按系统提示为当前来源开启“允许安装未知应用”。这些操作仅处理安装权限，不会修复服务器、订阅或 DNS 设置，详细步骤见安装放行。

deb / rpm / AppImage: Linux 常见软件分发格式，deb 通常用于 Debian 系发行版，rpm 通常用于 Fedora 等采用相应包管理方式的发行版。AppImage 通常先赋予执行权限再运行，是否可用仍取决于系统环境与依赖。按发行版选择格式，而不是把更换格式当作解决所有启动错误的方法；命令与权限步骤见Linux 安装说明。

VPN 配置: 系统授予客户端处理网络流量所需的配置与权限；首次连接时可能要求用户确认。它不是服务器账户、订阅地址，也不表示系统已经验证远端服务可用。若误删相关配置，可返回 Shadowrocket 发起连接，并按系统提示重新授权；授权完成后仍需单独验证连接。