Add Server：添加与订阅导入
本步完成标志：Home 的 SERVER 中出现可选择的服务器条目。
打开 Shadowrocket 后先停留在 Home，找到 Add Server 或页面上的添加入口。准备资料时先区分两种情况：订阅链接用于一次导入一组服务器，单台服务器资料则需要逐项填写。两者不是相同内容，不要把订阅链接直接填到服务器的 Host，也不要把服务器地址当作订阅地址提交。
已有订阅：选择 Subscribe
进入 Add Server，打开 Type，选择 Subscribe，将你从自己的服务商处取得的完整订阅链接填入 URL。如需填写备注，可使用便于辨认来源的名称。粘贴后检查链接首尾有没有空格、换行或遗漏字符，再保存并等待内容获取完成。链接内的认证参数属于私密资料，不要发送到公开讨论区，也不要放进用于展示的截图。
保存后返回 Home，查看对应分组是否出现服务器。只有订阅名称、没有服务器条目时，不能认为已经导入成功；应检查页面提示，确认订阅内容是否成功获取。已有条目需要刷新时，使用该订阅分组的更新操作，等待完成后再检查条目变化。更新订阅与更新应用是两件事，前者读取你自己的订阅内容，后者通过 App Store 完成。
手动添加：按 Type 核对字段
如果持有单台服务器信息，在 Type 中选择资料指定的协议，再填写 Host、Port 及认证字段。截图展示了包含 Password、Method 的一种表单；其他协议可能使用不同字段，不能照着截图补写不存在的参数。地址一般填服务商给出的域名或 IP，端口填对应数值，加密方式与认证内容都应逐项一致。
持有适用二维码时，可以使用 Scan QR Code 读取，再检查识别后的协议与字段；Import from Cloud JSON 是另一种导入入口，并不表示任意文本都能读取。保存前确认资料格式与入口相符。若不确定字段含义，先查阅术语表，协议参数的进一步说明见协议参考，不要通过反复猜填来尝试连接。
完成添加后，在 SERVER 中选中准备测试的条目，确认选中标记位于目标服务器旁。此时先不批量修改其他服务器，也不急于开启 On Demand；下一步先明确请求将按哪一种路由方式处理。
Global Routing：选择路由姿态
本步完成标志：知道当前姿态，以及它是否使用配置文件中的规则。
返回 Home，点开 Global Routing。这里决定连接请求的总体处理方式，不是选择服务器协议的位置。先记住三种姿态：配置(Config)/代理(Proxy)/直连(Direct)。如果希望不同网站按照配置中的规则分别处理，应选择 Config；如果只是检查所选服务器能否承载代理请求，可以临时使用 Proxy；Direct 用于直接连接，并不代表正在使用所选代理服务器。
Config 需要配合当前启用的配置文件理解。打开 Config 页面，确认实际使用的是哪一份配置，再查看其中的 Rule。仅仅导入订阅，并不等于已经获得符合自己需求的分流规则；订阅中的服务器条目和配置文件承担不同职责。前者提供连接目标及参数，后者决定请求应采用的策略。
先看现有 Rule，再决定是否修改
官方截图中的配置编辑页包含 General、Rule、Hosts 等分段，以及 Add Rule。首次上手先查看 Rule，不必同时改动每个分段。尤其是 URL Rewrite 与 HTTPS Decryption，它们不是完成基础连接所必需的步骤，不应为了让开关显示已连接而随意开启或添加内容。
规则按顺序匹配，因此判断结果时要同时看规则位置和最终策略。例如，下面的两行仅用于说明“指定域名走代理，其余直连”的写法，其中 example.com 是教学示例域名，并非需要实际访问的服务地址。若已有适用配置，先保留原状进行验证，避免把示例直接覆盖到原有规则中。
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECTDOMAIN-SUFFIX 在此匹配域名后缀，PROXY 指定代理策略，FINAL 作为前面规则均未命中时的兜底。选择 Config 后，如果目标命中了 DIRECT，它不会因为顶部连接开关开启就自动改走代理。排查时可以临时切换到 Proxy 比较同一目标的表现，但比较结束要恢复预定姿态，避免把测试用设置长期保留。
这一步只要求选对姿态并知道当前配置来源。更多规则关键字可查术语表；如需区分协议参数、传输设置与路由规则，继续阅读协议参考。接下来回到 Home，对刚才选定的服务器建立连接。
Home：打开连接与系统授权
本步完成标志：系统已允许 VPN 配置，应用连接状态与预期一致。
回到 Home 后，先检查 SERVER 中当前选中的服务器，再核对 Global Routing 是否为刚才选择的姿态。服务器添加成功不代表它已经被选中；如果存在多个分组，应通过选中标记确认目标，而不是只看列表最上方的名称。确认这两项后，再打开页面顶部的连接开关。
首次建立连接时，系统可能提示添加 VPN 配置。确认当前操作来自刚打开的 Shadowrocket，再按系统提示允许，并完成设备密码、Face ID 或 Touch ID 认证。这个过程用于让应用通过系统网络扩展处理流量，不会代替服务器认证，也不会自动补齐订阅或密码。不要将系统授权成功误认为远端服务器已经验证通过。
拒绝过授权时，重新触发提示
如果之前取消了系统提示，返回应用重新尝试打开连接，观察系统是否再次要求确认。仍然无法开启时，到系统设置中的 VPN 相关页面检查配置状态；设置位置可能随系统版本不同而变化，可使用系统设置搜索查找。若不确定某条配置的用途，先辨认所属应用，避免删除其他仍在使用的配置。
完成授权后返回 Home，检查顶部是否仍为 Not Connected，以及开关是否保持开启。如果开关立即恢复关闭，应先处理应用显示的错误或系统权限问题，而不是连续快速点击。一次操作后等待状态稳定，保留错误提示中的关键文字，后续排查会更容易定位失败发生在哪个环节。
截图中的 Home 同时包含 Global Routing、Connectivity Test 与 SERVER，可以用来确认入口位置。状态切换成功只说明本地连接流程已经建立，不能证明每个网站都能访问，也不能证明请求命中了预期规则。完成本步后，需要继续运行测试并实际访问目标，才能判断配置是否符合使用目的。
首次验证期间保持设备网络相对稳定，暂不同时切换 Wi-Fi、蜂窝网络和多个服务器。如果在切换网络后出现问题，先记录切换前后状态，再单独重试。On Demand 用于按条件触发连接，建议在手动连接、断开和重新连接均已验证后，再根据自己的需求配置。
Connectivity Test：验证是否生效
本步完成标志：测试结果、实际访问与规则策略能够相互解释。
在 Home 使用 Connectivity Test 检查连接情况。测试应在服务器与路由姿态已经确认后进行，否则结果可能对应另一条连接。不同测试方式检查的对象不完全相同，返回结果需要结合 Settings 中的 Test Method 理解；一次测试通过不代表所有目标可达，一次失败也不应直接推断订阅中的全部服务器失效。
随后打开浏览器，访问你原本准备使用的目标页面，并发起一次新的请求。不要只观察已经加载完成的页面，也不要仅凭缓存内容判断连接是否有效。若页面仍显示旧内容，可以重新加载，或打开该网站的另一个页面。验证时一次只使用一个明确目标，便于将访问时间与应用中的连接记录对应起来。
将连接状态与规则结果分开检查
使用 Config 时，在应用提供的连接记录中查找刚才的请求，核对目标域名、匹配规则和最终策略。若预期走代理，却命中了 DIRECT，优先检查规则顺序和当前启用的配置；若已经命中 PROXY 但访问失败，再检查所选服务器及目标服务。记录页面的入口以实际界面为准，Data 中的流量统计可作为活动线索，但流量增加本身不能说明某个域名走了哪条策略。
可以用一次受控比较缩小范围：保持同一服务器、同一设备网络和同一目标不变，仅将 Global Routing 从 Config 临时改为 Proxy，再发起新请求。如果后一种方式可用，说明需要进一步检查规则或配置差异；如果两者都失败，下一步应核对服务器参数、认证和目标响应。比较完成后恢复原来的路由姿态。
对需要直连的目标也要验证。规则分流的目的不是让所有请求都显示为代理，而是让每类请求按预期策略处理。确认一项测试、一个实际访问目标和对应记录后，记录当前可用的服务器及配置名称即可；不必为了追求单次测试结果反复改动已经正常工作的设置。
Settings：按失败环节排查
本步完成标志：能描述失败发生在哪一步，并只修改与该环节相关的设置。
出现问题时，先把现象归入一个具体环节：订阅读取失败、服务器添加后无法连接、连接已开启但请求失败，或只有个别目标异常。不要同时删除订阅、更换配置、调整 DNS 和修改协议参数。保留当前配置，一次只改一项，再重复第四步的验证，才能判断是哪一次修改产生了影响。
订阅为空或更新失败
先确认设备本身能够联网，再检查订阅链接是否完整，尤其是复制时被省略的认证参数。已有订阅失效或内容为空时，应向自己的服务商核实有效状态和支持格式。反复创建同一个订阅通常不能修复读取错误，反而容易产生多个难以分辨的分组。更新后检查服务器条目是否真正变化，不要只看订阅名称仍在列表中。
开关无法保持开启
先检查系统 VPN 配置是否已经获准，再确认当前选中的是有效服务器条目。若应用明确提示参数错误，回到 Add Server 对照原始资料检查 Type、Host、Port 和认证信息。某些协议还有传输或 TLS 相关字段，应以资料要求为准，不要根据名称相近就互相替换。需要理解字段关系时，阅读协议参考后再调整。
连接开启，但访问没有按预期完成
先看 Global Routing。Direct 不使用所选代理服务器；Config 下的目标可能被规则分到直连或拒绝策略。若记录显示命中 REJECT，应确认这是有意设置的拦截还是规则范围过宽，而不是直接更换服务器。只有部分域名失败时，再分别检查域名解析、规则匹配和目标响应；不要因为单个页面异常就重置全部配置。
打开 Settings，查看 Test Method 与 Diagnostics，用可用的诊断信息核对失败环节。页面中的 Proxy、TCP、UDP 等项目具有各自用途，不是统一的“修复开关”。如果不清楚某个选项会改变什么，先保留现有值，查明含义后再试。首次上手无需遍历修改全部设置。
反馈问题前，整理可复现条件
记录设备网络类型、当前路由姿态、问题是否影响全部目标、测试方法，以及错误提示中的关键文字。分享截图或诊断片段前，隐藏订阅链接、服务器认证字段和其他私密内容，仅保留定位所需信息。对照修改前后的同一目标结果，比只描述“连不上”更有判断价值。
当手动连接与实际访问都稳定后，再考虑 On Demand 或更细的规则。后续每次更新订阅、替换配置或改变路由，都可以沿用“确认条目 → 核对姿态 → 建立连接 → 验证请求”的顺序。界面词含义见术语表；购买、重装与已购恢复问题则转到App Store 已购恢复说明，不要与连接参数排查混在一起。
