Shadowrocket 使用教程
先导入已有资料，再选择 Global Routing，最后检查连接与请求。按五个问题逐步操作，不必先改动所有设置。
阅读顺序：有订阅链接，走 Subscribe；有单台服务器资料，走手动添加。两条路径完成其中一条即可，之后进入同一套连接检查。
服务器信息从哪里填入？
从 Home 打开 Add Server；订阅和手动添加是两种不同的录入方式。
先确认手上的资料类型，再进入 Add Server。一条用于更新服务器列表的地址属于订阅链接；只有 Host、Port、Password 等字段的资料，需要按协议手动填写。不要把订阅链接当成 Host，也不要把单条服务器分享内容直接当成订阅地址。若资料用途不明确，先向自己的服务商核对格式，避免反复尝试不相关的 Type。
已有订阅：选择 Subscribe
打开 Shadowrocket，在 Home 下方的 SERVER 区域找到 Add Server，或使用页面上的添加入口进入 Add Server。打开 Type，在可选类型中选择 Subscribe，再把自己的完整订阅链接填入对应的 URL 字段。订阅地址可能包含身份凭据，复制时应保持参数完整，不要多带前后空格、换行或聊天文字。
- 核对地址来自自己的服务商，并确认复制的是订阅地址，而不是账户管理网页。
- 按页面提示保存订阅；返回 Home 后，等待获取结果，必要时使用该订阅条目的更新操作。
- 展开返回的分组，确认其中出现可选择的服务器条目。只有订阅名称而没有实际条目时，应先解决更新问题。
订阅导入会读取远端内容，不等于把应用全部设置替换一遍。导入后先查看 SERVER 列表是否完整，再进行下一步。若地址更新失败，不要立即重新购买客户端；应先检查链接是否有效、原始网络是否可用，以及自己的服务是否仍处于可用状态。
已有单台服务器：按 Type 填字段
再次从 Home 进入 Add Server，先选择与原始资料一致的 Type，再逐项填写。以界面中出现的 Host、Port、Password、Method 为例，Host 填服务器地址，Port 填资料中的端口，Password 和 Method 分别对应认证信息和加密方式。不同 Type 显示的字段并不完全相同，不能把一种协议的字段顺序照搬到另一种协议。
保存之前逐字核对大小写、端口和认证内容；资料另外指定 TLS、SNI 或传输设置时，也要按原始说明填写。不要为“试试看”随意切换协议或加密方式。若资料提供二维码，可使用 Scan QR Code 读取；Import from Cloud JSON 是另一种导入入口，只有手上的资料确实采用该格式时才使用，不需要为了完成本教程额外配置它。
完成录入后，下一步不是立刻改 DNS 或打开高级选项，而是确认 Global Routing 的处理方式。这样可以区分“服务器本身不可用”与“规则选择了不同策略”。
Global Routing 选哪一种？
日常按规则处理用配置(Config)；代理(Proxy)与直连(Direct)可用于对照检查。
Global Routing 决定请求采用哪一类处理方式，不负责补齐服务器资料。回到 Home，打开 Global Routing，先确认当前选中项。界面中的配置(Config)、代理(Proxy)、直连(Direct)分别代表按配置分流、使用代理路径和直接连接；选择模式后返回 Home，再继续操作。不要把模式名称与 Config 底部页面混淆：前者选择处理姿态，后者管理配置文件。
| 模式 | 本次入门操作 | 判断边界 |
|---|---|---|
| 配置(Config) | 已有可信配置时，用它检查规则分流。 | 结果取决于当前配置内容及匹配顺序。 |
| 代理(Proxy) | 需要单独检查所选代理连接时使用。 | 不是连接可用性的保证，仍要验证实际请求。 |
| 直连(Direct) | 作为原始网络的对照条件。 | 页面能打开，不代表经过了所选代理。 |
配置(Config)：先看当前配置
切换到 Config，确认当前使用的配置文件，再进入查看或编辑页面。官方截图中的 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 是不同设置分段；首次使用只需了解位置，不必逐项打开或更改。进入 Rule 可以查看规则，Add Rule 用于添加规则。订阅里的服务器列表和这里的规则文件各有用途，更新前者并不意味着后者已经按你的需求设置好。
规则通常按顺序匹配，先命中的条件决定采用的策略。更具体的域名条件应放在适当的位置，FINAL 用于处理未命中前序条件的请求。下面仅展示规则语法，不是需要整段覆盖现有配置的推荐清单；其中 PROXY 是否能作为有效策略使用，仍须结合当前配置的实际定义核对。
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXYDIRECT 表示直接连接，REJECT 表示拒绝请求；PROXY 指向配置中的代理策略。规则没有命中某个域名时，请求可能继续落到后续条件，因此“列表里写过这个域名”不等于“实际一定走该条规则”。排查时应同时看规则位置、策略名称和请求记录，不能只看一行文本。
先保留能解释的设置
如果尚未确认配置内容，可以先用代理(Proxy)检查已录入的服务器，再切回配置(Config)观察差别。不要同时新增规则、修改 Hosts 和开启 HTTPS Decryption；多个变量一起改变后，很难判断是哪一步造成变化。完成对照后，应恢复符合日常需要的模式。有关配置文件管理和更长的规则说明，可先在本页排错步骤定位问题，再根据具体主题继续查阅官方手册。
如何打开 VPN 连接？
先选服务器，再打开 Home 顶部开关；首次连接需要处理系统权限提示。
在 Home 选择实际服务器后，打开顶部 Not Connected 对应的开关。先确认 SERVER 中选中的是刚才核对过的条目，而不是只停留在订阅分组名称。再看一眼 Global Routing 是否为上一步准备测试的模式。截图中的 Not Connected 表示拍摄时尚未连接，不是需要手动输入的设置值。
- 回到 Home，在 SERVER 列表点选要测试的服务器。资料较多时，先只选一条已确认参数的条目。
- 打开 Home 顶部连接开关，留意系统是否弹出添加 VPN 配置的提示。
- 核对提示对应 Shadowrocket，再允许添加；按系统要求完成设备认证，然后返回应用。
- 观察连接状态是否稳定。若开关立即退回，先记录提示文字，不要连续快速重复切换。
允许添加 VPN 配置是建立本机 VPN 连接所需的系统步骤，并不会替用户生成订阅或认证信息。若首次误点取消，重新打开连接开关，按实际提示处理即可；如果没有再次出现提示，可到系统设置的 VPN 管理位置核对配置状态。设备受管理策略限制时，应向设备管理人员确认权限，不能用修改服务器密码来解决系统权限问题。
先用手动连接建立基线
第一次测试建议先手动开关连接，不急于启用 On Demand。On Demand 会按设定条件触发连接，适合在基础连接已经可用后再配置。若尚未理解它的条件，就可能出现手动关闭后又连接的现象，进而误判为开关异常。正在使用其他 VPN 连接时，也应先核对当前实际启用的配置，避免把另一条连接的状态当成 Shadowrocket 的结果。
本步完成的标志是系统允许配置且应用显示连接已建立，但这只能说明本机连接流程完成，不能单凭开关状态断定远端服务器可用。继续下一步，用实际请求验证；如果连接无法保持，直接跳到失败排查，先检查权限与条目参数。
怎样确认连接已经生效？
把系统状态、Connectivity Test 与实际访问分开检查，不用单个结果代替全部判断。
连接是否建立、服务器是否响应、请求是否走对策略，是三个不同问题。先在关闭连接的条件下确认 Wi-Fi 或蜂窝网络本身可用，再打开 Shadowrocket 连接，访问自己平时使用的网页。如果原始网络尚未通过登录认证，或者设备根本没有网络，先处理这层问题，再检查客户端。
先测试条目，再测试实际请求
回到 Home 使用 Connectivity Test，观察当前服务器的测试结果。测试方式受 Settings 中 Test Method 等设置影响，测试能完成不代表所有网站和应用都能正常访问，测试失败也不能直接证明订阅地址失效。需要把同一条服务器的测试结果与实际访问表现放在一起看，而不是在测试后立即改动全部参数。
接着打开一个熟悉的页面，确认能否完成加载，而不只是显示已有缓存。需要观察新请求时，可重新载入页面，再到 Data 中查看本次操作对应的记录。按应用实际显示核对目标域名和可见的策略信息；若记录并未提供某个字段，就不要仅凭连接图标推断具体规则已经命中。
用模式对照缩小范围
当代理(Proxy)下能够访问、配置(Config)下失败时，优先检查当前配置及 Rule，而不是立即删除服务器。若直连(Direct)能访问、代理(Proxy)失败，应回到所选服务器与服务状态核对。每次只改变一个条件，保持服务器、目标页面与网络环境尽量一致，才能让两次结果具有参考价值。
- 系统层：连接开关能保持，系统 VPN 配置处于相应状态。
- 连接层：所选服务器完成测试，或实际请求能够通过它完成。
- 规则层：配置(Config)下的请求记录与预期策略一致。
浏览器显示的出口地址只能反映该次请求，不能代表所有应用都采用同一路径。不同域名可能匹配不同规则；一个页面也可能同时请求多个资源。若只有图片或某个功能失败，应保留对应目标的记录进入下一步，不要把局部失败概括成“全部无法连接”。
连接失败从哪一步查？
按发生阶段排查；保留原始配置，每次只修改一个条件。
先找到失败阶段，再打开对应设置。Settings 中的 Language、Test Method、On Demand、Diagnostics、Proxy、TCP、UDP 属于不同用途，不需要为了排错全部修改。先保留当前配置副本或记录原值，再做有目标的检查；导出的配置也可能含凭据，应由自己妥善保存。
订阅不能更新：回到链接与原始网络
若 Subscribe 保存后没有返回实际条目，先检查完整 URL 是否被截断、是否误复制了账户页面、链接是否仍有效。确认设备在未连接时能够正常联网，再重新更新一次，并记下具体错误。认证或服务状态问题应向自己的服务商核对；不要把带凭据的完整链接发到公开问答区，也不要通过改 Global Routing 掩盖订阅尚未导入这一前置问题。
条目已出现，但无法连接：逐项复核资料
打开该条目的编辑页面，按原始资料检查 Type、Host、Port 和认证字段，再核对协议要求的传输参数。订阅管理的条目先更新后测试，避免手工修改被后续更新覆盖而不自知。若所有条目在同一网络都失败，可在自己有权限使用的另一种网络上做对照；如果只有一条失败，则重点检查该条目及其远端服务状态。
开关立即关闭：先看权限和系统提示
核对系统是否允许添加 VPN 配置，以及当前是否存在其他 VPN 配置正在使用。记下应用或系统给出的错误文字，然后在 Settings 中查看 Diagnostics 可提供的诊断信息。诊断资料可能包含域名、地址与请求记录，提交给相关支持人员前先遮盖敏感内容。系统权限失败与服务器认证失败不是同一阶段，不能用反复切换 Method 来代替权限检查。
VPN 已连接但网页打不开：检查模式与请求
回到 Global Routing，分别按本页验证步骤做配置(Config)与代理(Proxy)对照。只在配置(Config)失败时，查看 Rule 顺序、策略引用和最终处理规则；所有代理请求都失败时，优先核对服务器。若域名相关请求表现异常，再结合可见记录检查解析设置；不要刚看到页面错误就同时清空 Hosts、改 DNS 并重置配置，否则会失去可比较的基线。
测试结果与应用表现不同：核对 Test Method
在 Settings 查看 Test Method，明确当前测试衡量的连接条件。部分业务依赖 UDP，普通网页能打开并不等于相关业务已经可用；同样，某项测试未通过也不一定意味着 TCP 页面请求全部失败。应结合服务器能力、当前配置和具体业务分别确认 Proxy、TCP、UDP 相关选项，不要直接套用与自己协议无关的参数。
关闭后又自动连接：检查 On Demand
如果手动关闭后又出现连接，先看 Settings 的 On Demand 是否启用，以及当前条件是否会再次触发连接。临时停止自动触发后再进行手动测试，有助于分清自动连接行为与网络故障。基础连接稳定之后，再恢复符合自己需要的按需条件，不必为了入门测试保留尚未理解的自动化设置。
仍无法定位时，整理“在哪一步失败、使用什么模式、错误文字、是否只影响单条服务器、换网络后是否相同”这几项信息。涉及账号与商店获取问题，可继续阅读获取指南；需要重新核对安装渠道时，前往客户端下载页。不要一开始就删除全部条目或卸载应用，以免丢失原本可用于对照的资料。
