Official Manual / Quick Start

Shadowrocket 使用教程

从已有资料开始，依次完成导入、模式选择、连接与验证。本页只讲首次使用需要走通的操作；规则原理与 Settings 的完整参考另见设置手册。

完成标准不是“开关已打开”，而是资料已保存、模式符合需求、测试目标可访问，且请求使用的策略与预期一致。首次设置时先走通一个服务器，再整理其他条目，便于判断问题出在哪一步。

Step 01 / Add Server

添加服务器或导入 Subscribe

打开 Shadowrocket 后进入 Home，在 SERVER 分组附近找到 Add Server。先判断手上的资料属于哪一种：如果是一条用于获取服务器列表的订阅链接，走 Subscribe；如果是服务器地址、端口、协议和认证信息，走手动添加。两者都是把已有资料存入客户端，不会因为保存操作而自动生成新的服务。

已有订阅链接：选择 Subscribe

进入 Add Server，点开 Type 并选择 Subscribe，把已有的完整订阅链接填入 URL，再保存。粘贴后检查开头、结尾和查询参数，尤其留意复制时带入的空格、换行或缺失字符。订阅地址往往包含访问凭据，不要把它当作普通网页地址公开分享，也不要将整条地址发到公开讨论区。

返回 Home 后，等待订阅内容加载；如果显示了订阅分组但尚未出现服务器条目，使用该分组提供的更新操作，并查看是否出现失败提示。能保存 URL 只说明输入被接受，不表示远端内容已成功获取。出现错误时先检查原始链接是否完整、当前网络能否获取内容，以及已有服务是否仍有效，不要连续重复添加相同订阅。

已有单台服务器信息：逐项填写

在 Add Server 中按资料选择正确的 Type，再填写 Host 与 Port。页面会根据协议显示不同字段，截图中的 Password、Method 只是其中一种表单示例，不是所有协议都使用相同项目。把服务资料中的认证方式、加密方式及其他必要参数逐项对应；不要凭相似名称选择协议，也不要把端口填入 Host。

若手上已有可导入的二维码，可使用 Scan QR Code；只有资料形式确实对应时才使用 Import from Cloud JSON。导入完成后仍需检查 Type、地址与端口，二维码能够识别不等于每个字段都正确。保存后回到 Home，点选准备测试的服务器，核对选中标记。接下来先确定 Global Routing，再打开连接，避免把模式问题误认为导入失败。

Shadowrocket 官方 Add Server 页面，显示 Type、Host、Port、Password、Method 及导入入口
Add Server：表单字段随 Type 改变。按自己的已有资料填写，不照抄截图中的服务器参数。

Step 02 / Global Routing

选择 Global Routing 姿态

回到 Home，打开 Global Routing。首次使用要分清三个对象：服务器条目保存连接资料，Config 保存规则与配置参数，Global Routing 决定当前采用哪种整体处理方式。已经导入订阅，不等于已经导入规则文件；在 SERVER 选中一个条目，也不会自动决定哪些网站应走代理。

  • 配置(Config)：按当前启用的配置文件匹配规则，适合需要区分目标与策略的日常使用。
  • 代理(Proxy)：以代理方式处理一般请求，可用于对照检查所选服务器，但不应视为所有流量都必然使用同一出口的承诺。
  • 直连(Direct)：以直连方式处理一般请求，适合检查基础网络，不用于验证代理服务器是否正常。

需要规则分流时选择配置(Config)，再进入 Config 查看当前启用的文件。确认选中的是准备使用的配置，而不只是列表中刚导入、尚未启用的另一份文件。截图中的 General、Rule、Hosts、URL Rewrite 与 HTTPS Decryption 是配置编辑区域；初次上手先关注 Rule 与文件选择，不必为了开始连接而逐项修改所有区域。

先理解一条匹配规则，再调整整份配置

规则通常按顺序检查，命中后采用对应策略。下面只是语法说明：example.com 是示例域名，不代表用户应该访问的测试目标，也不是可直接替代完整配置的内容。第一行让该域名及其子域名使用 PROXY，末尾的 FINAL 让未命中前面规则的请求使用 DIRECT。

DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

如果使用 Add Rule 添加规则，应把具体目标放在兜底规则之前。不要看到打不开网页就把所有规则改成 PROXY，也不要在不了解作用时改动 HTTPS Decryption。修改前保留原配置，保存后确认实际启用的文件没有选错。更完整的配置结构、DNS 与规则顺序说明见Settings 与配置设置手册；本步完成后返回 Home，准备建立连接。

Shadowrocket 官方 Config 编辑页面，显示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 与 Add Rule
Config：先确认当前文件与 Rule，再按需要编辑。订阅中的服务器列表与配置文件承担不同作用。

Step 03 / Home

打开连接并确认系统授权

在 Home 再检查一次服务器选中标记，以及 Global Routing 当前显示的值。截图顶部的 Not Connected 表示尚未连接；点击顶部开关开始连接。首次使用时，系统可能要求允许添加 VPN 配置，提示中的 VPN 配置用于让设备把相关请求交由 Shadowrocket 处理，并不是购买或续费步骤。

核对提示来自当前操作后，按系统要求确认；系统可能进一步要求设备密码或身份验证。完成后返回 Shadowrocket，观察开关与状态文字是否改变。如果此前取消了授权，应回到应用重新发起连接，并按系统提示检查权限，不要反复删除应用来处理同一授权问题。

开关状态与服务可用性分开判断

连接开关能够保持打开，说明设备已启动相应连接流程，但它不能单独证明服务器可达、认证有效、DNS 正常或规则命中正确。即使系统显示 VPN 状态，仍需继续下一步的实际访问测试。如果状态立即退回未连接，先记录屏幕提示，核对系统授权和当前配置是否能加载，再进入排查步骤。

第一次测试尽量保持网络环境不变，不要同时切换 Wi-Fi、修改规则和更换服务器。这样一旦出现差异，就能把原因缩小到刚才的操作。iPad 与 iPhone 的布局可能不同，但仍沿 Home、Global Routing、连接开关这条路径检查。连接建立后先不要调整 On Demand，手动连接验证通过，再决定是否需要自动触发。

Shadowrocket 官方 Home 页面，顶部显示 Not Connected 开关、Global Routing 和 Connectivity Test，下方为 SERVER 分组
Home：依次核对所选服务器、Global Routing 与连接状态，再进行 Connectivity Test。

Step 04 / Connectivity Test

验证服务器与规则是否生效

先在 Home 使用 Connectivity Test 检查所选服务器。测试结果与 Settings 中的 Test Method 有关：不同方法验证的环节不同，因此一次测试成功不等于所有网站都能打开，一次失败也不能直接推断认证信息一定错误。先确认测试针对的是当前准备使用的条目，再把结果与真实访问放在一起判断。

用实际请求核对预期

  1. 打开浏览器，访问一个已知可正常打开的页面。等待本次请求完成，而不是只观察此前缓存的页面内容；必要时重新加载或换一个未打开过的页面。
  2. 如果使用配置(Config)，分别选一个预期走 PROXY 的目标和一个预期走 DIRECT 的目标。不要只测其中一个，就认定整份规则都已生效。
  3. 查看应用内可见的连接或日志记录，按目标域名、发生时间与策略核对。存在记录时确认它对应本次请求，不能把旧记录当作刚刚的命中结果。
  4. 如果页面能打开但策略不符，返回 Config 检查当前文件和规则顺序；如果策略符合但访问失败，再检查该服务器与目标服务本身。

Data 中的流量变化只能作为有数据活动的辅助线索，不能独立证明某个域名走了 PROXY。设备上的其他请求也可能产生流量，出口地址的变化同样只说明被测试请求的结果。要验证一条规则，最可靠的思路是“指定目标、发起新请求、核对该请求使用的策略”，而不是追求某个固定的测试数值。

完成后记录一组可复现的条件：当前网络、所选服务器、Global Routing、启用的 Config 与测试目标。以后修改设置时使用同一组目标复测，更容易发现变化。若结果符合预期，可以开始正常使用；如果测试与实际访问不一致，继续下面的排查，不必先改动更多高级参数。

Step 05 / Settings

按顺序定位常见失败点

排查遵循“先基础、后规则；一次只改一项”。每改一项就重新发起相同测试，确认结果后再继续。若同时替换订阅、切换服务器、修改 DNS 和规则，即使恢复访问，也难以知道哪项才是原因，后续更难维护。

资料没有出现：检查导入结果

如果 Home 没有预期服务器，先回到已保存的订阅检查 URL 和更新提示。确认自己的服务资料仍有效，且当前网络能够取得内容。手动添加的条目则回到 Add Server 核对 Type、Host、Port 与认证字段。尤其不要在 Password 前后留下空格，也不要把显示名称误当服务器地址。详细的订阅问题可继续查阅常见问题。

开关打开但访问失败：先区分网络与模式

先暂时断开连接，用同一网络访问已知可用的页面，确认基础网络正常；存在需要网页确认的网络接入流程时，先完成该流程。然后重新连接，核对当前服务器和 Global Routing。若误选直连(Direct)，就不能用该结果证明代理可用；若选择配置(Config)，要检查是否启用了另一份文件，以及目标是否命中了 DIRECT 或 REJECT。

在条件允许且理解影响的情况下，可临时切换代理(Proxy)对照同一目标，再恢复原模式。如果 Proxy 可以访问而 Config 失败，应优先检查配置与命中策略；如果两者都失败，仍需继续核对服务器、认证或目标服务，不能仅凭这个对照就认定 DNS 有问题。

部分目标失败：再看 DNS 与测试方法

当只有部分域名失败，先确认目标本身是否可用、规则是否过宽，再检查配置里的 DNS 相关参数。不要把网上看到的一组地址直接覆盖原设置；先保留原值，单独修改并复测。Settings 中的 Test Method 决定测试方式，而不是改变所有网站的实际请求方式，不能只靠切换测试方法来修复浏览器访问。

连接自动恢复：核对 On Demand

如果手动断开后又出现连接，应检查 Settings 中的 On Demand，以及当前已设置的触发条件。排查期间可先暂停相关自动触发，再进行手动测试。Today Widget 是快捷入口，不应代替 Home 中的最终状态核对；Proxy、TCP 与 UDP 区域包含更细的行为设置，首次连接没有明确需求时保留原设置。

仍无法定位：保留最小诊断信息

使用 Diagnostics 或相关日志功能时，尽量在问题发生后立即查看，并记下时间、目标、模式与错误提示。保存或转交记录前，遮盖订阅 URL、服务器认证信息与可识别个人的内容。仅提供判断问题必需的片段，不公开完整配置。日志与设置项的系统说明见设置手册；已能定位为某个问题时，再到 FAQ 阅读对应处理方法。

Shadowrocket 官方 Settings 页面，显示 Language、Test Method、Today Widget、On Demand、Diagnostics、Proxy、TCP 与 UDP
Settings：先检查与当前问题相关的项目。Test Method、On Demand 与 Diagnostics 的用途不同，不要同时修改多项。

Next / Keep a Working Baseline

保留可用配置，再逐项调整

首次设置完成后，保留一份已验证可用的配置，记住所选服务器与 Global Routing。以后更新订阅，先检查服务器列表是否发生变化；以后改规则，先用固定目标核对策略；以后改 Settings，先读清该项目影响的范围。把“资料有效”“连接建立”“规则正确”分开判断，可以减少重复导入与无关修改。

日常只需更换已有服务器时，不必重做全部步骤；需要重新导入配置或调整自动连接时，再返回对应章节。继续深入可阅读Settings 设置项参考，遇到具体错误则查阅常见问题与排查说明。