Shadowrocket 使用说明
订阅导入与首次连接

STEP 01 / HOME

添加服务器 / 导入已有订阅

打开 Shadowrocket，先进入底部的 Home。这里显示可选的服务器及连接入口。点击右上角加号进入 Add Server，再根据已有资料选择 Type。订阅和单个服务器最终都需要在 Home 列表中形成可选择的条目，但它们的录入字段并不相同。

已有订阅链接：选择 Subscribe

在 Add Server 中将 Type 设为 Subscribe，把自己的完整订阅链接粘贴到 URL。粘贴后检查链接开头、结尾以及查询参数是否完整，避免带入聊天内容、换行或额外空格。备注可以填写便于自己识别的名称，不影响服务器实际参数。确认后使用页面上的保存操作，返回 Home，等待订阅内容读取完成。

订阅链接是用于取得和更新服务器列表的地址，不是普通网站首页，也不一定能在浏览器里直接显示为可读文字。不要为“看起来像网址”而删掉其中的参数。链接可能包含个人访问凭据，不应公开粘贴到问答、截图或共享文档中；需要排查时，描述错误提示即可。

回到 Home 后，检查订阅分组下面是否出现服务器条目。只出现订阅名称但没有服务器，不能视为导入完成；应先确认当前网络能够读取订阅、链接仍有效、返回内容能被识别。订阅更新失败与某个服务器连接失败是两个阶段的问题，不要在列表尚未生成时反复切换路由姿态。

已有单个服务器：按 Type 填写

如果你已有地址、端口及认证信息，在 Add Server 的 Type 选择资料对应的协议类型，再逐项填写。地址与端口应分别输入；认证内容可能是密码，也可能是协议要求的其他字段。涉及加密方式、TLS、传输方式或其他附加参数时，以原始资料为准，不凭名称相似就替换选项，也不要套用另一种协议的字段。

如果原始资料提供的是二维码，可以使用 Scan QR Code 读取；完成后仍要检查识别出的 Type、地址和端口，而不是看到条目名称就立即连接。手动输入时尤其注意数字与字母、全角标点及复制时的尾部空格。保存后回到 Home，确认服务器条目存在，再进入下一步。

STEP 02 / GLOBAL ROUTING

选择 Global Routing 姿态

在 Home 找到 Global Routing 并打开。这里决定请求按什么路径处理，与服务器列表中“选哪一个服务器”不是同一个设置。先理解配置(Config)、代理(Proxy)、直连(Direct)的区别，再根据本次操作目的选择；不要把切换姿态当成修复错误参数的方法。

使用 Config 前，先确认配置

准备按规则分流时，进入底部 Config，确认当前选中的配置是哪一份。导入订阅并不等于同时取得了适合自己的完整规则文件，服务器列表与规则配置需要分别确认。如果你已有配置文件，应先核对其来源与内容，再选中使用；首次操作不必为完成连接而随意导入陌生配置。

Config 会依据当前配置判断请求是交给 PROXY、使用 DIRECT，还是执行其他规则动作。因此，同一个服务器在 Proxy 下可以访问某个页面，在 Config 下却可能走另一条路径。这不必然说明服务器故障，要继续检查该请求匹配了什么规则。规则关键字与更细的匹配逻辑可在协议参考及功能介绍继续阅读。

用 Proxy 与 Direct 做单项对照

如果尚不确定是服务器还是规则问题，可以临时选择 Proxy，配合下一步的默认服务器测试；需要确认当前网络直接访问是否正常时，则临时选择 Direct。测试结束后切回自己需要的姿态。Direct 并不表示“仍通过所选服务器但速度不同”，也不能用它来证明代理路径已经生效。

选定后返回 Home，再看一遍 Global Routing 当前显示的值。不要一次改变姿态、服务器、DNS 和配置文件：若结果变化，将很难知道是哪项设置起作用。日常需要规则分流时使用 Config，前提是当前配置的规则确实符合你的使用目的。

STEP 03 / VPN

选默认服务器，打开连接开关

回到 Home，在列表中找到准备使用的服务器，点击其左侧圆点，将其设为默认服务器。先观察选择状态是否已经改变，再操作顶部连接开关。点击服务器名称可能进入详情或其他操作，因此不要仅凭“刚点过这一行”就认为默认项已经切换成功。

订阅里有多个条目时，先选一个参数完整、你确认仍可使用的服务器完成首次连接。不要在系统授权弹窗出现的同时连续点选其他条目。默认服务器与 Global Routing 要一起检查：服务器决定代理路径的目标，姿态决定请求何时使用这条路径，两者缺一不可。

允许系统添加 VPN 配置

打开 Home 顶部连接开关。首次建立连接时，系统可能提示 Shadowrocket 请求添加 VPN 配置。确认提示对应当前操作后选择允许，并按设备要求完成密码或其他身份验证。这个系统授权用于建立本机的网络配置，不是要求填写服务器密码；服务器认证信息应在 Add Server 对应字段中设置。

完成授权后回到 Shadowrocket，检查开关是否保持开启，以及是否出现连接失败提示。如果之前拒绝过授权，应重新尝试连接并按系统提示处理；必要时到系统设置中的 VPN 管理位置检查已有配置。不要为了排查而批量删除设备上的其他网络配置，尤其是由单位或设备管理设置的项目。

系统显示 VPN 状态，只能说明本机的 VPN 配置正在工作，不能单独证明远端服务器可用，也不代表每个请求都经过代理。类似地，开关保持开启与浏览器能否正确访问是两个需要分别确认的结果。现在先保留当前服务器与姿态，进入下一步做连接验证。

STEP 04 / CONNECTIVITY TEST

验证连通性与实际访问结果

保持连接开关开启，在 Home 使用 Connectivity Test，观察当前服务器对应的结果。测试完成需要一定时间，先等待结果稳定，不要在测试进行时连续切换网络或默认项。如果列表中测试了多个服务器，注意区分正在使用的默认服务器与其他条目，不能把别的条目测试成功当成当前连接成功。

Connectivity Test 用来检查特定测试条件下的连通性，不是所有应用、所有域名或全部传输方式的完整证明。结果异常时，要结合实际访问一起判断；结果正常时，也仍需确认当前 Global Routing 的行为。不要只根据一个数值选服务器，更不要把测试结果等同于真实下载速度。

再用浏览器完成一次实际请求

切换到浏览器，访问一个你已知正常的页面，确认页面能够加载。随后按自己的需求测试另一个目标，避免仅依据缓存页面判断连接生效。观察时记录当前网络、默认服务器和 Global Routing，不必同时打开大量应用做测试；先让结果可复现，再增加测试范围。

如果 Proxy 下可访问，而 Config 下某个目标失败，优先检查当前配置的匹配规则与 DNS 行为，不急着删除全部服务器。如果 Direct 下同样无法访问普通页面，则先确认 Wi-Fi 或蜂窝网络本身是否可用。切换网络前记下原状态，切换后重新进行一次相同测试，避免把网络变化和服务器变化混在一起。

区分三个完成标志

1. 本机连接建立：顶部开关保持开启，系统授权已经完成。
2. 服务器可达：当前默认服务器的测试与实际代理请求有一致、可解释的结果。
3. 规则符合预期：使用 Config 时，需要代理或直连的请求按配置中的规则处理。

前两项成立后，再处理第三项，排查范围会更清楚。一次测试失败不应直接归因为协议类型；实际网络、认证参数、服务器状态与配置规则都可能影响结果。确认能够稳定复现的现象后，再按下一节的顺序定位。

STEP 05 / CHECKLIST

按失败阶段检查，不重复重装

连接失败时，先确定失败发生在哪一步，再修改对应设置。重新安装会让你重新经历导入与授权，并不自动修正订阅失效、认证错误或规则匹配问题。每次只改一个条件，做同一项测试，并记下变化；这样才容易缩小原因范围。

列表为空：回到导入阶段

如果 Home 没有服务器，先检查是否保存了 Add Server 中的内容。订阅条目存在但分组为空时，核对 URL 的完整性以及订阅是否还能正常读取，查看应用给出的错误提示。不要反复添加同一链接形成多个重复分组；保留一个可识别的分组，确认更新结果即可。涉及订阅权限或返回内容的问题，应向你已有服务的信息提供方确认，不公开完整链接。

开关无法保持：检查授权与本机状态

如果一开启就关闭，先确认是否完成系统添加 VPN 配置的允许操作，并检查当前设备是否已有其他正在工作的 VPN 配置。设备受管理或系统设置存在限制时，按设备管理要求处理。若应用给出明确提示，记录提示原文，比单纯描述“连不上”更有助于定位；不要在未理解影响时删除系统网络项目。

开关已开但请求失败：核对服务器参数

确认左侧圆点选中的确实是准备使用的服务器，重新核对 Type、地址、端口及认证字段。需要 TLS 或其他传输参数的服务器，还应逐项与原始资料对照。订阅中有其他你已知有效的条目时，可以只替换默认服务器做对照；如果全部失败，再检查当前网络和订阅状态，不要同时修改所有条目的参数。

只有部分目标失败：检查姿态与配置

先看 Global Routing 是否误设为 Direct，再确认 Config 中选中的配置。临时切到 Proxy 后重复同一请求，可以帮助区分代理路径与规则匹配问题，但测试结束应恢复需要的姿态。若只有域名访问异常而其他测试表现不同，再进一步检查 DNS；不要一开始就同时替换多个 DNS 设置。更完整的分流与连接问题见问答与故障排查。

向信息提供方反馈时，可描述设备系统、所选协议、失败阶段、错误提示以及切换网络后的结果。密码、完整订阅链接及其他认证内容应保密。首次连接稳定后，再依次整理服务器备注、确认 Config、设置 On Demand；每新增一项设置都做一次验证，保持配置过程可追踪。