官方手册 / iPhone 与 iPad
Shadowrocket 入门指南
已有信息导入 → Global Routing → 连接 → 验证 → 排错。先完成一次可复查的连接,再调整日常分流规则。
STEP 01 / Add Server · Subscribe
添加服务器或导入已有订阅
先判断手里的资料是什么,再选择入口。完整订阅链接用于获取一组服务器;单条服务器链接、二维码或一份包含协议与端口的资料,通常用于添加具体服务器。订阅链接与普通网页地址不是同一种资料,也不能仅凭域名判断用途。若来源说明不明确,先向你已有服务的提供方确认,不要靠反复更换 Type 猜测。
手动添加:从 Home 进入 Add Server
打开 Home,找到 SERVER 区域中的 Add Server,或使用页面上的添加入口。进入 Add Server 后,先点 Type,按照已有信息选择准确的协议,再填写对应字段。截图中的 Host、Port、Password、Method 是特定类型下的字段示例;切换 Type 后,表单可能不同,不应把截图里的字段组合当作所有协议的通用要求。
Host 填写资料中的服务器地址,Port 填写端口,Password 与 Method 按原始资料逐项核对。注意复制内容两端的空格、全角符号和遗漏字符;端口不要带入说明文字。若所选协议还要求其他参数,也应使用原始资料中的对应值。保存前重新对照一遍,随后返回 Home,确认 SERVER 中出现了新增条目。
订阅导入:选择 Subscribe
已有订阅链接时,在 Add Server 的 Type 中选择 Subscribe,将完整链接填入 URL 对应字段,再保存并等待获取结果。不要只复制地址的前半段:查询参数也可能是订阅识别信息。订阅链接属于敏感资料,不应放进公开截图、日志留言或发给不相关的人。这里的导入只使用你已经持有的链接,不涉及寻找或购买服务。
保存订阅条目与成功获取服务器是两个结果。回到 Home 后展开对应分组,确认其下确实有服务器条目;如果只看到订阅名称但没有服务器,不要直接进入连接步骤,应先检查本地网络能否取得该链接、链接是否完整,以及订阅是否仍有效。以后需要 Shadowrocket 订阅更新时,使用该订阅条目的更新操作,并观察列表是否实际刷新,不要以反复添加重复条目代替更新。
若已有资料是二维码,可在 Add Server 使用 Scan QR Code,并按系统提示授予相机权限。Import from Cloud JSON 则用于对应格式的资料,不是任意订阅地址的替代入口。完成这一阶段的标准很简单:SERVER 中已有可点选的服务器,且其信息与你持有的资料一致。Subscribe 与 Config 的区别可在名词解释中继续查阅。
STEP 02 / Global Routing · Config
选择 Global Routing 姿态
服务器列表准备好后,返回 Home,点开 Global Routing。这里决定请求采用哪一种整体处理方式,不负责新增服务器,也不会修正错误的服务器密码。三种姿态统一记作配置(Config)/代理(Proxy)/直连(Direct);切换前先明确此次操作是验证服务器,还是启用已有规则。
| 姿态 | 请求处理方式 | 本次操作用途 |
|---|---|---|
| 配置(Config) | 按当前配置文件的规则与策略处理。 | 验证规则分流与日常使用。 |
| 代理(Proxy) | 将由客户端处理的请求交给代理策略。 | 临时隔离规则因素,检查所选服务器。 |
| 直连(Direct) | 直接连接目标,不经远端代理服务器转发。 | 检查直连表现或作临时对照。 |
第一次验证已有服务器时,可以临时选择代理(Proxy),减少配置文件分流结果对判断的影响。它并不保证所有目标都能访问,也不能代替对服务器资料的核对。完成验证后,如果希望不同请求采用不同策略,再切换到配置(Config)。不要仅凭顶部连接状态推断当前一定正在使用代理:处于直连(Direct)时,远端服务器不会承担这些请求的转发。
使用 Config 前,确认当前配置文件
进入 Config,核对当前正在使用的配置文件,而不只是查看列表中是否存在某个文件。订阅通常提供服务器列表,配置文件则包含规则与其他参数;导入前者不等于自动获得了符合个人需求的后者。打开配置文件后,可以查看 General、Rule 等分段,截图展示了编辑页面及 Add Rule 入口。已有可用配置时,首次连接阶段先保留原内容,避免同时修改多组参数。
规则中的 PROXY、DIRECT、REJECT 是策略关键字,与 Global Routing 中的 Proxy、Direct 不应混为一谈。例如,下方片段表示匹配示例域名后使用 PROXY,其余请求使用 DIRECT;它只用于解释语法,不是本教程要求导入的完整配置。是否经过远端服务器取决于当前姿态、实际匹配的规则以及策略指向,不能只看文件中出现了 PROXY 就作判断。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
如果还不熟悉规则顺序,先完成后面的连接与验证,再阅读规则与配置参考。需要专门比较三种姿态时,可转到代理模式说明。本步只需确认一件事:Home 显示的 Global Routing 与此次测试目的相符,并且配置(Config)确实有明确的配置文件可供使用。
STEP 03 / Home · SERVER
点选服务器,再打开连接开关
返回 Home,在 SERVER 中展开刚才导入的分组,点选这次准备使用的服务器。查看条目旁的选择标记,确认默认服务器已切换到预期条目。点开详情与选中服务器是不同操作:进入编辑页面并不会自动证明该条目已经被选作本次连接对象。服务器较多时,先记住所选名称,后面排错才能对应到同一份资料。
确认 Global Routing 后,打开 Home 顶部的连接开关。尚未建立连接时,页面可显示 Not Connected;开启后应观察状态是否发生变化,以及开关能否保持开启。不要连续快速开关,否则难以区分是前一次连接尚在处理,还是新一次尝试已经失败。若系统正在显示授权请求,先处理该请求,再回到应用查看结果。
首次授权:允许添加 VPN 配置
首次连接时,系统可能要求允许 Shadowrocket 添加 VPN 配置。该授权用于让客户端通过系统网络扩展处理流量,并不是购买确认,也不代表远端服务器已经通过测试。核对请求来自正在操作的 Shadowrocket 后,按系统提示确认;设备可能要求使用密码或生物识别完成授权。完成后回到 Home,必要时重新打开连接开关。
如果此前拒绝授权,连接不能仅靠重新导入订阅恢复。应再次触发连接并检查系统提示;设备受管理、存在连接限制,或另一个 VPN 连接正在使用时,还需要核对设备设置及适用的管理要求。不要在尚未确认用途时删除其他 VPN 配置。iPad 的屏幕布局可能与截图不同,但依然按 Home、SERVER、Global Routing 和连接开关的名称定位。
连接保持开启只说明本地连接状态成立,不等于服务器、解析和目标访问都已正常。下一步仍要运行 Connectivity Test,并在实际网页中复查。若开关立即关闭,优先转到最后一节检查授权与本地连接;若开关保持开启但访问失败,则继续记录所选服务器、当前姿态和具体失败现象,不必立刻重装应用。
STEP 04 / Connectivity Test · 实际访问
同时检查测试响应与实际流量
连接开启后,在 Home 点击 Connectivity Test,等待本次测试完成。测试结果应结合所用的 Test Method 理解:不同方法检查的对象和条件可能不同,显示有响应并不等于任意网页、任意协议或全部应用都可用。也不要把一次测试显示的数值当成长期性能结论;本教程只用它来判断当前是否有进一步验证的基础。
接着打开浏览器,访问你实际需要使用、且已知地址正确的页面,再打开另一个正常工作的页面作对照。观察是否能够加载完整内容,而不只是出现页面标题或缓存中的旧文字。若只有某个应用异常,先记录异常范围,不要直接认定整条连接失效;目标服务状态、应用自身设置以及配置规则都可能造成不同结果。
Config 下还要验证规则去向
如果最终准备使用配置(Config),在代理(Proxy)测试完成后切回 Config,并重新测试相同目标。两种姿态结果不同,往往提示应检查规则匹配或策略选择,而不是继续修改服务器密码。选取一个预期走 PROXY 的目标和一个预期走 DIRECT 的目标分别验证,避免用单一页面概括全部分流行为。测试目标应来自你已有的实际使用需求。
需要确认某个请求采用了什么策略时,可结合 Data 中可用的连接或请求记录,以及当前配置文件核对;具体可见项目以应用内页面为准。先看目标与规则是否匹配,再看最终策略,不能仅凭系统的 VPN 状态图标推断流量一定经过远端服务器。预期匹配失败时,应检查规则顺序、域名条件与兜底规则,深入分析放在规则参考中进行。
本步结束时,应能说明三个事实:当前选的是哪台服务器、Global Routing 是哪一种姿态、哪些实际目标已经验证成功。测试通过后保留这组可用设置作为基线。若之后更换网络、更新订阅或修改规则导致表现改变,便可以逐项与基线比较,而不是从头猜测所有字段。
STEP 05 / Settings · Diagnostics
按失败阶段排查,每次只改一项
排错从最早失败的一步开始。先关闭连接开关,确认设备本身能正常访问已知可用的页面,再重新启用 Shadowrocket。公共网络需要先完成网络自身的登录时,应先处理该登录。若本地网络就不可用,修改 Config、重新扫描二维码或更换 Test Method 都不能修复这个基础问题。
导入失败:先分清链接获取与服务器连接
Subscribe 无法取得列表时,检查链接是否复制完整、是否多出空格,以及提供方是否调整了访问条件。订阅获取失败与某台服务器连接失败是两类问题:前者尚未成功取得列表,后者则是已有条目无法使用。列表已经存在时,也要确认当前选中的条目没有因订阅更新而失效。避免删除所有资料后再尝试,以免丢失可供比较的记录。
测试失败:回到原始服务器资料
逐项核对 Type、Host、Port,以及所选协议需要的认证和传输参数。大小写、加密方法、服务器名称等要求都应以已有资料为准,不要照抄其他类型的填写方式。设备日期和时间也应正确,否则可能影响需要证书校验的连接。仅为排错随意关闭校验会掩盖真正的问题,应先确认资料、时间与目标名称是否正确。
部分访问失败:检查模式与规则
若代理(Proxy)可用、配置(Config)不可用,优先检查当前生效的配置、目标所匹配的规则,以及对应策略是否指向预期服务器。若直连(Direct)可用而代理(Proxy)不可用,只能说明这次直连目标可达,不能证明服务器信息正确。切换姿态时使用同一个目标作对照,且一次只调整一项,才能把现象与改动对应起来。
Settings 中先看哪些项目
进入 Settings,先核对 Test Method,确保你理解 Connectivity Test 所采用的方法;测试方法变化后,结果不能直接与此前作同条件比较。On Demand 用于按条件触发连接,若出现关闭后又重新连接等与手动操作不一致的现象,应检查是否已配置相关条件。初次排错时先记录原设置,再暂时排除自动触发因素,稳定后再恢复适合的条件。
需要进一步定位时,使用 Settings 中的 Diagnostics,并仅记录与当前问题相关的内容。Proxy、TCP、UDP 等项目不应当作“全部开启即可修复”的通用开关;缺乏明确依据时保留原设置。提交记录前遮盖订阅链接、服务器认证信息与个人请求内容。可以描述失败发生在哪一步、使用哪种姿态、连接是否保持开启,而不必公开完整连接资料。
如果已经定位到订阅或服务器本身,向你已有服务的提供方核对有效性;若问题集中在规则语法,继续阅读配置文件与规则参考;对 Settings 中的界面词不熟悉,可先查名词解释。完成一次稳定连接后再逐步加入规则和 On Demand 条件,比在首次连接时同时调整多个高级设置更容易复查。
完成检查
保留可用配置,再做进阶调整
确认 SERVER 条目、所选服务器、Global Routing 与实际访问结果相互对应。需要切回日常配置时,再重复一次验证,不以首次测试成功代替后续检查。