官方手册 · 功能与设置

Shadowrocket 设置
路由模式、规则与连接检查

先确认 Global Routing,再检查 Config 与服务器。每次只改一项,并用相同请求验证,才能判断设置是否真正影响了连接。

按设置主题查阅

先分清模式、配置与连接

以下界面路径以 iPhone / iPad 为主要参照。其他平台的布局与可见选项可能不同,请以当前应用实际显示为准,不将某个界面的路径直接套用到全部设备。

Home

Global Routing:配置、代理、直连

模式决定流量按什么原则处理。排查规则前,先核对这里。

是什么:Global Routing 是连接处理方式的总开关。Config(配置)使用当前配置文件里的规则决定策略;Proxy(代理)用于让受客户端处理的请求采用代理路径;Direct(直连)用于让受客户端处理的请求采用直连路径。这里的“全部”应理解为进入客户端处理范围的流量,不应据此推断设备上的每一种系统流量都会经过相同路径。

在哪、怎么设:在 Home 打开 Global Routing,选择 Config、Proxy 或 Direct,再返回核对当前服务器。日常需要按域名或 IP 区分路径时使用 Config;怀疑某条规则选错策略时,可以暂时切换 Proxy 或 Direct 进行对照。对照期间保持目标网址、网络和服务器不变,否则无法判断结果是模式变化还是网络变化造成的。

模式处理原则适合何时使用先检查什么
Config(配置)依据当前 Config 的规则匹配策略。日常规则分流;验证指定域名或网段的处理路径。选中的配置文件、规则顺序及策略目标。
Proxy(代理)受处理的请求采用代理路径。临时排除分流规则影响,检查已有服务器连接。当前服务器是否有效,认证与传输参数是否一致。
Direct(直连)受处理的请求采用直连路径。对照本地网络访问结果,判断代理路径是否相关。本地网络、目标服务和 DNS 是否正常。

注意:Proxy 不会修复错误的服务器参数,Direct 也不是关闭客户端连接的同义词。切换模式后,应发起新的请求再查看记录;已建立的长连接可能继续使用原有路径。完成对照后恢复日常模式,避免把一次排查设置长期保留。界面里的 Config 模式与 Config 页面名称相同,但前者是路由姿态,后者用于管理配置文件。

Config

规则分流:匹配条件与策略分开检查

是什么、在哪:规则由匹配条件与处理策略组成,在 Config 中查看当前选中的配置文件。DOMAIN 匹配完整域名,DOMAIN-SUFFIX 匹配域名后缀,DOMAIN-KEYWORD 按域名关键字匹配;IP-CIDR、IP-CIDR6 用于地址段,GEOIP 按 IP 所属地区数据库结果匹配。USER-AGENT 依赖能否取得相应请求信息,不能把它当作对任意加密请求都有效的识别条件。

怎么设:先确定要改变哪个目标的路径,再选最具体的条件。规则通常自上而下检查,先命中的规则决定该请求的策略;因此具体域名规则应放在可能覆盖它的宽泛规则之前,FINAL 放在末尾处理未命中请求。修改后核对配置文件仍处于选中状态,并以新请求验证,不要只确认文本保存成功。

规则片段与策略含义

DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY

PROXY 指向代理处理,DIRECT 使用直连,REJECT 用于拒绝匹配请求。配置中的自定义策略名称必须有对应定义。

DOMAIN IP-CIDR IP-CIDR6 REJECT

注意:上面的片段只说明顺序,不代表适合所有网络。基于 IP 的匹配可能涉及 DNS 解析;域名实际指向变化时,路径也可能变化。REJECT 仅拒绝命中的请求,不能按页面视觉区域删除内容,也不能承诺屏蔽全部不需要的资源。若规则命中正确却仍无法访问,应继续检查策略所指向的服务器,而不是不断追加同类规则。

Home · Add Server · Subscribe

订阅与服务器管理:先分清来源

是什么、在哪:单个服务器条目保存协议、地址、端口与认证等连接参数;Subscribe 用于从用户已有的订阅地址获取并更新条目。在 Home 查看服务器列表,手动输入使用 Add Server,已有二维码可通过 Scan QR Code 导入。订阅管理与 Config 文件管理不是同一件事:服务器列表更新,并不意味着当前规则文件也已更新。

怎么设:从自己的服务商处取得完整信息,按实际提供的类型选择 Shadowsocks、VMess、VLESS、Trojan、HTTP、SOCKS5、WireGuard 或 Hysteria2 等协议。地址与端口之外,还要逐项核对认证、TLS、传输方式及对应附加参数。不要因为两个条目的地址相同就认定参数通用。导入后先检查条目数量与名称,再选择一个条目运行 Connectivity Test,最后用实际目标请求验证。

更新订阅时,先在 Home 对相应订阅手动更新并观察结果。更新失败与更新后列表为空是两类现象:前者先查链接是否可获取,后者还需检查返回内容是否有效、是否为应用可识别的格式。链接被截断、复制时夹带空格或返回登录页面,都可能使导入失败。确认导入成功之前,保留原有可用条目,避免排查时失去对照。

注意:手动修改订阅生成的条目,可能在下次更新时被覆盖;需要长期保留的改动,应先分清本地条目与订阅条目的关系。订阅链接可能包含个人访问凭据,不要贴到公开评论、截图或诊断记录中。协议名称相同不代表具体配置一致,Connectivity Test 的结果也不能替代对认证和目标访问的检查。

Settings · On Demand

On Demand:按条件触发连接

是什么、在哪:On Demand 用于依据设置的网络条件触发连接行为。在 Settings 中进入 On Demand,检查当前启用状态与已有条件。它关注的是何时建立连接,不是某个请求应该选择哪个策略;域名与 IP 的分流仍由 Global Routing 和 Config 决定。

怎么设:先手动连接并确认配置可用,再根据应用实际提供的条件设置触发范围。涉及 Wi-Fi 网络时,仔细核对网络标识及条件顺序;保存后分别在符合条件与不符合条件的网络中测试,观察连接状态是否符合预期。测试时尽量只切换一种网络条件,避免同时修改规则与服务器。

注意:On Demand 不是后台任务永久运行的保证,网络切换、系统权限和系统策略都会影响连接过程。启用后出现连接次数增加或耗电变化,应记录发生时的网络切换情况,先减少不必要的触发条件,再判断是否需要调整其他设置。不同平台可见的条件以实际界面为准。

Data

Data:用流量变化辅助定位

是什么、在哪:Data 展示客户端处理范围内的流量统计,具体分类、时间范围和可查看的明细以当前界面为准。它适合用来观察一次测试前后是否产生请求与数据变化,不能直接当作服务商账单,也不能据此认定设备所有网络活动都已被统计。

怎么用:进入 Data,先确认统计范围和已有数值,再返回目标应用发起一个可重复的请求,之后回来看变化。如果应用还提供请求或连接记录,结合目标域名、发生时间与策略判断路径。不要只看累计总量:系统后台活动可能同时产生流量,一次明显增长不一定来自刚测试的网页。

注意:客户端与服务商的统计口径可能在协议开销、统计周期及上传下载计算方式上不同,因此数字不要求完全一致。清除记录或重置统计前,先保留本次排查所需信息;记录中可能出现域名、地址和访问时间,分享时应脱敏。Data 有流量只说明存在数据传输,不说明目标响应内容正确,更不能据此承诺速度。

Settings · Config

DNS:先核对解析路径,再改地址

是什么、在哪:DNS 将域名解析为 IP 地址,解析结果会影响后续连接,也可能参与基于 IP 的规则判断。检查 Settings 中与 DNS 相关的选项,同时查看当前 Config 是否包含 DNS 配置;配置文件也可能影响实际行为,不能只改一个页面就假定全部请求都采用新设置。

怎么设:先确认问题是否确实发生在解析阶段:目标域名是否拼写正确,多个域名是否都失败,本地网络是否正常。记录当前 DNS 设置后,一次只调整一个解析选项,并保持服务器与路由模式不变。填写的解析地址必须符合对应字段支持的格式;如果字段要求特定协议的地址,不要把普通 IP 与完整协议地址混用。

修改后用新的请求重复测试,并考虑已有缓存和长连接的影响。若域名能够解析而连接仍超时,应转向服务器、规则与目标服务检查;若只有少数域名失败,则比较它们实际命中的策略和解析结果。IPv4 与 IPv6 的可达性可能不同,出现间歇问题时应记录实际使用的地址类型,而不是立即关闭某一类地址支持。

注意:DNS 不等于代理传输,改变 DNS 不能修复错误的密码或端口。加密 DNS 描述的是解析请求的一段传输方式,不能据此推断所有应用流量的隐私属性。不要同时更换多个解析设置、路由模式与服务器,否则即使恢复,也难以确定是哪项修改起作用。

Settings

Test Method、Today Widget 与 iCloud

这些设置分别影响测试、快捷操作与数据同步,不应混作连接质量开关。

Test Method:明确测试测到了什么

是什么、在哪:在 Settings 检查 Test Method,它影响 Connectivity Test 使用的测试方式。不同方法关注的连接阶段不同,结果之间不适合直接比较。某种方法可完成,并不意味着认证、目标网站响应和持续传输均已验证。

怎么设、注意什么:按照当前界面提供的方法选择,并在比较多个服务器时保持方法一致。如果测试目标可设置,也要保持目标不变。结果异常时先检查测试目标本身是否可达,再核对服务器参数。需要判断实际使用情况时,仍要在目标应用中发起请求;不要把一次测试数值当作持续速度或长期稳定性的结论。

Today Widget:快捷操作后回到应用确认

是什么、在哪:Today Widget 相关设置用于系统小组件的快捷访问。先在 Settings 检查对应选项,再按系统提供的添加方式放到可用位置;系统版本不同,小组件的展示位置与交互能力可能不同。

怎么设、注意什么:添加后先进行一次操作,并返回 Home 核对连接和所选服务器是否符合预期。小组件显示的状态可能受系统刷新时机影响,不能只凭旧状态判断连接是否仍然存在。若无法显示或更新,先检查系统是否允许该组件以及应用是否已完成首次打开,不要因此重写规则文件。

iCloud:分清同步、备份与当前选择

是什么、在哪:iCloud 相关选项用于应用所支持的数据同步或导入操作。检查 Settings 中的对应项目,同时确认系统 iCloud 已登录并允许应用使用。若界面提供 Import from Cloud JSON,应按该入口接受的格式导入,不要把任意订阅文本当作同一类文件。

怎么设、注意什么:在目标设备确认收到的数据后,再检查当前选中的 Config 与服务器,不要假定选择状态、系统连接权限或全部本地设置都会随之一致。同步前后都保留可用配置副本,出现冲突时先辨认哪份内容需要保留。服务器凭据与订阅地址属于敏感信息,应同时关注云账号的访问权限;跨平台的数据互通范围以实际功能为准。

Settings · Diagnostics

Diagnostics:从现象回到可验证的步骤

是什么、在哪:Diagnostics 是诊断入口,用于收集或查看应用提供的网络检查信息。在 Settings 找到 Diagnostics,并根据当前界面选择可用项目。诊断记录反映的是某次测试的环境,不能把旧记录当作当前网络的结论。

怎么用:先写清现象:开关不能建立连接、所有目标都失败、只有一个域名失败,还是订阅无法更新。记录当时的网络、Global Routing、选中服务器和 Config,然后只重现一次问题。按时间查看记录,区分解析失败、连接超时、认证失败与规则选择不符。不要先批量改设置再收集记录,否则记录与原始现象不再对应。

  1. 先确认基础网络。在可控条件下对照本地网络访问,排除网络尚未连接或需要认证的情况。
  2. 再检查连接信息。核对服务器地址、端口、协议和认证参数,必要时用另一个已有条目对照。
  3. 再检查模式与规则。确认当前 Config 被选中,观察请求实际采用的策略,而不是只看规则文本。
  4. 最后恢复并复测。撤回未验证的临时改动,用同一个目标重复请求,记录恢复前后的差异。

注意:分享记录前移除订阅地址、认证字段及其他个人信息,保留错误类型、发生顺序和必要环境说明即可。若问题发生在更新或切换配置之后,优先与原有配置副本对照,不要立即清空全部数据。更完整的症状分支见排查手册;首次建立连接的连贯操作见使用教程。