Shadowrocket 快速上手

01 · Add Server / Subscribe 导入资料

打开 Shadowrocket，先进入 Home。这里用于查看与选择服务器；Config 则用于管理配置文件，两者作用不同。订阅导入完成后，应当先在 Home 中看到服务器条目，而不是仅在 Config 中看到一个文件名。根据手头资料选择下面的一种方式，首次操作不必把同一份资料重复导入。

已有订阅链接：选择 Subscribe

在 Home 点击右上角的添加入口，进入 Add Server。打开 Type，选择 Subscribe，再把自己的完整订阅链接填入 URL 字段。名称或备注用于区分来源，可以填写容易识别的文字；不要把备注当成认证字段。保存后等待内容读取，返回 Home，检查订阅分组及其服务器是否已经出现。

粘贴前先确认拿到的是订阅地址，而不是账户页面、说明页面或某条服务器分享链接。复制时容易漏掉地址末尾的参数，也可能带入换行、空格或聊天消息中的标点。保留原地址中的大小写和参数，不要凭感觉删掉查询部分。订阅下载成功表示客户端读到了内容，并不等于其中每台服务器都能建立连接。

订阅是一份可更新的服务器列表。后续需要更新时，在 Home 找到对应订阅条目，进入其编辑或操作入口执行更新；应当更新原有条目，而不是每次重新添加一个同名订阅。更新后再检查当前选中的服务器是否仍在列表中。若读取失败，先保留已有条目，再核对链接与网络，不要立即清空全部资料。

已有单台服务器信息：核对 Type 与字段

同样从 Home 进入 Add Server，先在 Type 中选择与你的服务器信息一致的协议。随后逐项填入地址、端口及该协议要求的认证信息。不同协议显示的字段不同：密码、UUID、TLS、传输方式等不能相互替代。地址栏填写服务器地址，不要把端口、路径和整段分享文本一起塞进同一个字段。

如果已有适用于 Shadowrocket 的完整分享链接，可使用应用提供的导入入口；如果已有二维码，可使用 Scan QR Code，并在系统询问时按需允许相机访问。导入后仍应进入条目检查 Type、地址、端口和认证字段。自动读取只减少手工输入，不会替你判断服务器资料是否过期，也不能保证传输参数与服务器端一致。

保存后回到 Home，确认出现可选择的服务器名称。名称只用于辨认，真正决定连接的是条目内部的参数。至此完成的是“把资料放进客户端”，还没有决定请求如何路由。下一步先选择 Global Routing，再打开连接开关。有关订阅、分享链接和配置文件的区别，见术语表。

02 · Global Routing 选择模式

在 Home 找到 Global Routing，打开后选择本次需要的姿态。三种写法为配置(Config)/代理(Proxy)/直连(Direct)。它们改变的是请求采用的路由方式，不是三个不同的服务器。切换模式不会自动修正服务器地址或认证字段，也不会让失效的订阅恢复。

配置(Config)：按当前配置判断策略

配置(Config)用于依据当前配置处理请求。进入 Config 页面，确认需要的配置已被选中，而不只是已经出现在文件列表中。回到 Home 再确认 Global Routing 为 Config。初次使用如果尚未准备规则，先不要导入多个来源不明的配置来回切换；应当先确认当前配置的用途，再决定是否使用它。

规则中常见的 PROXY、DIRECT、REJECT 分别表示使用代理策略、直接连接和拒绝请求。具体请求是否经过服务器，取决于匹配到的规则与策略安排，因此 Config 下有的请求直连是正常结果。不能只因为某个网页可以打开，就认定所有请求都使用了代理；也不能把一次直连结果直接判断为配置失效。

代理(Proxy)：先验证所选服务器

代理(Proxy)可用于初次验证：在 Home 选好自己的服务器，再将 Global Routing 设为 Proxy，减少规则分流对判断的干扰。这是排查方法，不代表所有使用场景都应长期保持该模式。应用及系统保留的必要例外仍可能影响部分请求，不应把 Proxy 理解为设备上每一类通信都采用完全相同的路径。

若 Proxy 下可以正常访问，而 Config 下失败，下一轮应检查当前配置、规则匹配和 DNS，而不是立即重新填写服务器密码。验证结束后恢复日常需要的模式，并记录使用的是哪个配置。这样可以把“服务器是否可用”和“规则是否符合预期”分开处理。

直连(Direct)：作为原始网络的对照

直连(Direct)让请求按直接连接方式处理，适合检查当前网络本身是否能访问目标。选择 Direct 后服务器仍可能保留在 Home 列表里，但有条目并不表示请求正在使用它。比较时使用相同网络、相同目标和相近时间；切换网络后再比较，结果可能同时受到网络变化影响。

完成模式选择后，不必继续调整高级字段。先返回 Home 确认模式文字，再进入下一步。配置文件的 General、Rule、Host 与 URL Rewrite，以及规则顺序的详细说明，放在配置字段参考中；本页只保留首次连接需要的判断。

03 · Home 打开连接

返回 Home，点击本次要使用的服务器条目，确认它处于选中状态，然后打开连接开关。若订阅内有多台服务器，首次先测试一台，避免在同一轮验证中反复切换。需要修改条目时先停止连接，再编辑并保存，之后重新选择该条目建立连接。

首次出现添加 VPN 配置提示

首次打开连接开关，系统可能请求允许 Shadowrocket 添加 VPN 配置。核对提示中的应用名称，允许后按系统要求完成设备验证，再返回 Shadowrocket 查看状态。这项授权允许应用建立用于网络处理的系统连接；它不是购买确认，也不会导入订阅或补齐服务器信息。

如果之前取消了授权，连接可能无法完成。重新打开开关，按实际出现的系统提示处理；若提示不再出现，可到系统设置中的 VPN 管理位置检查 Shadowrocket 对应条目。系统设置路径与界面布局可能随系统而变化，不需要为了寻找某个固定菜单名称随意删除其他配置。

iPad 上操作顺序相同：先选服务器，再开连接，再处理系统授权。横屏或不同设备布局可能使入口的位置有所变化，应按 Home、Global Routing、Config 等界面词定位，不要仅凭按钮在屏幕上的左右位置判断功能。

区分开关状态与实际可用性

开关保持开启、系统出现 VPN 标识，说明连接配置处于相应状态；这并不是服务器认证成功、DNS 正常和全部网页可访问的共同证明。某些失败只有在真正发起请求时才显现，因此下一步必须进行实际访问验证。若开关刚打开就自动关闭，则先处理授权或连接建立问题，不要直接开始改 Rule。

首次连接阶段暂时不配置 On Demand。它用于根据条件触发连接，不是手动连接成功的前提。如果此前已设置相关条件，注意它可能在切换网络或手动断开后重新触发连接。排查期间先核对这些条件，再观察手动开关的结果；等手动流程稳定后，再单独设置和验证自动触发行为。

04 · Connectivity Test 验证生效

完成连接后，先检查所选服务器，再检查实际网页。进入应用的 Connectivity Test，确认测试对象是本次选中的条目，观察返回的测试结果。列表中某个条目有结果，不代表当前连接一定选中了它；尤其在订阅更新或切换服务器后，应回到 Home 再确认一次。

先看测试结果，再发起真实请求

Connectivity Test 可以帮助判断测试请求是否得到响应，但其结果受测试方式、测试目标和当前网络影响。测试超时值得进一步核对，测试成功也不能替代浏览器验证。不要把测得的时间当成所有应用的实际访问速度，也不要仅凭一次结果删除服务器条目。

打开 Safari，访问你熟悉、允许访问且当前能够用来核对的网页，检查页面正文及必要资源是否完整加载。最好准备两个不同站点，避免把单个站点的维护或访问限制误判为客户端故障。保持当前网络不变，重新加载页面，而不是只看已经打开的旧标签页；浏览器缓存可能让旧内容看起来像新请求已经成功。

如果网页正常，继续确认结果是否符合 Global Routing 的选择。Proxy 下用于检查服务器路径，Direct 下用于检查原始网络，Config 下则要结合规则判断。Config 允许部分目标直接连接，所以“页面打开”与“页面经过代理”是两个不同问题。需要核对分流时，查看对应请求记录中实际使用的策略，再与配置预期比较。

用相同条件建立对照

遇到结果不清楚时，记录当前服务器、Global Routing、选中配置和测试目标。停止连接后检查相同目标在原始网络中的表现，再重新连接进行比较。每一轮只改变一个条件，才能判断服务器、模式或网络是否与问题有关。不要一边换服务器、一边换网络、一边改 DNS 后再只记录“好了”。

完成验证的标准不是单独看到某个标识，而是：所选服务器与预期一致，模式与用途一致，实际请求能够完成，Config 下的策略也符合规则安排。达到这些条件后，可以保留当前设置继续使用。若需要进一步配置分流，转到Rule 配置参考；如果仍失败，按下一节定位，不必从安装步骤重新开始。

05 · 常见失败点 逐项排查

先确定问题发生在哪一层：订阅还没有读入、连接开关不能保持开启，还是开关已经开启但网页失败。三种情况需要的检查不同。保留可以正常工作的条目和原配置，修改前记下原值；每修正一项，就重复上一节的测试，不要一次覆盖全部设置。

Subscribe 读取失败或列表为空

返回 Home，进入对应订阅的编辑入口，检查 URL 是否完整，尤其是末尾参数、空格与换行。确认链接仍然有效、内容是可识别的服务器订阅，而不是账户登录页面或网页说明。能够在浏览器打开一个地址，并不代表返回内容符合订阅格式；包含认证信息的链接也不应拿到公开工具中测试。

如果原始网络能够读取订阅，优先在该网络条件下完成更新。若读取需要特定连接条件，应先使用自己已有且可用的服务器，再按应用当前设置尝试更新。不能把“尚未读入的服务器”当作获取同一订阅的前提。链接有效性、账户状态及服务器资料有疑问时，向你已有服务的提供方核实，本站不提供替代订阅。

开关立即关闭或无法建立连接

先核对系统 VPN 配置授权，再确认 Home 中确实选中了可用条目。进入条目检查 Type、地址、端口与认证字段是否对应原资料。对于带 TLS 或传输设置的协议，核对服务器名称、路径及其他指定参数；不要通过关闭证书验证来绕过未知错误，也不要把其他协议的参数照搬进当前条目。

如果系统中另一个 VPN 连接正在使用，先停止该连接，再单独测试 Shadowrocket，以免把连接接管或状态切换误判为服务器失败。检查设备日期与时间是否正常；明显不正确的时间可能影响安全连接。修改后重新建立连接，再观察状态是否保持，仍不能保持时优先继续检查连接层而非分流规则。

开关已开启，但全部目标都无法访问

先用 Direct 或停止连接的方式核对原始网络。如果原始网络本身失败，先处理 Wi-Fi、蜂窝网络或当前网络的登录要求。原始网络正常时，选定一台自己的服务器，用 Proxy 进行对照，并执行 Connectivity Test。若这两项均失败，重点检查服务器可用性、认证信息与传输参数。

若测试有结果但浏览器失败，再检查 DNS 设置与实际目标。过时的自定义 DNS 设置可能影响域名解析；先记录原值，再与已知正常的设置对照。不要仅凭网页打不开就认定是 DNS，也不要随意叠加多个自定义地址。完整的 DNS 处理方式涉及 General 与其他配置项，可继续阅读配置字段参考。

Proxy 正常，Config 失败或只有部分目标失败

进入 Config 确认当前选中的是哪份配置，再检查相关 Rule。规则通常按顺序判断，范围较大的规则放在前面，可能先于后面的具体规则命中；FINAL 应用于末尾兜底。还要确认命中的策略是 PROXY、DIRECT 还是 REJECT，而不是只查看规则里是否出现了目标域名。

只有部分站点失败时，同时考虑目标自身状态、网页涉及的其他域名和当前网络条件。不要为了一个页面立即把全部请求改成同一策略。用相同目标比较 Proxy 与 Config，并查看实际请求记录，可以缩小问题范围。DOMAIN-SUFFIX、IP-CIDR 与 FINAL 的含义见术语表，完整写法与顺序见Rule 配置参考。

整理复现信息，再继续定位

记录设备类型、当前网络、Global Routing、故障发生的步骤，以及“全部失败”还是“部分失败”。需要分享错误信息时，遮去订阅 URL、密码、UUID 和其他认证内容；保留协议类型、错误文字和已经完成的检查即可。配置中也可能带有私人地址，分享前逐项检查，而不是只遮住服务器名称。

最后恢复排查期间临时修改的模式与设置，重新选中日常需要的服务器和 Config，再做一次实际网页验证。如果问题仍在，继续按已确认的失败层定位。首次连接只需要把资料、路由、授权与请求结果串起来；规则优化、On Demand 和更多配置字段，应在这条基础流程稳定后逐项添加。