Shadowrocket 使用教程
从已有资料开始，依次完成导入、模式选择与连接验证。先建立一条可验证的连接，再调整规则和自动连接条件。
- iPhone / iPad 操作说明
- 五步操作顺序
- 官方截图对照
本页按首次使用顺序编排，不要求一次调整所有设置。官方截图用于辨认界面位置；实际可见字段会随所选 Type、应用界面与当前配置不同而变化，应以设备上显示的内容为准。订阅地址、二维码和密码属于敏感资料，操作时不要展示给他人。
STEP 01 / INPUT
添加服务器与导入订阅
先区分手中的资料：一条用于更新服务器列表的地址，通常按订阅导入；包含协议、地址、端口和认证参数的资料，则按单个服务器添加。两者的填写位置不同，不要把订阅地址拆成 Host 和 Port，也不要仅凭链接外观猜测 Type。应先核对资料提供方给出的用途与字段说明。
已有订阅链接：选择 Subscribe
进入 Home，点击 Add Server。在添加页点开 Type，选择 Subscribe，然后在订阅地址字段粘贴完整链接。复制时保留查询参数，不添加空格、换行或说明文字；某些地址中的参数用于识别订阅，少一段也可能导致更新失败。名称可用于辨认来源，不决定连接方式。
保存后回到 Home，等待列表读取；如界面提供更新操作，可对这条订阅执行更新。成功的判断不是“地址已经保存”，而是 SERVER 分组下出现可选择的服务器条目。若只看到订阅名称却没有条目，先检查更新结果与地址完整性，再进入本页的失败点排查，不要反复添加同一个地址。
已有服务器信息：按 Type 填写
如果资料是单个服务器参数，同样打开 Add Server，先选正确的 Type，再填写对应字段。截图展示的是包含 Host / Port / Password / Method 的表单；切换协议后，字段可能不同。Host 填服务器域名或地址，Port 填端口，认证信息和加密选项逐项照资料填写。不要为了让表单看起来完整而自行补写不存在的参数。
如果已有资料以二维码提供，可使用添加页底部的 Scan QR Code，按系统提示授权相机，扫描后仍需检查 Type、地址和端口。Import from Cloud JSON 是另一种资料导入入口，并不等同于任意订阅链接；只在已有资料明确适用时使用。保存后返回 Home，确认条目出现并选中目标。此时完成的是“添加”，下一步才是决定连接采用哪种路由姿态。
STEP 02 / ROUTING
选择 Global Routing 路由姿态
服务器已经出现在 Home 后，先不要急着打开开关。点击 Global Routing，查看当前选择。这里决定连接如何处理流量，不是选择协议，也不是更换服务器。教程采用三种写法：配置(Config) / 代理(Proxy) / 直连(Direct)，与界面中的英文选项对应。
先理解三种选择的用途
配置(Config)按照当前配置文件的规则决定连接策略。规则可能让一部分请求使用 DIRECT，另一部分使用 PROXY，也可能使用 REJECT 拒绝连接。因此选择 Config 后，某个页面能打开，并不能单独证明它经过了当前服务器；还要结合命中的规则与连接记录判断。
代理(Proxy)以代理路由处理流量，适合在首次检查时减少规则分流带来的变量，但实际访问仍受服务器能力、目标站点与相关设置影响。直连(Direct)使用直连路由，适合对照设备本身的网络状态；在 Direct 下访问正常，并不代表刚添加的服务器可以使用。测试前记下当前选项，避免在不同姿态之间切换后误判结果。
使用 Config 前确认配置文件
如果准备使用 Config，进入 Config 核对当前使用的配置文件，再查看其中的 Rule。截图中的 General / Rule / Hosts / URL Rewrite / HTTPS Decryption 是配置编辑的不同分段；本次上手只需辨认配置与规则，不必为了建立连接而逐段修改。Add Rule 用于添加规则，不是添加服务器。
订阅主要更新服务器资料，配置文件则影响规则与其他连接设置，导入其中一种不代表另一种也已准备好。已有配置时先保留其原状；没有明确规则需求时，不要直接照抄未知配置。首次验证可记录所用姿态，连接成功后再切回所需的 Config 并复测。有关规则顺序、策略与协议字段的深入说明，放在技术参考，这里先完成可重复的连接检查。
STEP 03 / CONNECT
打开连接与 VPN 配置授权
回到 Home，在 SERVER 分组确认已经选中要使用的服务器，再看一遍 Global Routing 是否与上一步的计划一致。列表中存在多个条目时，不要只根据排列位置判断当前目标；应核对所选条目的名称与资料，确保没有把旧条目当作这次新增的服务器。
点击 Home 顶部连接开关。首次建立连接时，系统可能提示允许 Shadowrocket 添加 VPN 配置。这个弹窗是系统管理网络配置的授权步骤，仅用于授予连接权限，不会替你补齐已有服务器的参数。确认是刚才主动发起的操作后，按系统提示允许，并完成设备要求的身份验证。
授权结束后返回 Shadowrocket，观察顶部状态是否从 Not Connected 转为连接状态。如果只是完成了授权而开关仍处于关闭状态，可在核对当前服务器后再次打开。若状态短暂变化后又断开，先记录当时出现的提示，不要连续开关、同时换服务器和改规则，否则后续很难判断哪个变化影响了结果。
连接状态与实际访问分开确认
开关保持开启，表示系统连接流程已进入相应状态，但并不等于每个目标都能访问。服务器认证、DNS 解析、路由策略以及目标本身都可能影响请求。此时先保持服务器和模式不变，直接进入下一步，用同一组目标完成测试；不要仅凭顶部状态或系统 VPN 标记结束验证。
若设备已经启用其他 VPN 配置，先在系统设置中核对当前实际使用的配置，避免连接状态互相切换。暂时不需要连接时，可回到 Home 关闭开关。后续如果发现关闭后又自动连接，还应检查 On Demand 条件，而不是把自动连接误认为手动开关没有响应。首次上手先确认手动连接过程，自动化设置留到连接稳定之后处理。
STEP 04 / CHECK
验证连接与规则生效
验证应分成三个问题：服务器是否回应测试、实际页面能否完成访问、请求是否走了预期策略。这三个问题彼此相关，却不能互相替代。保持刚才选择的服务器与 Global Routing 不变，在 Home 点击 Connectivity Test，先观察测试能否完成，再进行实际访问。
测试结果会受到测试方法和测试目标影响。单个条目有测试结果，说明对应测试获得了回应，不保证所有应用、域名或 UDP 请求都正常；出现超时也应先核对测试条件，不能据此推断订阅中的所有服务器都失效。若需要修改 Test Method，先记下原设置，再用同一方法比较，避免把两种测试条件下的结果直接作结论。
用实际请求确认访问结果
切换到浏览器，打开一个熟悉、通常可以正常访问的页面，确认主要内容能加载，而不只看页面标题或缓存内容。随后再试实际需要使用的应用。某个页面正常而另一个失败时，先缩小问题范围到具体目标，不必立即删除订阅或重置全部设置。必要时刷新页面或重新发起请求，以便观察新的连接。
返回 Shadowrocket，在 Data 查看可用的连接记录，核对刚才访问的目标及相关策略信息。使用配置(Config)时，应关注结果是否符合规则预期：应直连的请求是否使用 DIRECT，应经代理的请求是否使用 PROXY。如果出现 REJECT，应先检查对应规则，而不是继续更换服务器。记录页面提供的信息以当前应用显示为准。
一次完整的验证应能说清“用了哪个服务器、哪种姿态、访问哪个目标、出现什么结果”。当这四项明确后，再逐项恢复日常需要的规则或 On Demand，每调整一项就重复相同访问。这样即使后续出现问题，也能回到上一个已验证的状态。不要把测速数字当作全部体验的结论，实际使用还取决于请求类型和当前网络条件。
STEP 05 / DIAGNOSE
按失败位置逐项排查
排错从最早失败的步骤开始。如果列表尚未导入，就先检查资料；如果服务器已出现但连接失败，再检查参数与授权。保持一次只改一项，并记录修改前后的结果。不要一开始就重新安装应用，因为这样会增加恢复本地资料与设置的工作，也可能丢失有用的排查线索。
保存成功，但 SERVER 列表为空
先回到订阅条目，核对 Type 是否为 Subscribe，链接是否完整，是否把普通网页地址当成了订阅地址。再确认设备当前网络能够请求该地址，并查看更新时出现的提示。订阅可返回哪些条目、认证是否有效，由已有订阅对应的服务状态决定；需要时向资料提供方核实。不要在公开提问或截图中附上完整订阅地址。
条目存在，但无法建立连接
逐项对照 Type、Host、Port 与认证字段，尤其留意复制时混入的空格和错误的字符大小写。部分协议还涉及传输或 TLS 参数，应以已有服务器资料为准，不能只填写看起来熟悉的几项。随后核对系统 VPN 授权是否完成、当前选中的服务器是否正确；参数与授权都确认后，再运行同一种 Connectivity Test。
已经连接，但部分请求失败
先核对 Global Routing。直连(Direct)并不验证代理服务器；配置(Config)下则应查看命中规则与策略。可以在明确测试目的的前提下，临时使用代理(Proxy)对同一目标复测，以区分规则影响与服务器访问问题，测试结束后恢复原选择。若只有特定域名失败，再检查相关 DNS 与连接记录，不要直接同时更改所有 DNS 项。
需要进一步检查 Settings 时
进入 Settings，先辨认 Test Method / On Demand / Diagnostics。Test Method 影响测试方式，On Demand 影响自动连接条件，Diagnostics 用于进一步诊断；这些设置的作用不同，不应把它们当作通用修复开关。若手动断开后又连接，优先核对 On Demand；若只是测试结果与实际使用不同，先检查 Test Method。
截图还显示 Proxy / TCP / UDP 等设置分组。首次使用不必逐项改动，尤其不要为排查单个页面而批量调整传输设置。需要整理问题时，只保留必要信息：失败发生在哪一步、所用 Type、Global Routing 选择、测试方式及提示内容。隐藏密码、订阅参数和其他个人资料后，再使用诊断信息定位问题。
到这里仍未解决，可转到疑难解答按问题类别继续检查；需要理解协议字段、配置文件及技术取舍时，阅读技术参考。连接验证通过后，保留当前可用设置，再逐步增加规则与自动连接需求，而不是一次引入多个尚未验证的变化。
