官方手册 · 首次配置
Shadowrocket 使用教程 订阅导入与连接验证
先导入已有资料,再选择 Global Routing,最后用实际访问核对结果。本页只讲 iPhone 与 iPad 上的首次配置流程,规则语法另见规则手册。
01 添加服务器或导入订阅
先判断手里的资料属于哪一种:一条用于批量读取服务器的订阅链接,还是一组包含协议、地址、端口及认证参数的服务器信息。两者进入应用后的填写方式不同。不要因为资料都表现为一串文字,就把订阅地址填进服务器地址栏;也不要只凭地址的开头判断协议,应以你已有资料的说明为准。
通过 Subscribe 导入已有订阅
打开 Shadowrocket,进入 Home,点击右上角添加按钮进入 Add Server。在 Type 中选择 Subscribe,把自己的完整订阅链接填入 URL,再为这组记录填写便于辨认的名称并保存。粘贴后检查开头、结尾和参数是否完整,尤其注意聊天消息中附带的空格、换行或标点;这些字符可能让原本有效的地址变成另一个请求。
保存后返回 Home,等待订阅读取完成,再检查是否出现预期的服务器记录。订阅名称能显示,不一定代表内部服务器已经成功读取;需要展开对应分组,确认确实存在可选择的条目。若列表为空,先核对订阅链接是否仍有效、当前网络能否获取该地址,以及服务商给出的链接是否用于客户端订阅,而不是账号管理页面。
订阅内容可能随服务商调整而变化。需要重新获取记录时,对该订阅执行更新,再核对当前选择是否仍指向预期服务器。不要反复新增同一个订阅来代替更新,否则容易留下名称相似的重复分组。更新会刷新订阅提供的内容,因此不应把对订阅条目的临时修改当作长期保存的唯一依据。
通过 Add Server 手动填写
如果你持有独立服务器资料,同样进入 Add Server,但此时应在 Type 选择资料对应的协议,而不是 Subscribe。随后按该协议显示的字段填写服务器地址、端口和认证信息。Shadowsocks、VMess、VLESS、Trojan 等协议所需参数不同,只填地址和端口通常不够;应逐项核对加密方式、认证标识、传输方式以及 TLS 相关设置。
不要把多个字段合并填写。例如服务器地址通常不应包含网页路径,端口也应单独填写;TLS 的服务器名称可能与连接地址不同,应保留资料中规定的值。保存后回到 Home,检查条目的名称和协议是否符合预期,再点击所需条目将其选中。如果拥有多个服务器,首次验证先固定一个,避免在排查时同时更换连接对象。
02 选择 Global Routing 姿态
回到 Home,打开 Global Routing。这里的配置(Config)、代理(Proxy)、直连(Direct)决定连接的整体处理方式,不是三种服务器协议,也不是速度等级。应先想清楚本次验证的目标,再选择对应姿态;如果希望按网站分流,还要确认 Config 中实际启用的配置包含相应规则。
配置(Config):按当前配置匹配
日常需要按配置分流时,选择配置(Config)。应用会依据当前配置中的规则决定请求使用的策略。进入 Config,确认当前使用的是你打算采用的配置;如果有多份名称相近的配置,不能仅凭列表里“存在这份文件”就认定它正在生效。进一步查看规则,确认目标域名对应的策略及兜底规则符合需求。
例如,下列片段表示 example.com 及其子域名使用 PROXY,其余未命中的请求使用 DIRECT。这只是规则语法示例,不包含服务器资料,也不需要为了完成本教程直接覆盖你的现有配置。使用前应理解它会改变哪些请求的走向。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
规则通常按顺序匹配,具体条件应放在兜底规则之前。规则中的 PROXY 指向代理处理,DIRECT 表示直接连接,REJECT 表示拒绝;它们与 Global Routing 菜单里的姿态属于不同层次。若想系统理解配置结构、策略引用和匹配顺序,继续阅读配置文件参考,本页不展开复杂规则编辑。
代理(Proxy)与直连(Direct):明确本次验证目的
选择代理(Proxy)时,请求整体按代理姿态处理,而不是按普通分流规则逐条决定走向。它适合临时确认当前代理连接是否可用,但不要把“切到 Proxy 后能访问”直接等同于“原配置没有问题”:两种姿态的处理路径不同,结果有差异恰好提示需要检查规则。
选择直连(Direct)时,请求直接连接目标,不使用当前选中的代理服务器。列表里即使选中了某个服务器,也不能据此判断网站正通过它访问。完成一次临时对照后,应回到你的日常目标:需要分流就恢复配置(Config),并再次核对当前配置,而不是长期保留一个只为测试选择的姿态。
03 打开开关并完成连接授权
在开始连接前,回到 Home 做一次简短复核:所选服务器是否正确,Global Routing 是否符合预期,使用配置(Config)时当前配置是否已经确认。把这三项固定下来后,再打开页面顶部的连接开关。这样后面遇到失败时,可以区分是导入问题、选择问题,还是连接过程本身的问题。
首次建立连接时,系统可能弹出添加 VPN 配置的授权提示。这是允许应用建立系统网络配置的步骤,不是重新购买应用。确认本次操作来自你刚打开的 Shadowrocket,再按照系统提示完成授权;如果系统要求设备认证,直接在系统界面完成,不需要把设备认证信息填入任何服务器字段。
授权结束后返回 Shadowrocket,观察开关与连接状态。如果刚才拒绝了授权,或在系统界面中途取消,连接可能无法继续;回到应用重新触发连接,并按系统提示完成。已经存在其他 VPN 连接时,应先确认当前实际启用的是哪一个网络配置,避免把其他连接的状态误认为 Shadowrocket 的状态。
连接开关打开,只能说明已经发起或建立了相应的系统连接,不能单独证明所选服务器能访问每一个目标。系统的 VPN 状态标识也不能替代网站访问测试。保持当前服务器和姿态不变,接下来再用 Connectivity Test 与实际访问分别验证,这两类证据需要一起看。
首次配置阶段不必同时调整 On Demand 等自动连接设置。先用手动开关建立一条能够重复验证的流程,确认连接、规则和目标访问都符合预期,再考虑自动连接需求。若开关关闭后又出现连接,检查是否已有自动连接设置参与,而不是反复删除服务器记录。相关设置可在On Demand 功能说明中继续核对。
04 验证服务器与实际访问结果
验证分两层进行:先看所选服务器能否响应测试,再看目标请求是否按预期处理。只看一个测试数字,或只看一个网页能否打开,都不足以说明整套配置正确。前者不能代表所有目标都可用,后者也可能只是该网站本来就能直接访问。
先执行 Connectivity Test
在 Home 使用 Connectivity Test,观察所选服务器对应的结果。测试结果可以帮助判断服务器可达性,但不同测试方法测量的对象不同,不宜把一次较小的数值理解为所有网站都会更快。若显示超时,先记录当前服务器与测试方法,再进入下一节排查,不要立刻同时修改协议、规则和 DNS。
如果订阅内有多个条目,先对当前条目完成一次测试和实际访问,再决定是否更换。切换服务器后应重新观察连接状态并重复验证,不能沿用上一条目的结论。测试期间保持网络环境稳定,避免一边切换无线网络、一边更改服务器,让失败现象失去可比较的条件。
再访问目标,并核对规则与策略
保持 Shadowrocket 连接,打开浏览器访问你自己需要使用的目标网站。先确认页面能否加载,再做一次实际操作,例如打开站内另一页;单个旧页面可能来自缓存,不能完整代表新请求的连接结果。无需把教程中的示例域名当作检测站点,示例只用于解释规则语法。
返回应用,在可用的访问记录或连接信息中查看目标请求,重点核对域名、匹配到的规则和最终策略。使用配置(Config)时,应把记录中的结果与当前规则对照:预期走代理的请求是否落到 PROXY,预期直连的请求是否落到 DIRECT。如果出现 REJECT,应先查找触发拒绝的规则,而不是直接认定服务器失效。
还可以做一次受控对照:固定目标网站和服务器,只把 Global Routing 从配置(Config)临时改为代理(Proxy),重新访问,再恢复原姿态。如果两次结果不同,优先检查当前配置和匹配路径;如果两次都失败,则继续检查服务器参数、基础网络和目标自身状态。每次只改变一个条件,结论才有定位价值。
05 按失败现象逐层排查
排查时先保留当前设置,记下失败发生在哪一步。订阅读取失败、服务器测试超时、连接授权失败、特定网站打不开,是四类不同的问题。不要用同一个“重新导入”动作处理所有情况,也不要一次性改动多个参数;每完成一次检查,就重复原来的验证动作,确认现象是否改变。
订阅无法读取或列表为空
先检查设备基础网络,必要时暂时关闭当前连接,确认普通网络访问是否正常。随后核对订阅 URL 是否完整、是否带入空格,以及你持有的链接是否仍有效。如果已有部分服务器记录,不要先删除整组;应先确认更新失败是否只是这次请求未完成。只有资料发生变化时,才按服务商最新提供的信息修改地址。
订阅链接可能包含个人访问凭据。向他人描述问题时,优先提供错误提示和操作步骤,不要直接发送完整链接或包含链接的截图。若需要服务商检查订阅状态,通过其已有服务渠道确认即可;本教程不提供替代订阅,也不以更换来源作为排查步骤。
Connectivity Test 超时或服务器连接失败
先保持当前网络不变,核对服务器地址和端口,再检查协议、认证字段、传输设置与 TLS 参数。字段看起来相似,不代表可以互换;尤其不要为了让测试通过而随意关闭身份验证相关设置。若只在某个网络环境失败,可以在另一种自己可用的网络下重复相同测试,以区分环境影响与资料错误。
同时检查 iPhone 或 iPad 的日期与时间是否准确。系统时间明显偏差可能影响证书验证或依赖时间的认证过程。更新订阅后如果服务器资料已有变化,应重新确认当前条目,再执行测试。连续点击测试不会修复错误参数;确认资料无法核实时,应保留错误信息并向自己的服务商核对。
连接已建立,但目标仍打不开
回到 Global Routing,确认没有误选直连(Direct)。如果代理(Proxy)能访问而配置(Config)不能,进入 Config 检查实际启用的配置、目标域名规则及规则顺序。请求可能命中了比预期更靠前的规则,也可能最终落入 FINAL;只看规则文件里存在某一行,不足以证明那一行被命中。
如果只有部分网站失败,还应结合访问记录检查目标域名、DNS 结果与目标服务本身是否正常。不要从“某个网站失败”直接跳到“所有连接都失败”的结论。已经改过配置时,优先恢复到最近一次验证可用的状态,再逐项恢复修改;更详细的连接与解析问题见Shadowrocket 连不上排查说明。
复查并保存可重复的操作顺序
完成修正后,按“选中服务器 → 确认 Global Routing → 打开连接 → Connectivity Test → 实际访问”重新走一遍。成功后记住使用的订阅分组、服务器名称和配置名称即可,不必记录敏感链接。以后更新订阅或修改规则,也沿用同一验证顺序,便于判断变化发生在哪一层。
到这里,首次配置的重点已经完成:连接资料、处理姿态和访问结果能够互相对应。需要继续编辑 DOMAIN、DOMAIN-SUFFIX、GEOIP 或 FINAL 时,再进入规则手册;尚未解决的错误则按具体现象阅读常见问题,不必在入门阶段同时调整所有高级设置。