Shadowrocket 使用教程：
导入、连接与验证
以 iPhone / iPad 界面为例，按五个步骤把已有订阅或服务器信息加入客户端，再检查连接与规则是否按预期工作。首次设置先完成一条连接，其他设置留到验证通过后再调整。
操作前先分清资料类型：订阅链接用于取得一组服务器信息；单个节点链接、二维码或参数表用于添加某一台服务器；规则配置决定流量如何处理。这三类资料不能仅因都是链接，就放进同一个输入位置。
添加服务器 / 导入订阅
打开 Shadowrocket，进入 Home。首次使用时，先不要打开连接开关，而是点右上角加号进入 Add Server。接下来根据手中资料选择一种添加方式即可，不需要为了完成教程把同一份资料重复导入。订阅、单个服务器和配置文件分别承担不同职责，选对入口比反复尝试保存更重要。
已有订阅链接：选择 Subscribe
- 在 Add Server 中打开 Type，选择 Subscribe，回到填写页面。
- 在 URL 中粘贴从自己的服务商取得的完整订阅链接。可在 Remarks 中写一个便于辨认的名称，不把密码或链接中的私密内容写进名称。
- 检查链接首尾是否多出空格、换行或聊天内容，再点右上角保存。返回 Home，等待订阅内容加载；若未取得内容，再对该订阅执行更新。
- 展开订阅分组，确认其中已经出现服务器条目，然后点选一个条目作为本次连接使用的服务器。
订阅链接往往包含个人访问凭据，应把它当作敏感信息保存。复制时要复制完整链接，而不是只复制页面上缩短显示的文字；也不要把链接提交给不明解析页面。若导入后只看到分组名却没有服务器，说明还没有完成可用条目的取得，此时打开连接开关不能补全缺失资料，应先检查订阅内容和更新结果。
已有单个服务器：按协议填写 Add Server
如果手中是服务器地址、端口和认证参数，在 Type 中选择资料注明的协议，例如 Shadowsocks、VMess、VLESS 或 Trojan，再逐项填写。地址栏填写主机名或 IP 地址，端口填在端口栏；不要把整条分享链接作为地址。认证信息、传输方式与 TLS 相关选项必须与原始资料一致，不能只看协议名称相同就沿用另一条服务器的设置。
如果资料还提供了传输路径、主机名或服务器名称，应按其对应字段填入。某个选项是否需要开启，取决于服务器实际配置，不取决于教程中是否出现这个词。保存后返回 Home，点选刚添加的条目；如需修正参数，从该条目的编辑入口返回检查，避免连续新建多个相似名称后选错目标。
若持有的是二维码，可以使用 Scan QR Code 扫描，再检查识别出的协议和参数后保存。无论采用哪种入口，本步完成的判断标准都相同：Home 中存在服务器条目，并且已明确选中本次要用的那一个。协议字段不确定时先查 概念速查，不要通过随机切换选项试错。
选择 Global Routing 姿态
服务器添加完成后，仍需决定哪些连接使用它。在 Home 点开 Global Routing，可以看到配置(Config)、代理(Proxy)、直连(Direct)三种姿态。这里选择的是流量处理方式，不是再次选择服务器，也不会自动修复上一阶段填写错误的地址或认证信息。
| 姿态 | 作用与使用场景 |
|---|---|
| 配置(Config) | 按当前配置中的规则分流，连接可以使用代理、直连或其他配置策略。适合需要按规则处理流量的日常使用。 |
| 代理(Proxy) | 将可代理流量交给所选代理策略。适合短暂对照测试，不能据此判断 Config 中的每一条规则都正确。 |
| 直连(Direct) | 直接连接，不通过所选代理服务器转发。适合检查原始网络访问情况，不适合作为验证代理服务器生效的姿态。 |
日常按规则使用时，选择配置(Config)，随后进入底部 Config 页面，确认当前启用的是自己准备使用的配置。Config 页面与 Global Routing 中的同名选项相互关联，但不是同一个操作位置：前者管理配置文件，后者决定当前是否按配置执行。
不要把“订阅导入成功”理解成“规则配置也已完成”。订阅主要负责更新服务器信息，配置文件则描述规则、策略与相关设置。当前配置中的规则通常按顺序匹配；若某个域名先命中直连规则，即使已经选好了服务器，该连接也可能不经过代理。因此，稍后的验证应结合规则命中结果，而不是要求所有页面表现完全一致。
本次先保留已有、可信且能理解用途的配置，不在首次连接时同时调整 DNS、复杂策略组和多条规则。需要系统了解 DOMAIN-SUFFIX、GEOIP、FINAL 等关键字时，继续阅读 代理模式说明；本页先完成“服务器已选中、Global Routing 已确认”的基础状态，再进入连接步骤。
打开 Home 连接开关
回到 Home，先确认服务器列表中的当前选择没有改变，再确认 Global Routing 是刚才设定的姿态。之后打开顶部连接开关。第一次启用时，iPhone / iPad 会显示添加 VPN 配置的系统提示；阅读提示后选择允许，并按系统要求使用设备密码或生物识别完成验证。这里要求的是设备授权，不是服务器密码。
- 保持 Shadowrocket 在前台，打开连接开关，等待系统提示出现。
- 完成系统授权后返回应用，观察开关是否保持开启，以及应用显示的连接状态是否已建立。
- 若此前取消了授权，再次尝试连接并完成提示；若设备受管理、限制添加 VPN 配置，应先检查设备管理规则。
- 连接建立后先保持当前服务器与姿态不变，进入下一步做测试，暂不启用额外的自动连接设置。
系统出现 VPN 状态，表示设备已启用相应网络配置，并不直接证明远端服务器可以访问，也不保证每条流量都走代理。服务器认证失败、远端不可达或规则指向直连，都可能发生在开关已经开启的情况下。因此，本步只确认授权与本地连接状态，真正的可用性需要由下一步的测试和实际访问共同判断。
如果开关刚打开就关闭，先记录应用显示的提示，再检查系统授权、当前配置是否可用，以及是否有其他 VPN 连接正在接管网络。不要连续快速拨动开关；每次切换后留出状态变化的时间。对于受管理设备，不要自行删除不明用途的管理配置，应先确认设备使用要求。
On Demand 用于按条件触发连接，不是首次连接的必选步骤。先通过手动方式确认可以正常使用，再考虑是否需要按需连接。首次验证阶段增加自动重连条件，可能让连接在检查时自行恢复，反而不容易判断某次变化来自手动操作还是自动触发。
Connectivity Test 与生效验证
回到 Home，使用 Connectivity Test 对列表中的服务器进行测试。观察当前选中服务器是否返回结果，或者显示超时、失败。测试能帮助判断当前网络环境下的响应情况，但某种测试方式有响应，不代表认证、规则、DNS 和所有目标网站都已正常；单次超时也不能单独证明参数一定错误。
接着切换到浏览器，打开需要验证的页面，等待一次完整加载，再尝试刷新。不要只看之前已经打开的页面，因为页面可能来自缓存，已有连接也可能继续沿用切换前的处理方式。为减少干扰，本次只测试少量明确目标；不要同时切换 Wi-Fi、服务器、姿态和浏览器设置，否则出现差异后很难定位原因。
如果要验证配置(Config)中的分流，进入 Data 查看相应连接记录，关注目标域名、命中的规则及最终使用的策略。若记录尚未显示所需信息，可在测试前确认相关记录功能已启用，再重新发起请求。页面能打开但记录显示直连，只能证明这次直连访问成功，不能作为所选代理服务器已参与转发的证据。
需要做对照时，可以先记下配置(Config)的结果，短暂切到代理(Proxy)，对同一目标重新建立请求，再比较表现；检查完成后恢复原先准备使用的姿态。若代理(Proxy)可用而配置(Config)异常，优先检查规则命中和配置中的策略指向，而不是立即删除服务器重新添加。若两种姿态都失败，则应先检查网络与服务器参数。
完成验证后，可以保留一份简短记录：使用哪条服务器、哪种网络、哪种 Global Routing 姿态，以及哪个目标成功或失败。后续出现异常时，先与这份已经通过的状态比较，通常比从头修改所有设置更容易找到变化点。
常见失败点与检查顺序
遇到问题时，先判断失败发生在导入、测试、授权还是实际访问阶段。上一阶段未完成，就先处理上一阶段的问题；例如列表仍为空时，不需要继续修改 Global Routing。每次只改变一个条件，重新执行同一项测试，记录变化，再决定是否保留修改。
订阅无法导入，或更新后列表为空
先检查复制内容是否为完整订阅链接，有没有缺少查询参数、被聊天软件截断或带上额外标点。然后确认当前网络能取得订阅内容，以及自己的服务是否仍有效。一个能在浏览器打开的账号管理页面，不一定就是可导入的订阅；如果返回的是登录页面或错误提示，客户端无法把它当成服务器列表。资料类型不清楚时，向自己的服务商确认所给链接的用途。
更新失败后不要立即删除原有订阅，先观察旧条目是否仍在，并保留能说明错误的文字提示。反复新建同一订阅可能产生重复分组，不能解决原链接返回内容错误的问题。订阅恢复正常后再更新一次，确认新的服务器条目确实加载完成。
服务器已出现，但 Connectivity Test 超时
先在未连接代理的情况下确认本地网络本身可用，再核对服务器地址、端口和协议。手动添加的条目尤其要检查认证信息是否完整，以及 TLS、传输方式和相关名称是否与原始资料一致。如果订阅中还有自己可用的其他条目，可在保持网络与测试方式不变时换一个测试，以区分单个服务器异常和当前网络整体异常。
测试超时可能与远端状态、网络路径或测试目标有关，不宜只凭一次结果下结论。可以稍后重试，或者在允许的条件下切换本地网络作对照，但不要以关闭必要的安全验证作为通用处理方法。
连接显示开启，页面仍不能正常访问
首先检查是否误选了直连(Direct)，然后确认 Config 中启用的配置与预期一致。如果只有部分目标异常，查看该目标命中了什么规则，是否被分到不同策略。若域名访问失败而其他连接正常，再检查当前配置的 DNS 设置；不要一开始就把所有 DNS 地址一起更换，以免丢失原本可用的条件。
如果同一目标在代理(Proxy)下可用、在配置(Config)下失败，先回到规则与策略检查。若所有目标都异常，则回查服务器状态和连接授权。涉及某个浏览器或某个应用时，还应确认问题是否只发生在该应用，避免把应用自身的登录、缓存或权限问题全部归因于代理连接。
修复后重新完成一次验证
修改参数并保存后，按需要断开并重新连接，让新的请求使用当前设置。再执行 Connectivity Test，重新访问之前失败的目标，最后检查记录中的策略。不要仅因为某项报错暂时消失就结束检查；只有原来的失败场景也恢复，才说明这次修改有效。
仍无法定位时，可整理设备系统、所处网络、失败步骤和已移除敏感信息的提示文字，继续查阅 常见问题。界面词与规则含义见 概念速查；iPhone / iPad 的商店地区、购买与已购恢复问题见 App Store 指南。这些问题与服务器参数属于不同层次，应分别处理。