Shadowrocket 使用教程
已有连接信息后，按导入、模式、连接、验证的顺序操作。先让一条连接正常工作，再调整规则与 On Demand。
开始前：应用与连接信息都已准备好本教程面向已从 App Store 安装 Shadowrocket 的 iPhone / iPad 用户，并以已有自己的订阅链接或服务器信息为前提。本站不提供、不销售、不推荐节点或订阅；连接信息需从你自己的服务商处获取。
客户端一次性买断 ≠ 线路套餐。购买应用不会自动生成可用服务器。系统要求以 App Store 页面标注为准；尚未完成购买或正版核对，请先查看获取应用说明。
下方图片为 App Store 官方截图，用于辨认界面。实际显示的选项与排列请以当前应用为准；请勿把截图中的示例当作自己的连接信息。
添加服务器或导入订阅
先辨认资料类型，再选择入口。订阅地址、单条分享信息与 Config 文件不是同一种内容。
打开 Shadowrocket 后，先回到 Home。下方 SERVER 区域用于查看服务器记录；首次使用时，应先通过 Add Server 添加信息，而不是直接打开顶部连接开关。导入之前确认手里的资料属于哪一种：可更新服务器列表的订阅链接、一个服务器的分享信息，或包含规则设置的 Config 文件。入口选错时，即使内容看起来是一串链接，也可能无法解析。
已有订阅链接：使用 Subscribe
从自己的服务商处复制完整订阅链接，打开 Add Server，在 Type 中选择 Subscribe 对应的订阅类型，按页面提示填写地址与便于识别的名称，再保存。不同界面布局中的订阅管理入口可能有所区别，应以当前应用显示为准。复制时保留原有参数，不加引号、空格或换行，也不要把账户管理网页的地址误当成订阅地址。
保存后等待订阅内容读取完成，再回到 Home 检查 SERVER 中是否出现导入的服务器。若只有订阅名称却没有可选记录，先检查更新是否成功，不要连续重复添加同一个地址。订阅更新改变的是该订阅下的记录，不能据此推断所有服务器都可以连接；下一步仍需选择一条有效记录并测试。
已有单个服务器：按 Type 填写
在 Add Server 中先选与资料一致的 Type，再填写 Host 与 Port。认证字段和传输选项会随协议变化：截图中的 Password、Method 是对应类型下的字段，并不是每种协议都要求填写的通用表单。不要凭名称相似替换协议，也不要随意更改服务商给出的加密、TLS 或传输设置。
如果手里是二维码，可在确认内容来源后使用 Scan QR Code；需要相机权限时按系统提示处理。Import from Cloud JSON 是另一种特定格式的导入入口，不应把普通订阅地址随意填进去。无论使用哪种方式，保存后都应打开记录核对字段，尤其是端口、认证信息和协议类型。
保存后的检查点
回到 Home，选择准备使用的服务器，确认它呈现为当前选中项。名称只方便辨认，不是连接质量的证明。初次测试先保留一个明确的目标，避免在多个记录间来回切换后分不清测试对象。订阅链接通常包含账户凭据，不要将完整地址或导入二维码公开分享；术语区别可查阅术语手册。
完成标志：SERVER 中已有可选记录，并且当前选择的服务器与准备测试的资料一致。接下来再决定请求按什么模式处理。
选择 Global Routing 处理模式
服务器回答“通过哪里连接”，模式与规则回答“哪些请求走哪条路径”。
完成导入后，在 Home 点击 Global Routing，核对当前模式。本教程将三种姿态写作配置(Config)/代理(Proxy)/直连(Direct)，对应界面中保留的英文原文。三者不是连接强度或速度等级，切换模式也不会修复错误的密码、失效的订阅或不可达的服务器。
配置(Config)：按当前规则处理
已有可信且适合当前用途的规则文件时，选择配置(Config)，再进入 Config 检查当前使用的配置。仅在列表中看到一个文件，并不等于它已被选为当前配置；应确认应用显示的选中或使用状态。服务器订阅提供连接记录，Config 则可以包含规则和相关设置，两者需要分别核对。
官方截图展示了 Config 文件的编辑内容，包括 General、Rule、Hosts、URL Rewrite 与 HTTPS Decryption。初次连接不必逐项修改这些分段，也不需要为普通连接验证开启 HTTPS Decryption 或安装证书。先保留已知配置，再阅读 Rule 中与目标请求有关的条目。
规则通常按顺序匹配，命中后使用对应策略。例如 DOMAIN-SUFFIX,example.com,PROXY 表示对匹配该域名后缀的请求使用 PROXY 策略；这只是语法示例，不是可用线路，也不是建议直接追加到现有文件的完整配置。使用 Add Rule 前，应先确认目标、顺序和策略引用；概念解释见规则关键字术语。
代理(Proxy)：用作代理路径对照
当服务器已经选好，但暂时不能确定规则是否影响结果时，可短暂切换到代理(Proxy)做对照。它用于让请求按该模式走代理处理路径，不代表网络上的每一种流量都会获得相同结果。若同一目标在 Proxy 下可用、在 Config 下失败，应优先检查规则命中、策略选择与相关配置，而不是马上删除服务器。
直连(Direct)：检查直接访问路径
直连(Direct)用于直接连接的处理场景，不会验证代理服务器是否可用。用 Direct 做基础网络对照后，应恢复真正需要的模式。若当前没有准备好的规则文件，可先用 Proxy 验证已有服务器，再单独整理 Config；不要把“选择 Config”理解为自动取得一套适用所有场景的规则。
完成标志：能说清当前选择的是哪一种模式；使用 Config 时，还能确认当前实际使用的配置文件。保持这一选择不变，进入连接步骤。
打开连接与系统授权
首次允许添加 VPN 配置，是系统接管相应网络流量的授权步骤，不是订阅导入操作。
回到 Home，再次确认 SERVER 中选中了预定服务器，Global Routing 也符合上一节的选择。截图中的 Not Connected 是未连接状态，顶部开关才是开始与停止连接的入口。记录存在、记录被选中和连接已打开，是三个不同的状态，不能只看到列表里有服务器就认为设置已经生效。
打开顶部开关。首次使用时，系统可能提示允许 Shadowrocket 添加 VPN 配置；确认正在操作的是本机从 App Store 安装的应用后，按提示允许，并完成设备要求的验证。这里授予的是系统网络配置权限，并不表示服务器资料已通过验证，也不会因此自动获得连接信息。
授权结束后回到 Home，查看开关是否保持开启，以及连接状态是否发生变化。如果刚才取消了授权，重新打开连接开关并按系统提示处理即可。需要检查系统记录时，可在系统设置中查找 VPN 相关项目；系统版本不同，入口名称与层级可能不同，不应仅因为路径与截图不完全一致就判断配置丢失。
开关开启，不等于目标已经可访问
系统 VPN 状态或 Home 中的连接状态，首先说明本机网络配置已启用；远端服务器能否完成认证、目标服务是否可达、规则是否符合预期，还需要下一步验证。如果开关立刻回到关闭状态，先记录是否出现权限提示或错误信息，不要快速反复点击，也不要在原因不明时创建多份系统配置。
测试期间先保持 Wi-Fi 或蜂窝网络不变，避免同时切换服务器、网络与模式。若设备上另有会接管网络的 VPN 配置，应在确认用途后检查其是否正在启用，避免把相互影响误判为服务器故障。涉及受管理设备或组织网络时，应遵守设备管理要求，不随意移除已有配置。
完成标志：已按系统提示处理授权，Home 的连接开关能够保持开启。接下来不再改动字段，先验证实际请求；停止测试时可回到 Home 关闭连接。
验证连接与实际请求
分别检查本机状态、测试结果与目标操作，不用单一结果代替完整判断。
连接开启后，在 Home 使用 Connectivity Test，观察当前测试是否能够完成。测试表现会受到测试方法、测试目标、当前网络及服务器状态影响，因此先记录结果，再解释原因。测试成功表示对应测试条件下有响应，不等于所有网站、应用或协议都已验证；测试失败也不能直接证明所有实际访问都失败。
随后打开浏览器，访问一个自己熟悉且当前确实需要使用的页面，执行一次刷新；如果要检查某个应用，就在该应用中发起新的请求，而不是只看之前缓存的内容。保持服务器、网络和 Global Routing 不变，这样测试结果才有可比性。已有页面、离线内容或后台保留的画面，都不能单独作为连接生效的证据。
按三层证据核对
- 本机层：Home 开关保持开启，系统没有等待处理的授权提示。这说明连接入口已启用。
- 测试层：Connectivity Test 能完成对应测试。记录所用方法，不把不同测试方法的结果直接比较。
- 请求层：目标页面或应用中的新操作能完成；使用 Config 时，再核对对应请求的规则与策略是否符合预期。
如果只想验证一个请求有没有经过代理，页面能打开还不够，因为它也可能通过 DIRECT 完成。应结合 Config 的匹配规则和应用可用的相关记录检查处理路径；部分请求直连成功是分流配置的正常结果，不需要为了让每个请求都显示为代理而修改规则。日志或记录只能解释其实际覆盖的请求，不能替代所有场景的测试。
需要做模式对照时，保持同一服务器与同一目标，只把 Global Routing 从 Config 暂时切换到 Proxy，再发起新请求。若结果不同，优先回查配置；若两种模式都失败，再检查服务器字段、网络可达性和认证。每次记录一个变化即可，避免同时刷新订阅、更改 DNS 和重写规则后无法定位原因。
完成标志：目标操作可完成，且处理路径符合用途。验证结束后恢复计划使用的 Global Routing；若仍异常，带着“哪一层失败”的结论进入最后一步。
设置检查与常见失败点
按症状处理，每次只调整一个条件。暂时不要靠重装或批量删除配置解决未知问题。
打开 Settings，先辨认与当前问题直接相关的项目。官方截图中包含 Test Method、On Demand、Diagnostics 以及 Proxy、TCP、UDP 等设置。看到这些项目并不意味着首次使用必须逐个修改；测试方法、自动连接行为和协议参数解决的是不同问题，应避免把它们当成通用修复开关。
订阅保存了，却没有服务器
先回到订阅记录，检查读取或更新是否成功，再核对地址是否完整、是否仍有效、是否为 Shadowrocket 能解析的内容。某些网页地址打开后显示的是登录页，而不是订阅数据；这种地址不能直接代替订阅链接。当前基础网络能否访问该地址也会影响更新。若链接已失效，应向自己的服务商确认原有信息，不要反复导入同一错误内容。
服务器存在，但连接或访问失败
打开当前服务器记录，依次核对 Type、Host、Port、认证和协议相关参数，尤其留意复制时多出的空格与缺失字段。然后确认 Home 选中的就是这条记录。若开关无法保持开启，优先检查系统授权；若开关正常而实际请求失败，再核对 Global Routing、Config 和服务器可达性。不要把“有记录”“已授权”“远端可用”混为一个检查项。
Connectivity Test 与实际访问结果不同
在 Settings 查看 Test Method，先明确当前测试方式，再结合浏览器或目标应用的实际操作判断。不同服务器对不同测试方式的响应可能不同；测试值用于该条件下的比较，不应据此承诺实际速度。若只有特定目标失败，保留其他条件，检查该目标对应的规则、解析和服务状态，详细流程见疑难手册。
关闭后又连接：检查 On Demand
On Demand 会影响按需触发连接的行为。基础连接尚未验证时，建议先用手动开关建立清晰的测试基线；连接稳定后，再根据自己的使用条件设置 On Demand。发现关闭后又连接，先检查是否配置了相应条件，不要立即认定开关失效。它不负责修复服务器认证，也不会让失效订阅自动恢复。
需要诊断时，先整理最小信息
使用 Diagnostics 或查看相关记录前，先记下发生问题的环节、当前模式、网络类型，以及更改一个条件后的结果。分享记录时移除订阅完整地址、认证字段、二维码与可识别账户的信息；截图也要检查边缘和展开区域是否包含凭据。完整诊断可能涉及 DNS、规则顺序、TCP / UDP 或 iPad 场景，本页不展开批量改动，继续按疑难手册的症状章节处理。
本轮结束：能够导入、选中服务器、开启连接并完成实际请求，就已建立基础使用路径。后续先理解术语手册中的 Config、PROXY、DIRECT 与 FINAL，再逐项调整规则；保留一份已验证的配置，便于对照恢复。
首次设置完成核对
以下五项都能确认后，再增加自动连接条件或复杂规则。
- 已有资料已正确导入，Home 中选中了实际准备使用的服务器。
- 知道 Global Routing 当前使用 Config、Proxy 还是 Direct；使用 Config 时已确认当前配置文件。
- 首次 VPN 配置授权已处理，连接开关可以保持预期状态。
- 已运行 Connectivity Test，并在目标页面或应用中完成一次新的实际请求。
- 测试后恢复了日常所需模式；若启用 On Demand，已理解其触发条件与手动开关的关系。
再次使用通常只需确认当前服务器、模式和连接状态，不必重复导入。若更新订阅或切换网络后出现异常，从受影响的那一步重新核对即可；涉及更长的排查链路，请进入Shadowrocket 疑难手册。