官方手册 · 设置

Shadowrocket 功能与常用设置

先确认流量采用哪种处理方式,再调整规则、连接条件和诊断选项。每次只改一项,保留能恢复的原配置。

  • Home · 连接与服务器
  • Config · 配置与规则
  • Settings · 通用选项

Global Routing:配置、代理与直连

是什么、在哪里:Global Routing 位于 Home,用于选择当前连接的总体处理方式。配置对应 Config,代理对应 Proxy,直连对应 Direct。它决定如何使用配置规则与服务器,不是单独的连接质量开关;即使选中了某种姿态,也仍需核对连接开关、系统 VPN 配置权限和当前服务器。

怎么设:在 Home 打开 Global Routing,依据使用目的选择姿态。已经准备好规则配置时,通常先使用 Config;要暂时排除规则匹配的影响,可以切换 Proxy 做对照;要观察当前网络直接访问的结果,可以使用 Direct。切换后应重新发起目标请求,必要时关闭并重新打开目标应用,避免沿用旧连接。

姿态与界面词 主要行为 适用核对场景 先检查什么
配置 Config 依据当前生效配置中的规则和策略处理请求。 日常按目标分流,或验证某条规则是否匹配。 配置是否生效、规则顺序、策略指向。
代理 Proxy 总体采用代理处理方式,而不是按 Config 中的常规分流规则选择。 对照测试当前服务器与目标的连通情况。 当前选中的服务器、协议参数、目标可达性。
直连 Direct 总体使用当前网络直接连接。 建立直接访问的基线,排除服务器路径的影响。 本地网络、DNS 解析、目标服务状态。

注意什么:Direct 不等于从系统中移除 VPN 配置,Proxy 也不等于保证所有应用的每种连接都能成功。DNS、既有连接及具体配置仍可能影响观察结果。完成排查后,把 Global Routing 恢复为实际需要的姿态,避免忘记对照测试时做过的修改。

Config 与规则分流:先条件,后策略

是什么、在哪里:规则分流根据域名、地址等条件,决定请求使用 PROXY、DIRECT、REJECT 或配置中定义的策略。配置文件在 Config 中管理;要让规则参与正常分流,需要同时核对当前生效文件与 Global Routing 的 Config 姿态。仅导入一个文件,并不能证明该文件已经在使用。

怎么设:先保存原配置的副本,再检查规则区。DOMAIN 匹配指定域名,DOMAIN-SUFFIX 匹配域名后缀,DOMAIN-KEYWORD 按关键词匹配。IP-CIDR 与 IP-CIDR6 分别描述地址段,GEOIP 按地址归属数据库判断;它们不能与域名条件混为一谈。规则通常按顺序判断,应把更具体的条件放在宽泛条件之前,并检查末尾的 FINAL。

[Rule]
DOMAIN,example.com,PROXY
DOMAIN-SUFFIX,example.org,DIRECT
DOMAIN-KEYWORD,ads,REJECT
GEOIP,CN,DIRECT
FINAL,PROXY

这段内容只展示规则语法,不是可直接替代现有配置的完整文件。示例中,第一条用于指定域名,第二条用于另一域名后缀,第三条展示关键词拒绝;最终没有命中前面条件的请求交给 FINAL 指定的策略。实际使用时还要核对配置里的策略名称是否存在,以及所引用的服务器是否可用。

注意什么:条件匹配正确但策略指向错误,结果仍可能不符合预期。USER-AGENT 等条件还依赖请求是否具备可识别信息,不应把它当作覆盖所有连接的通用判断方式。需要确认命中情况时,结合连接记录查看目标、匹配规则与最终策略;不要只根据网页是否打开推断规则是否生效。

Subscribe 与 SERVER:管理已有连接信息

是什么、在哪里:Home 的 SERVER 区域用于查看和选择服务器,Add Server 用于添加连接信息;Subscribe 用于管理用户已有的订阅。订阅通常是一组可更新的服务器记录,而 Config 是影响规则及其他行为的配置文件,两者作用不同,不能把导入服务器列表理解为已经配置好所有分流规则。

怎么设:以用户已有自己的订阅或服务器信息为前提,按快速上手说明导入。手动添加时,在 Add Server 选择与原始资料一致的类型,再填写地址、端口和认证字段;使用 Scan QR Code 时,确认扫描内容来自本人准备导入的资料。保存后回到 Home,核对名称、类型与当前选中状态,再进行 Connectivity Test。

Shadowsocks、VMess、VLESS、Trojan 等协议需要的字段并不相同。应照原始资料逐项填写,不能仅通过更改类型来转换协议。涉及 TLS、传输方式和服务器名称的选项也需要与服务端设置一致;某个字段看似可留空,不代表在当前连接方案里可以省略。

注意什么:更新 Subscribe 前,先确认其中有没有需要保留的本地调整;更新后再次核对列表和选中项。不要把订阅地址、二维码或包含认证字段的截图公开。Shadowrocket 是付费客户端,客户端一次性买断 ≠ 线路套餐;本站不提供、不销售、不推荐节点或订阅,只说明已有资料的导入和管理方法。

On Demand:按条件触发连接

是什么、在哪里:On Demand 用于根据条件决定何时尝试建立连接。它与手动打开 Home 连接开关的区别,在于连接行为可能由系统依据已保存的条件触发。进入 Settings 查找 On Demand 相关设置,结合当前应用显示的网络条件和选项核对;具体入口及可用项目以应用实际界面为准。

怎么设:先在手动连接状态下完成一次正常访问,再设置按需条件。把希望触发的网络情况与例外情况分开记录,保存后逐一切换对应网络测试。验证时既要看 Home 的连接状态,也要实际访问固定目标,确认条件命中后使用的是预期的服务器和 Global Routing 姿态。

注意什么:On Demand 不能修复服务器参数或规则错误。若手动断开后又出现连接,应先检查按需条件,不要立刻重复删除系统配置。修改前保留条件记录,遇到频繁连接、切换网络后状态异常时,可暂时停用 On Demand,恢复手动连接作为排查基线,确认原因后再逐条恢复条件。

Data:读取流量,而不是推断质量

是什么、在哪里:Data 用来查看应用记录的流量信息。进入 Data,先辨认当前页面采用的时间范围、方向和分类口径,再比较数字。上行、下行、单次连接与累计记录表达的含义不同,应用内显示的数据也不应直接当作运营商账单或其他服务的计费依据。

怎么设与怎么看:为了观察一次操作产生的变化,可以先记录当前数值,再执行单一任务,例如只加载一个固定页面,然后回到 Data 比较变化。如果界面提供清理或重置统计的操作,先确认历史记录是否还需要保留,再执行。用相同网络和任务进行前后对照,比不同时间随意比较总量更容易解释。

注意什么:有流量变化只能说明发生过数据交换,不能证明所有请求成功,也不能证明规则匹配正确。后台任务、重试和网络切换都可能影响统计。判断速度慢或耗电异常时,还要结合使用时长、连接记录和系统电池信息;不要仅因累计数字增加就修改 DNS 或更换全部规则。

DNS:核对解析路径与配置来源

是什么、在哪里:DNS 负责把域名解析为连接所需的地址。相关选项可在 Settings 以及当前 Config 的 DNS 设置中核对,具体生效行为还取决于配置内容。出现域名访问失败、不同网络结果不一致或连接记录中的地址异常时,应先确定当前解析设置来自哪里,再决定是否修改。

怎么设:先记录当前是否沿用系统解析设置,是否指定了解析服务器,以及配置里是否存在其他 DNS 相关参数。需要自定义时,使用本人已确认可达的解析服务,依据该项要求填写正确格式。使用 DNS over HTTPS 时,还要保证其服务地址本身可以建立连接;使用加密传输不等于解析路径自动符合每一条分流预期。

注意什么:一次只改变一种解析取法,保留原值,并用同一个域名重复验证。不要同时改 DNS、Global Routing 和服务器,否则难以分辨哪项修改产生了作用。直接访问某个地址与访问域名的结果也不能简单等同,因为 TLS 和目标服务可能依赖域名。更完整的解析路径说明见 DNS 设置详解。

Test Method 与 Connectivity Test:区分测试对象

是什么、在哪里:Test Method 是 Settings 中与测试方式相关的设置,Connectivity Test 是 Home 中用于执行连接测试的入口。前者影响如何测,后者用于发起测试。阅读结果前要先弄清当前方式测的是哪一段连接,不能把一次测试显示的时间理解为所有网站的打开速度。

怎么设:打开 Test Method 核对当前方式,按应用提供的选项与测试说明选择。若相关方式需要目标地址或其他参数,应先确认目标格式正确且具有可达性。回到 Home 执行 Connectivity Test,比较结果时保持测试方式、目标和网络一致;需要对照另一方式时,先记录原结果再修改。

注意什么:测试成功不代表认证后的每个请求、DNS 解析和目标服务都正常;测试失败也可能只与测试目标有关。若服务器测试有结果而网页打不开,继续检查 Global Routing、DNS 和目标对应的规则。若仅在网络切换后失败,重新测试并记录网络类型,而不是把不同条件下的结果放在一起排序。

Today Widget 与 iCloud 同步:入口和数据分开核对

Today Widget:系统组件入口

是什么、在哪里、怎么设:Today Widget 提供应用之外的快捷查看或操作入口。先在 Settings 核对相关设置,再到系统支持的组件编辑位置查看是否可添加 Shadowrocket。组件形式、可显示内容和可用操作受设备系统及应用实际支持情况影响,系统要求以 App Store 页面标注为准。

注意什么:组件显示与主应用的状态更新可能存在时间差。需要确认当前连接时,应回到 Home 查看,并实际发起请求验证。组件未出现时,先完成一次正常启动,再检查系统组件列表和相关权限,不要为添加组件而修改已验证正常的服务器参数。

iCloud 同步:先确认范围,再处理覆盖

是什么、在哪里、怎么设:iCloud 相关设置用于在受支持的范围内同步应用数据。先核对系统的 iCloud 可用状态,再进入 Settings 查看应用提供的同步选项和说明。首次启用前,分别保存各设备上需要保留的配置,确认同步涉及哪些项目,再执行界面提供的操作;不要预设所有服务器、统计或系统权限都会一起迁移。

注意什么:同步不是历史备份的替代品。两台设备都做过修改时,先比较内容,不要连续切换同步开关尝试“刷新”。更换设备后,应用购买记录、配置数据和系统 VPN 配置权限是不同事项,需要分别核对。iPhone 与 iPad 的具体界面可能不同,同步结果仍应逐项检查。

Diagnostics:按证据定位设置问题

是什么、在哪里:Diagnostics 及相关诊断入口用于收集或查看排查所需的信息,可从 Settings 中查找。诊断的目的不是把所有选项都打开,而是对应一个明确症状,确定问题发生在哪一步:连接未建立、测试失败、域名解析异常,还是规则把请求交给了非预期策略。

怎么设与怎么用:先写下复现时间、网络类型、Global Routing、当前服务器和目标域名,再按界面可用入口查看诊断信息。只重复一次能够稳定复现的操作,记录错误发生的位置和提示。需要比较配置时,以原先可正常工作的副本为基线,一次修改一个参数,验证后保留或恢复。

注意什么:诊断材料可能包含服务器地址、访问目标及认证相关信息。分享之前应逐项检查,移除订阅地址、认证字段和个人访问记录;不要把完整配置直接公开。开启较详细的记录后,按本次排查需要使用,结束后恢复原来的记录设置,并清理不再需要的敏感材料。

本页说明设置的作用与核对方法。若已经出现明确故障,可继续阅读 问题诊断,按开关、连接、订阅、速度或 DNS 等症状逐步排查。应用仅在 Apple 平台发行,唯一获取入口为 App Store;兼容性、系统要求及购买适用性以 App Store 页面标注为准。

下载 Shadowrocket