官方手册 / 首次连接

Shadowrocket 使用教程

已有订阅导入、Global Routing 与连接验证

按五个步骤完成 iPhone / iPad 上的基础设置。先准备连接信息,再选择路由模式;看到连接状态后,继续检查请求是否按预期处理。

导入 选模式 连接 验证 排错

Add Server:添加服务器或订阅

打开 Shadowrocket,进入 Home。先判断手中的信息属于哪一种:一条用于更新服务器列表的订阅链接,还是一组包含协议、地址、端口与认证内容的单个服务器参数。这两种信息的填写位置不同,不要把订阅链接整段粘贴到 Host,也不要把某个服务器地址当成 Subscribe 链接。

已有订阅链接:使用 Subscribe

在 Home 点 Add Server,或使用对应的添加入口,进入添加页面后点 Type,选择 Subscribe。把自己的完整订阅链接填入 URL 字段,再保存。复制时留意开头、结尾是否混入空格、换行或说明文字;链接中的查询参数也是内容的一部分,不应手动删改。备注可填写便于自己识别的名称,不影响连接参数。

保存并完成订阅获取后,返回 Home,查看 SERVER 分组是否出现服务器条目。订阅名称和实际服务器名称不一定相同,应展开或查看其条目后再选择。若只看到订阅记录却没有可选服务器,先检查获取是否完成、链接是否有效以及当前网络能否访问订阅地址;反复新建相同订阅通常不能解决源地址的问题。

已有单个服务器参数:按 Type 填写

同样从 Add Server 进入,先按自己的信息选择 Type。不同协议需要的字段并不相同:截图中的 Host、Port、Password、Method 是当前示例类型下的字段,不能机械套用到所有协议。Host 填服务器主机名或地址,Port 填提供的端口;认证内容、加密方式以及 TLS 相关字段应逐项与原始信息核对,大小写和特殊字符也要保持一致。

如果你已有对应的二维码,可使用 Scan QR Code 识别后检查字段;Import from Cloud JSON 则只用于相应格式的已有资料,不能把任意网页地址填进去。保存后回到 Home,点选准备使用的服务器。名称只是备注,选中条目才决定后续代理请求所使用的目标。到这里应当得到一条可辨认、参数完整的服务器记录,下一步再决定哪些请求交给它。

订阅链接可能含访问凭据,应按密码一类信息保管。不要将完整链接、二维码或含认证字段的截图发到公开位置。更新订阅主要更新服务器列表,不代表同时安装了分流规则;Config 的选择还需要单独确认。

Shadowrocket Add Server 官方截图,显示 Type、Host、Port、Password、Method 与导入入口
Add Server:先选 Type,再填写对应字段。截图所示字段只对应示例类型。

Global Routing:选择规则与模式

服务器已出现在 Home 后,打开 Global Routing。这里决定请求采用哪种处理方式,而不是重新填写服务器。三种基础姿态分别是配置(Config)、代理(Proxy)、直连(Direct)。首次操作时应明确自己的目标:是验证所选服务器能否工作,还是根据已有配置执行分流;不同目标对应的检查方式也不同。

配置(Config):按当前配置分流

需要规则分流时使用配置(Config)。先进入 Config,确认准备使用的配置文件已被选中,再查看其规则内容。订阅提供服务器,配置文件描述处理规则,两者不能互相替代。仅导入 Subscribe 后直接选择 Config,并不能说明规则已经符合自己的需求。

官方截图中的配置编辑页按 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等部分组织。基础上手先关注 Rule 及其引用的策略,不需要为了连接而逐项开启其他部分。Add Rule 用于增加规则;若你正在使用已有配置,先读清当前顺序与最终处理方式,再决定是否修改。尤其不要为排查普通连接问题而随意调整 HTTPS Decryption。

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

上面只是一段帮助阅读的规则示例,不是完整配置,也不要求直接粘贴。DOMAIN-SUFFIX 示例匹配相应域名后使用 PROXY,GEOIP 示例对匹配的地址使用 DIRECT,FINAL 处理此前未命中的请求。规则通常按顺序匹配,位于前面的宽泛规则可能让后面的细规则没有机会命中;实际行为还取决于完整配置及其策略定义。

代理(Proxy)与直连(Direct):明确测试目的

代理(Proxy)用于将受该模式处理的请求交给所选代理服务器,可帮助区分“服务器本身不可用”和“配置分流不符合预期”。直连(Direct)用于直接连接,不应期待它验证代理链路。临时切到 Proxy 完成对照后,若原本目标是规则分流,应恢复配置(Config),再验证规则,而不是把一次连通测试当成最终配置。

本步骤只需确认当前姿态、所选配置及服务器三者一致。配置文件来源、复杂规则以及恢复修改的细节,可继续查阅疑难解答;购买和账号问题则见App Store 获取指南,不必在首次连接时同时处理。

Shadowrocket Config 官方截图,显示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 与 Add Rule
Config:查看当前配置的 Rule。Global Routing 的入口位于 Home,配置编辑页用于核对具体规则。

Home:打开连接与 VPN 授权

回到 Home,先核对 SERVER 中选中的服务器,再看 Global Routing 是否仍是刚才决定的姿态。如果准备使用 Config,也要确认启用的是预定配置。完成这两项后,打开页面顶部的连接开关。尚未连接时,顶部可以看到 Not Connected;开关和状态区域是判断本地连接过程是否启动的第一处位置。

首次连接时,系统可能弹出添加 VPN 配置的提示。这是允许 Shadowrocket 建立系统网络连接所需的授权,不是再次购买应用,也不是为服务器重新设置密码。阅读提示,确认发起方后允许,并按系统要求完成设备验证,再返回 Shadowrocket 等待状态变化。若此前取消过授权,可重新打开开关,让系统再次发起所需流程。

连接状态建立后,系统可显示 VPN 标识;不同设备与显示位置可能不同,不应只凭状态栏是否出现字样判断成功。更重要的是回到 Home 查看状态是否稳定,以及下一步能否完成实际请求。连接开关保持开启,说明本地连接正在工作,并不等于远端服务器认证、DNS 解析和每一个目标网站都已通过检查。

如果开关打开后马上回落,先记录系统提示或应用错误,再检查是否存在其他正在使用的 VPN 配置、设备管理限制或未完成的授权。不要连续快速切换开关,也不要一开始就删除所有系统网络设置。VPN 配置可以在系统设置的 VPN 与设备管理相关位置核对;找不到对应项或需要重建时,按疑难解答中的 VPN 权限说明逐步处理。

iPad 上的宽屏布局可能让列表与详情同时出现,但操作关系仍相同:选服务器、核对 Global Routing、打开连接。应用在另一台设备上可用,不代表这台设备已经具备相同的订阅与配置,应在当前设备逐项确认。授权完成后保留当前选择,进入下一步做验证,不要同时改动规则或替换服务器。

Shadowrocket Home 官方截图,显示 Not Connected 开关、Global Routing、Connectivity Test、SERVER 与 Add Server
Home:核对服务器与 Global Routing 后打开顶部开关,再使用 Connectivity Test 辅助检查。

Connectivity Test:验证是否生效

验证要分开回答两个问题:选中的服务器能否响应,以及实际请求有没有走预期路径。在 Home 运行 Connectivity Test,观察所选条目的测试结果。它适合初步筛查完全不响应的目标,但测试使用的方法、目标与真实访问不一定相同;出现响应不代表所有网页、所有协议或所有规则都正常。

保持当前连接,打开浏览器访问一个自己熟悉且获准访问的页面,再访问另一个正常可用的页面做对照。尽量发起新的请求,避免只观察已缓存的内容。记录现象是页面完全打不开、部分资源失败,还是仅某一个目标失败;这些区别比反复说“连不上”更有助于定位问题。

若使用配置(Config),还要核对目标对应的规则与实际连接记录。预期使用 PROXY 的请求,应与相应策略及服务器选择一致;预期使用 DIRECT 的请求,则不应仅因客户端处于连接状态就被认定经过代理。Data 中的上传、下载变化可辅助判断是否产生了流量,但设备上的后台请求也会影响读数,不能用一次总量增加证明某个域名命中了哪条规则。

需要做模式对照时,保持服务器不变,临时在 Proxy 与 Config 之间切换,重新发起同一个请求。若 Proxy 下正常、Config 下异常,优先检查规则顺序、策略目标和解析相关配置;若两种模式都失败,则先回到服务器参数与基础网络。每次只改一个变量,完成对照后恢复原定姿态。这样可以保留清楚的因果关系,而不是把多个变化混在一起。

本步的完成标准不是某个测试数字,而是能够说明“当前选中了哪个服务器、使用哪种模式、一个实际请求的结果是什么”。确认后即可按日常需要使用;若仍失败,保留这些结果,沿下方顺序检查。

Settings:常见失败点检查

排错从最靠前的条件开始。先关闭连接,确认当前 Wi-Fi 或蜂窝网络能完成普通访问,且需要登录的网络已经登录。随后重新连接并复现一次问题。基础网络本身不可用时,修改规则、密码或测试方式只会增加变量,不能替代网络接入。

列表为空、测试失败与连接后打不开

如果订阅更新后列表为空,检查自己的订阅链接是否完整、服务是否仍有效,以及更新时有没有明确报错。不要把订阅更新失败与服务器连接失败混为一谈。若已经有条目但测试失败,检查所选条目对应的 Host、Port、协议及认证信息;需要额外 TLS 参数的连接,也应与已有资料逐项核对,而不是尝试关闭证书验证来跳过错误。

如果状态显示已连接但页面打不开,先确认没有误选直连(Direct),再确认配置(Config)使用的文件和策略确实存在。仅一个目标异常时,检查与它相关的规则和解析;所有目标都异常时,再检查服务器认证、基础网络与 VPN 状态。区分问题范围后再修改,可以减少与故障无关的操作。

Test Method、On Demand 与 Diagnostics

进入 Settings,可以看到 Test Method、On Demand、Diagnostics 等入口。Test Method 会影响测试结果的含义,比较两个服务器或两次结果前,应确认使用相同测试方法和网络条件。不要仅依据一次响应快慢判断长期可用性,也不要把测试方式不同造成的结果差异当成服务器突然变化。

若手动关闭后又出现连接动作,检查 On Demand 的条件是否正在生效。首次上手可先记录当前状态,在明确需要的情况下暂停按需行为,完成手动连接验证后再恢复。Proxy、TCP、UDP 等设置应在知道影响范围后调整,不需要为了完成基础连接而逐项尝试。Language 只影响界面显示,不会修复服务器参数。

Diagnostics 可辅助收集问题线索。记录错误类型、发生在授权还是连接阶段、所选模式以及当前网络即可;分享记录前,遮盖订阅地址、认证字段与个人访问目标。不要直接公开整份配置。已经修改过设置时,先回到可确认的状态再测试,避免在未知状态上继续叠加改动。

仍无法定位时,前往疑难解答按“首次打开与 VPN 权限”“订阅与节点导入”“规则分流与故障排查”继续检查。至此,基础操作链应当清楚:已有资料导入成功,服务器已选中,Global Routing 与配置一致,VPN 授权完成,并用实际请求验证结果。后续调整沿这条链逐项进行即可。

Shadowrocket Settings 官方截图,显示 Language、Test Method、On Demand、Diagnostics、Proxy、TCP 与 UDP
Settings:按问题核对 Test Method、On Demand 和 Diagnostics,避免同时修改多项设置。
下载 Shadowrocket