Shadowrocket 使用教程

步骤 01 / 准备 SERVER 列表

添加服务器或导入 Subscribe

打开 Shadowrocket 后进入 Home。首次使用时，SERVER 区域可能还没有服务器；这是尚未添加连接信息的状态，不表示安装失败。先判断手中资料是哪一种：能够返回一组服务器信息的订阅链接，或者包含协议、地址、端口与认证信息的单个服务器参数。两种方式选择其一即可，不需要把同一份资料反复添加。

已有订阅链接：使用 Subscribe

在 Home 点击右上角的加号，进入 Add Server，打开 Type 并选择 Subscribe。在 URL 字段粘贴从你的服务商处获取的完整订阅链接；如果界面提供 Remark，可以填写便于辨认的名称。保存前检查链接开头、结尾和查询参数，尤其注意复制时混入的空格、换行或聊天文字。不要把用于登录管理页面的地址当作订阅地址。

确认后点击 Done 保存，等待获取订阅内容，再返回 Home 查看结果。成功的结果应当是出现订阅分组及其服务器条目，而不只是留下一个名称。如果分组存在但没有服务器，先确认网络能否访问订阅地址、链接是否仍有效，以及返回内容是否为应用支持的订阅格式。此时重复点击顶部连接开关不能补齐订阅内容，应先解决导入环节。

订阅链接可能包含访问凭据，应按账号信息保管。不要公开完整链接，也不要把链接粘贴到不明页面进行转换。后续需要更新时，针对已有订阅执行更新即可；重新添加同一链接容易形成重复分组，使当前选中的服务器和实际维护的分组难以区分。

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

如果手中是单个服务器信息，同样从加号进入 Add Server，先选择正确的 Type，再填写对应字段。Shadowsocks、VMess、VLESS、Trojan 等协议使用的认证与传输参数并不相同，不能只填写 Address 和 Port 后就认为设置完成。地址、端口、密码或 UUID，以及 TLS、Server Name、传输方式等项目，都应与现有服务器信息逐项对应；服务商未说明的选项不要凭猜测改动。

保存后回到 Home，确认 SERVER 列表已经出现目标条目。若已有可识别的二维码，可使用 Scan QR Code 导入；扫描后仍要检查 Type、地址和关键参数是否与资料一致，不能仅凭名称判断。至此只完成了信息录入，还没有开始连接。下一步先确定 Global Routing，避免把路由选择问题误认为服务器不可用。

步骤 02 / 决定请求路径

选择 Global Routing 三种姿态

回到 Home，点击 Global Routing，查看当前选中的姿态。这里决定请求如何分配，并不负责提供服务器，也不会替代服务器认证。本文统一使用配置(Config)、代理(Proxy)、直连(Direct)这三种写法；操作时以界面里的 Config、Proxy、Direct 为准。选择后返回 Home，再次查看 Global Routing 的当前值，确认修改已经生效。

首次验证可先用 Proxy

还没有准备规则配置时，可以临时选择代理(Proxy)，先把问题缩小为“当前服务器能否完成连接”。这样做是排查顺序，不代表日常使用必须保持这一姿态。即使处于 Proxy，仍应结合实际请求验证结果，不要把它理解为所有系统流量在任何条件下都采用完全相同的路径。

如果已经有可用配置，并希望按域名或地址分流，则选择配置(Config)。需要区分两个名称相近但职责不同的入口：Global Routing 中的 Config 是路由姿态，应用中的 Config 页面用于管理配置文件。导入 Subscribe 后得到服务器列表，并不等于已经获得适合自己需求的规则配置；两者应分别检查。

使用 Config 时确认生效配置

进入 Config 页面确认准备使用的配置已经设为当前配置，再回 Home 选择 Config。规则按顺序匹配，请求命中哪一条、该条引用什么策略，都会影响最终路径。不要为了首次连接就批量粘贴不熟悉的规则。有关规则顺序、策略引用和 DNS 的系统说明，见完整手册；本页先完成可重复的连接测试。

直连(Direct)可以作为基础网络对照：如果切换为 Direct 后某个本来可直接访问的网页仍然打不开，应先检查本机网络，而不是继续修改服务器参数。确定好姿态后，进入下一步选择具体服务器并开启连接。

步骤 03 / 选择与授权

选中 SERVER，再打开连接开关

在 Home 的 SERVER 列表找到本次准备测试的服务器，点选条目前方的圆点，确认选中标记落在目标条目上。服务器名称只是备注，不能证明其参数、可用状态或实际路径。首次测试最好固定一个已知信息完整的条目，不要在没有记录的情况下连续切换多个服务器，否则后续很难判断哪一次设置对应哪一次结果。

先选中条目，再启用连接

检查 Global Routing 与所选服务器后，打开 Home 顶部的连接开关。未连接时可以看到 Not Connected 等状态提示；启用后等待状态更新，观察是否能够保持连接。打开服务器详情用于修改参数，与点选前方圆点用于选择当前服务器，是两种不同操作。若刚才只进入详情页查看却没有选中条目，实际连接可能仍使用之前的服务器。

使用配置(Config)时，还要注意规则可能引用特定策略或策略组，未必所有请求都使用 Home 中刚点选的条目。若目的是单独验证这台服务器，先临时采用代理(Proxy)完成对照，再切回 Config 检查分流。连接期间不要同时修改服务器参数、配置文件和 DNS，避免一次变更引入多个不确定因素。

理解添加 VPN 配置的系统提示

首次启用时，系统可能询问是否允许 Shadowrocket 添加 VPN 配置。这是让应用通过系统网络机制处理流量所需的连接授权，与用户已有的订阅资料无关。确认提示由当前主动操作触发、应用名称为 Shadowrocket 后，选择允许，并按系统要求完成设备认证。授权结束后回到应用，查看顶部开关和连接状态是否稳定。

如果此前取消了系统提示，不要通过反复导入订阅解决；服务器资料与系统权限是两个环节。可以再次尝试启用连接，按系统提示检查 VPN 配置与权限。设备受到管理策略限制时，应先确认管理要求。也应避免让其他 VPN 连接同时争用系统通道，测试期间只保留本次需要的连接。

系统出现 VPN 状态标识，或应用开关保持开启，只能说明连接通道已启动，不能单独证明目标网站可访问、认证正确或规则命中符合预期。完成授权后先不要继续加规则，直接进入验证步骤，用实际请求确认结果。

步骤 04 / 检查实际结果

运行 Connectivity Test 并验证分流

连接状态稳定后，在 Home 点击 Connectivity Test，等待测试完成并查看界面反馈。这个测试提供的是某个测试目标与当时网络条件下的结果，可以帮助识别明显的连接失败，但不能代表所有网站、所有协议或所有应用都已正常。测试成功后仍需执行一次真实访问，测试失败时也需要结合失败范围判断原因。

使用同一目标做连接前后对照

打开浏览器，访问一个本次确实需要使用、且已知地址正确的网页，观察页面主体和必要资源是否能够加载。如果只是旧页面仍然可见，可能读取了缓存，不能算作新的连接证据。可以重新加载页面，或进入同一服务的新页面，确保产生了实际请求。对有登录要求的服务，还应区分网络请求失败与账号权限提示。

建议先固定网络、服务器和测试目标，只改变一个设置。例如在同一服务器下比较 Proxy 与 Config，或者保持 Proxy 不变更换另一个已有服务器。这样得到的对照才有定位价值。不要同时切换 Wi-Fi、替换服务器、修改 TLS 并更新配置后，再试图从一次结果中判断故障来自哪里。

Config 的验证要看规则和策略

如果准备日常使用配置(Config)，在基础连接可用后切回该姿态，再重复相同访问。进入应用提供的请求记录或诊断入口，检查目标域名、命中规则与最终策略是否符合预期。某个网页能够打开，并不一定说明它经过了代理；它也可能按规则采用 DIRECT。反过来，某条规则写了 PROXY，也需要确认该策略确实引用可用的服务器。

Data 页面中的上行、下行流量可以作为辅助观察，但读数增加不等于某个特定请求已按预期分流。后台活动也会产生流量。更可靠的做法是把操作时间、测试目标与对应记录对齐，再查看该条请求的处理路径。需要分析规则细节时转到完整手册，无需在首次上手阶段同时调整所有统计与诊断设置。

如果 Connectivity Test、真实访问和预期分流都已得到确认，可以保留当前设置。后续修改前记下这组可用条件：使用的网络、服务器备注、Global Routing 姿态以及当前配置。若仍有失败，按下面的顺序排查，不要先删除全部配置重新开始。

步骤 05 / 每次只排除一个变量

按失败环节检查常见问题

先描述现象发生在哪一层：订阅没有导入、连接开关无法保持、测试失败，还是只有部分网页异常。不同现象对应不同检查点。排查时保留原有可用信息，每次只修改一项，然后重复相同测试。这样即使问题没有解决，也能知道刚才的修改是否产生了影响。

导入后没有服务器：先查订阅内容

如果 SERVER 列表为空，返回订阅设置核对 URL 是否完整，以及是否误用了账户管理页面地址。确认本机基础网络正常，再对已有订阅执行更新。订阅地址可能有效但返回的是错误提示页面，也可能需要由你的服务商确认访问状态或格式。客户端购买记录、VPN 权限与订阅返回内容互不替代，此阶段不要通过调整 Global Routing 来处理空列表。

开关无法保持：先查权限与参数

若开启后立即停止，先查看应用提示，再确认系统 VPN 配置授权是否完成、设备管理是否有限制，以及是否存在其他正在使用的 VPN 连接。接着核对当前服务器的 Type、Address、Port 和认证信息。TLS、Server Name、传输路径等项目只有在资料明确要求时才按对应值填写，留空和填错并不等价。设备日期与时间明显不正确时，也可能影响证书验证，应先恢复正确时间。

能够连接但测试失败：分开检查网络与服务器

先停止连接，确认设备的基础网络能够正常访问已知可达的网页。如果 Wi-Fi 需要网页认证，应先完成认证。基础网络正常后重新开启连接，保持 Proxy 与同一测试目标不变，再观察结果。若手中已有其他服务器，可在其余条件不变的情况下换一个条目对照；不要仅凭一次失败就判断所有服务器信息都需要重建。

如果记录中出现认证、连接超时或证书相关信息，应将这些现象与现有参数对应检查。不要为了消除提示随意关闭证书验证或放宽安全设置。无法确认的服务器端要求，应从你的服务商处获取准确说明，再回到对应字段修改。

Proxy 可用而 Config 异常：先查分流

相同网络、服务器与目标下，Proxy 可用而 Config 不可用，通常应优先检查当前配置、规则顺序、策略引用和 DNS，而不是重新购买客户端。先确认 Config 页面选择的是预期文件，再查看异常请求命中了哪一条规则，是否被送到 DIRECT、REJECT 或不可用策略。规则检查应从实际命中项开始，不要批量删除看不懂的行。

如果只有一个服务异常，还要区分它是否包含多个域名、是否使用独立登录接口，以及是否受账号状态影响。DNS 设置不一致也可能造成域名解析与连接结果不一致，但首次排查不宜同时叠加多套 DNS 方案。更多按现象分类的说明见FAQ；需要系统理解配置文件与日常维护时，继续阅读完整手册。

到这里，首次设置的闭环是：SERVER 中有有效条目、Global Routing 与目标一致、系统授权完成、连接保持稳定、实际请求通过验证。以后出现异常时，沿同一顺序回查，通常比反复删除和重新导入更容易找到变化发生的位置。