官方手册 · 首次连接

Shadowrocket 使用教程

按“添加 → 选择路由 → 连接 → 验证”的顺序完成一次基础设置。先确认每一步的结果，再进入下一步，不需要一开始就调整所有 Settings。

配图为 App Store 官方截图，用于辨认页面与字段。请以设备上实际显示的界面为准；截图中的示例条目不是可用服务信息。

STEP 01 / IMPORT

Add Server：添加服务器或导入订阅

打开 Shadowrocket，进入 Home。先判断手中资料的类型：如果是一整条用于更新服务器列表的链接，按 Subscribe 路径导入；如果是协议、服务器地址、端口及认证信息，按单个服务器填写。两种资料用途不同，不要把订阅链接直接填进 Host，也不要把某个网站地址当成订阅地址。

已有单个服务器信息

  1. 在 Home 点 Add Server，进入添加页面。先选择 Type，使其与自己的服务器资料一致。Type 决定后续需要填写哪些字段，选错类型时，即使地址与端口正确也可能无法建立连接。
  2. 按照资料填写 Host 和 Port。Host 是服务器主机名或地址，不是订阅链接；Port 是对应服务监听的端口。复制后检查开头、结尾是否混入空格或换行。
  3. 填写该类型要求的认证字段。官方截图中的 Password、Method 对应截图所选类型，其他类型可能显示不同字段。认证信息、加密方式及其他连接参数都应与已有资料逐项一致，不凭名称相似自行替换。
  4. 检查完成后保存，返回 Home，确认 SERVER 分组中出现刚添加的条目，并点选准备使用的服务器。能看到条目只代表资料已保存，连通性还要在后续步骤验证。

已有订阅链接

从 Add Server 的 Type 中选择 Subscribe，在对应 URL 输入位置粘贴自己的完整订阅链接，保存后返回 Home。等待导入完成，再展开对应分组检查服务器是否出现。若条目尚未载入，可使用该订阅条目的更新操作重新请求；不要因为第一次等待较久就连续创建多个相同订阅。

订阅链接可能包含访问凭据，应保存在可信位置，不放进公开截图、留言或排错记录。链接里的参数不能随意删减，聊天软件换行或复制不全也会导致导入失败。更新成功后，选中一个已有服务器，再继续选择路由方式。订阅列表更新与 Config 配置文件更新不是同一件事，前者主要改变服务器资料，后者会影响规则等设置。

Scan QR Code 适合扫描自己已有的有效服务器二维码；Import from Cloud JSON 对应相应格式的导入入口。它们不表示任意文本都能识别。资料类型不确定时，先确认原始格式，不要反复切换入口尝试。更多导入格式与更新异常说明见疑难解答。

Shadowrocket Add Server 页面，显示 Type、Host、Port、Password、Method 及底部导入入口
Add Server：先选 Type，再按已有资料填写字段。不同类型显示的认证项目可能不同。

STEP 02 / ROUTING

Global Routing：选择配置、代理或直连

服务器已保存并选中后，回到 Home，点 Global Routing。这里决定流量采用哪种总体路由方式，不是选择协议，也不负责自动修复服务器资料。三种姿态分别是配置(Config)/代理(Proxy)/直连(Direct)，首次使用先弄清各自用途，再选择符合当前测试目标的一项。

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

选择配置(Config)时，流量按当前启用的配置处理。进入 Config 确认实际使用的是哪份配置，再查看其中的 Rule。官方截图展示的是配置编辑页面，可以看到 General、Rule、Hosts 等分段以及 Add Rule 入口；它用于辨认配置内容，不是 Global Routing 选择菜单本身。

规则通常按先后顺序匹配，先命中的规则决定对应请求的策略。PROXY 表示使用相应代理策略，DIRECT 表示直连；因此在配置(Config)下，部分网站走代理、部分网站直连可能正是预期结果。没有确认当前配置前，不要直接把“某网站未经过服务器”判断为连接失败。

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

上面只是规则语法示例：example.com 及其子域名匹配 PROXY，其余未命中请求由 FINAL,DIRECT 兜底。它不是完整配置，也不要求照抄覆盖现有内容。

代理(Proxy)与直连(Direct)：用于明确的访问目标

代理(Proxy)适合让受客户端接管的请求按该模式使用代理，也可临时用于对照测试；它不等于选中服务器就一定能访问所有网站，服务器本身、域名解析及目标站点仍可能出问题。直连(Direct)让相应流量直接连接，不经过所选代理服务器，适合核对原有网络是否正常。

日常需要按规则分流时，确认配置有效后使用配置(Config)。若只是判断某个失败是否与规则有关，可以记录当前选择，短暂改成代理(Proxy)重试同一个目标，完成后恢复。一次只改变路由姿态，不同时切换服务器与配置，比较结果才有意义。更完整的规则说明可从疑难解答继续阅读。

Shadowrocket Config 配置编辑页面，显示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 与 Add Rule
Config 配置编辑页：选择配置(Config)时，需要同时确认当前启用的配置及 Rule，而不是只看 Home 的服务器选择。

STEP 03 / CONNECT

Home：打开连接开关

回到 Home，做连接前的最后一次检查：SERVER 下已经选中要使用的服务器，Global Routing 显示刚才确定的姿态；如果使用配置(Config)，Config 中启用的是预期配置。没有选中有效服务器时，单纯打开连接开关不能补齐服务信息。

  1. 点 Home 顶部的连接开关。官方截图中的 Not Connected 表示截图当时尚未连接，实际操作时应观察状态是否发生变化。
  2. 首次建立连接时，系统可能提示添加 VPN 配置。阅读提示并确认这是刚才主动发起的操作后，按系统流程允许，再完成设备要求的验证。
  3. 回到 Shadowrocket，等待连接状态稳定。如果开关马上关闭或状态持续无法建立，不要反复快速开关，先进入后面的失败排查步骤。

系统 VPN 授权允许客户端建立相应的网络连接配置，不等于已经购买或获得服务器服务。授权成功与远端服务器能否访问是两个层次：前者由设备系统确认，后者取决于已导入的信息、当前网络及远端服务状态。因此，看到连接状态改变后，还需要完成下一步的实际验证。

如果此前已有其他 VPN 连接正在工作，先在系统设置中确认当前使用的是哪一项连接，避免测试过程中连接被替换。首次测试不必同时开启 On Demand；先手动建立一次可复现的连接，确认路径正确后，再按需要研究自动连接条件。

在 iPad 上也按同样顺序核对 Home、服务器选择和系统授权。界面的排布可能随设备显示空间不同而变化，但判断依据仍是当前服务器、Global Routing 与连接状态，而不是截图中某个固定坐标。

Shadowrocket Home 页面，顶部为 Not Connected 连接开关，下方显示 Global Routing、Connectivity Test、SERVER 和 Add Server
Home：连接前核对 Global Routing 与 SERVER 选择；连接后继续运行 Connectivity Test 并验证实际访问。

STEP 04 / VERIFY

Connectivity Test：确认测试与访问结果

连接开关保持开启后，在 Home 使用 Connectivity Test 检查服务器的测试结果。测试可以提供连通性线索，但结果受测试方法、测试目标及当时网络影响。一个读数不是所有网站访问能力的保证，测试超时也需要结合真实请求判断，不能只凭单次结果立即删除服务器。

按三个层次确认是否生效

  1. 先看连接是否保持。回到 Home 确认状态没有退回未连接。如果开关无法保持，先解决授权或连接建立问题，此时还没到判断网站规则的阶段。
  2. 再做真实访问。打开浏览器，访问自己有权访问且希望测试的网站，发起一次新的页面请求。不要只看原本已经加载的页面或旧缓存，也不要仅凭设备状态栏的 VPN 标识判断远端访问结果。
  3. 最后核对策略是否符合预期。配置(Config)下，对照当前规则判断目标应走 PROXY 还是 DIRECT；代理(Proxy)下核对已选服务器；直连(Direct)下则不应期待请求通过所选代理服务器。

需要辅助观察时，可以打开 Data 查看测试期间的流量变化。总量增长只能说明有流量被统计，不能单独证明某个网页的每一个请求都采用同一策略。现代网页可能同时请求多个域名，主页面可打开但图片或登录请求失败时，需要分别检查相关域名与规则，而不是只检查地址栏里的一个名称。

如果同一目标在代理(Proxy)下正常、在配置(Config)下异常，应优先回查配置与匹配顺序。如果两种姿态都失败，但直连(Direct)访问其他常用网站正常，再集中核对服务器资料、远端可用性和解析问题。保留同一目标、同一网络，逐项改变条件，可以避免把偶发波动当成配置结论。

STEP 05 / DIAGNOSE

Settings：按失败阶段逐项排查

出现异常时，先确定失败发生在哪一步。订阅未能导入、服务器无法测试、连接无法保持、只有部分网站失败，分别指向不同检查方向。不要先把 Settings 中所有开关改一遍，也不要立即覆盖 Config；先记录现象，保留一条已知正常的对照路径。

订阅导入失败或列表没有更新

回到订阅条目核对完整链接，确认它仍有效、格式可被识别，并且当前设备网络能访问订阅地址。订阅请求通常也需要正常的基础网络；如果还没有可用连接，不能假设打开一个失效的连接就会使订阅自动恢复。检查设备日期与时间是否正确，再尝试一次更新。更新失败时，旧列表可能仍然保留，因此“看见原有条目”不能证明本次更新成功。

如果信息来自自己的服务资料，核对其有效状态与使用条件，不通过反复添加相同链接解决。排错记录只保留必要的错误文字，不公开完整订阅 URL、认证字段或包含凭据的二维码。

服务器存在，但测试或连接失败

先检查 Type、Host、Port 和认证字段是否与已有资料一致，尤其是复制时缺失的字符、错误的端口和不匹配的 Method。再断开连接，用常用网站确认当前 Wi-Fi 或蜂窝网络本身可用；公共网络若需要先完成网页登录，应先完成该网络的接入步骤。

进入 Settings 可以看到 Test Method 等测试相关入口。不要把不同测试方法的结果直接当成完全相同的指标；先保持一种方法重复测试，再与实际网站访问对照。更换设备网络时，也应保持同一个服务器和同一个目标，避免一次改变多个条件。

开关无法保持，或关闭后又自动连接

核对系统中的 VPN 配置与授权状态，并确认没有其他连接正在替换当前连接。如果关闭后又出现自动连接，检查 On Demand 是否启用及其条件。手动排错时可先记录原设置，再暂时停止相应自动连接行为，避免测试中连接状态自行改变。不要把关闭应用页面等同于一定断开网络连接，应回到 Home 或系统设置确认实际状态。

只有部分网站异常

回到 Global Routing，按前面的对照方法区分规则问题和服务器问题。若已缩小到配置(Config)，优先检查当前配置、Rule 顺序和兜底策略；涉及域名解析时，再查对应 DNS 设置。不要为了一个网页直接启用 HTTPS Decryption 或大幅修改 Proxy、TCP、UDP 设置，这些项目不属于首次连接必需操作。

Diagnostics 可作为进一步诊断入口。使用诊断记录时，先去除服务器认证信息与订阅凭据，再保留能够说明失败阶段的内容。更详细的订阅更新、DNS 与规则问题见疑难解答；涉及商店地区、购买与换机恢复，请阅读App Store 获取指南，无需通过修改连接配置解决购买问题。

Shadowrocket Settings 页面，显示 Language、Test Method、Today Widget、On Demand、Diagnostics、Proxy、TCP 与 UDP
Settings：先辨认 Test Method、On Demand 与 Diagnostics 的用途，再针对已确认的失败阶段检查设置。

首次设置完成后的检查清单

回到 Home，确认只选中了计划使用的服务器，Global Routing 与日常使用目标一致，连接状态保持正常。完成一次真实请求后，把临时用于对照的姿态恢复到预期值。无需为了“设置完整”而逐个开启所有功能；保留能解释用途、能验证结果的最小改动即可。

  • 已有订阅能正常更新，服务器资料来源与有效状态已确认。
  • 配置(Config)/代理(Proxy)/直连(Direct)的选择符合本次访问目标。
  • 连接状态、Connectivity Test 与实际访问已分别核对。
  • 订阅链接和认证资料没有出现在公开截图或排错记录中。

以后遇到异常，先回到本页对应的失败阶段，再查看疑难解答。应用购买与重装使用 App Store 处理；已有服务器或订阅的有效性，则需要依据自己的服务信息核对，两者不要混为一项。

App Store 下载