Shadowrocket 使用教程

添加服务器与订阅导入

先判断手中的资料是什么，再选择入口。单台服务器资料通常包含协议、地址、端口与认证参数；单节点 URI 是把这些参数编码成一段可导入文本；服务器订阅链接则用于获取一组条目。远程配置文件还可能包含 DNS、规则与策略设置，不能仅凭链接以 https:// 开头就认定它属于哪一种。资料用途不明确时，先核对原始说明，不要在多个入口反复导入同一链接。

手动填写：Home → Add Server

打开 Shadowrocket 的 Home，点击右上角添加入口进入 Add Server。先在 Type 中选择与已有资料一致的协议，例如 Shadowsocks、VMess、VLESS 或 Trojan，再按字段填写服务器地址、端口和认证信息。不同协议的字段并不相同，不能把一种协议的参数机械填入另一种协议。地址字段通常只填主机名或地址，不额外加网页路径；端口也应与原始资料一致。

如果资料要求 TLS、传输方式、Host 或 SNI，应逐项按原值填写，不凭名称猜测，也不把显示备注当作连接参数。保存后返回 Home，确认列表中出现刚添加的条目。建议给条目设置便于辨认的备注，之后修改时仍以原始服务资料为依据。只看到条目名称不表示参数已经正确，真正的检查在后面的测试步骤完成。

服务器订阅：Add Server → Subscribe

已有服务器订阅链接时，在 Add Server 的 Type 中选择 Subscribe，将完整链接填入 URL，并设置便于区分的备注后保存。链接中的路径、查询参数和大小写都应保留，复制时检查末尾是否混入空格、换行或聊天标点。返回 Home 后等待订阅内容读取，核对是否出现对应分组及服务器条目；如果列表仍为空，先检查读取结果，而不是立即打开连接开关。

订阅保存成功与订阅内容读取成功是两件事。遇到读取失败，应确认当前基础网络可访问该链接、链接仍有效，以及返回内容属于应用支持的服务器订阅格式。链接可能包含访问凭据，应像密码一样保管，不要把完整 URL 放进公开截图、评论或求助文字。本站只说明已有资料的使用方式，不代为获取或验证私人链接。

Config 页的 Subscribe 与其他导入方式

Config 页的 Subscribe 面向远程配置文件，不等于 Home 中的服务器订阅分组。只有确认手中的链接是完整配置文件时，才在 Config 中使用该入口，按提示保存并检查配置内容；读取远程文件后，还需核对当前实际选用的配置。配置文件可能改变 DNS 和规则，首次使用前应了解来源及其处理逻辑。

已有二维码可通过 Scan QR Code 读取；已有单节点 URI 可使用应用提供的剪贴板导入提示。相机或剪贴板授权只在对应操作需要时处理，导入后仍要核对协议、服务器地址及备注。不要在手动添加、扫码和剪贴板之间重复导入同一条资料。确认 Home 至少有一个可选择的服务器后，继续选择 Global Routing。

选择 Global Routing

服务器条目决定代理连接使用哪些参数，Global Routing 决定请求按什么方式处理。回到 Home，点击 Global Routing，选择配置(Config)/代理(Proxy)/直连(Direct)中的一种。首次使用不要同时修改模式、DNS 和规则；先明确当前测试目的，再选对应模式，这样出现失败时才知道应检查哪一层。

日常按规则分流时，选择 Config，并到 Config 页确认正在使用的配置文件。规则通常自上而下匹配，命中后执行对应策略；此前未命中的请求由 FINAL 处理。配置中的 PROXY、DIRECT、REJECT 分别表达不同处理方向，而自定义策略组还要检查组内实际选择。仅把 Global Routing 改成 Config，不会自动替用户建立适合所有用途的规则。

如果当前目的是检查刚添加的服务器，可以暂时选择 Proxy，再回到 Home 选中该服务器。Proxy 模式测试成功后，再切回 Config 验证规则路径。Direct 则适合对照基础网络：如果 Direct 能打开某个网页，并不能证明服务器可用，因为该请求没有依赖所选代理服务器。测试时始终记住当前模式，避免把直接访问的结果误认成代理连接成功。

对规则还不熟悉时，先阅读功能介绍中的规则与配置说明，再逐步调整。此阶段无需叠加 On Demand 等自动触发条件；保留手动控制更容易判断连接何时开启、何时结束。选好模式并确认服务器后，再处理系统连接授权。

打开开关与系统授权

回到 Home，先点击要使用的服务器条目，确认选择标记落在预期条目上，再打开顶部连接开关。如果使用的配置包含策略组，实际出站还取决于组内选择，应同时核对。服务器名称只是备注，不能仅凭相似名称判断选中的是刚导入的那一条。

首次建立连接时，系统可能显示添加 VPN 配置的授权提示。这是 Shadowrocket 在设备上处理相关网络流量所需的系统权限，用于授权本机的 VPN 配置。阅读提示、确认应用名称后允许，并按系统要求使用设备密码或生物识别完成验证。若取消授权，返回 Home 后开关可能恢复关闭；此时应重新发起连接并处理系统提示，而不是重复添加服务器。

授权完成后回到应用，观察连接开关是否保持开启，以及是否出现连接错误。系统 VPN 标识可以作为连接状态的辅助线索，但不同设备与系统显示位置可能不同，不应把某个图标是否出现在状态栏作为唯一判断。开关刚打开就关闭时，先记录提示文字，再核对系统授权、当前配置和服务器参数。

测试期间也要留意设备是否同时启用了其他会接管网络的 VPN 配置，或存在设备管理限制。先确认当前实际生效的配置，避免不断切换造成结果混杂。应用退到后台与手动关闭连接不是同一个动作；测试结束需要断开时，应回到 Home 关闭连接，并按需检查 Settings 中的 On Demand 条件，避免误把自动重连当成开关失效。

iPad 的屏幕布局可能比 iPhone 更宽，但操作关系相同：Home 中选择条目，再控制连接开关。不要因为布局不同就重新导入全部资料。连接保持开启后，进入下一步进行实际访问和策略检查；此时还不能仅凭“已连接”得出网络可用的结论。

验证访问与规则生效

验证分三层进行：先看服务器是否可达，再看目标能否实际打开，最后看请求是否按预期策略处理。在 Home 使用 Connectivity Test，检查刚选中的服务器是否返回结果。测试结果反映特定探测条件下的可达情况，不能等同于所有网页、所有协议都可用；返回时间也不是实际下载速度，更不是服务质量的完整结论。

接着打开浏览器，访问一个熟悉且获准访问的网页，刷新后检查正文与必要资源是否加载。测试时保持同一个目标，必要时再增加一个不同目标作对照，不要同时更换服务器、网页和网络。浏览器可能展示缓存内容，因此应发起一次新的访问，而不是只看先前已经打开的页面。

如果当前为 Proxy，重点确认所选服务器路径能完成访问；如果当前为 Config，还应核对匹配规则和最终使用的策略。可在 Data 中查看本次连接记录，围绕请求时间和目标域名查找对应条目，留意记录中提供的规则与策略信息。不同记录类型展示的字段可能不同，应以实际内容为准，不能看到总流量增加就认定目标请求一定走了 PROXY。

在 Config 中，某个请求命中 DIRECT 并不一定是错误，关键在于是否符合预期。网页也可能涉及多个域名：正文成功而图片失败时，需要检查失败资源对应的请求，而不只是页面主域名。若规则决定 REJECT，目标无法打开可能正是配置的预期结果。先把“想让它怎么走”与“记录显示怎么走”对齐，再判断是否需要修改配置。

为了对比，可以记录同一目标在 Proxy 和 Config 下的结果。Proxy 可用而 Config 失败，优先检查规则、策略组与 DNS 设置；两种模式都失败，则先核对服务器及基础网络。完成对照后恢复日常预期模式，不要长期保留为排查而临时修改的设置。

常见失败点检查顺序

出现问题时，先保留当前现象：是订阅读取失败、开关立即关闭、Connectivity Test 未返回结果，还是只有特定网页打不开。不同现象对应的检查入口不同。每次只改变一个条件，重试相同目标并记下结果；一次替换整份配置虽然可能改变现象，却容易失去定位依据。

先检查基础网络与服务资料

先关闭连接，确认设备自身网络可用。若处于需要登录确认的 Wi-Fi 环境，应先完成该网络的登录步骤。基础网络尚未建立时，重复更新订阅或重填服务器通常不能解决问题。必要时在自己可使用的另一种网络条件下复测，判断故障是否只出现在当前网络。

基础网络正常后，核对服务器地址、端口、协议、认证字段及 TLS 相关参数。订阅曾成功读取但后来不可用时，按应用提供的更新操作重新读取已有订阅，检查更新是否实际完成，以及条目是否发生变化。更新失败时保留原有可核对的信息，不要立即删除整个分组；链接有效性、账户状态或服务器状态，应通过用户自己的服务渠道确认。

再检查模式、DNS 与规则

确认 Global Routing 没有停在 Direct，也没有把预期直连的请求意外交给代理路径。使用 Config 时，检查当前选用的文件、策略组选择和 FINAL。若 Proxy 正常、Config 异常，优先查目标请求命中的规则，而不是重新安装应用。规则顺序也很重要：更早命中的宽泛规则可能使后面的细分规则没有机会执行。

DNS 问题可能表现为服务器测试有结果，但目标域名无法解析或页面资源只加载一部分。先检查当前配置是否设置了自定义 DNS，以及相关地址在当前网络条件下是否可达。不要同时启用多个尚未理解的 DNS 选项，也不要仅凭某个地址形式就判断它一定更合适。调整前记下原设置，测试无改善时及时恢复。

最后处理单一目标与自动连接问题

只有某个目标失败时，区分连接超时、解析失败、服务返回错误和访问权限提示。能收到目标服务的错误响应，与根本没有建立连接不是同一层问题；账户登录或目标服务自身状态，也不应一律归因于代理。结合 Data 中相同时间的记录，针对失败请求检查，不用一个页面的结果代表所有连接。

如果手动关闭后又自动连接，检查 Settings 中的 On Demand 及相关触发条件。排查时可暂时关闭自动触发，确认手动连接行为正常后再恢复。若系统授权或商店获取环节仍有疑问，查看App Store 安装与账号指南；该指南系统说明购买、设备兼容性核对与已购恢复，不需要在网络排查中重复处理这些步骤。

完成排查后，回到Global Routing 选择步骤恢复预期姿态，再按生效验证步骤重测。需要进一步拆分“已连接但无法上网”的现象时，可继续阅读服务器、模式、DNS 与规则排查笔记。求助时只提供必要的错误文字和已尝试步骤，隐藏订阅链接、密码、认证参数及其他私人信息。