OFFICIAL MANUAL / QUICKSTART
Shadowrocket
导入、连接与验证
按五步完成首次设置。先让一个已有服务器可用，再检查规则；不要同时修改服务器、DNS 与分流设置。
建议预留约十分钟按顺序操作；实际完成时间取决于现有资料是否完整、网络状态及系统授权。配图均为 App Store 官方截图，用于辨认界面位置；以设备上实际显示的字段为准。
STEP 01 / SERVER INPUT
Add Server：添加服务器或导入订阅
先根据手里的资料选择一种导入方式。只有一台服务器的完整参数时，使用手动添加；持有订阅链接时，使用 Subscribe。两种方式的目标都是让 Home 的 SERVER 区域出现可选服务器，不需要为了首次连接把两种方式都做一遍。
手动添加：字段必须与已有资料对应
进入 Home，点击 Add Server，或点击用于添加条目的加号进入添加页面。先打开 Type，选择资料中注明的协议类型，再填写该类型所需字段。Type 会影响后续可见选项，不要先照着截图填完再随意更换类型。
例如，官方截图展示了 Host、Port、Password、Method 等字段：Host 填服务器主机名或地址，Port 填对应端口，Password 与 Method 按原资料逐项核对。其他协议可能使用不同的身份、传输或安全设置，不能把某一类型的 Password 当作所有协议的通用字段。密码大小写、末尾空格和复制时带入的换行都可能导致失败。
确认信息后使用页面上的保存或完成操作返回 Home，检查 SERVER 中是否出现刚添加的条目。若资料是二维码，可使用 Scan QR Code，并按系统提示授予相机权限。Import from Cloud JSON 是另一类结构化信息导入入口，不应把普通订阅链接直接当作对应的 JSON 内容使用。
Subscribe：导入自己的完整订阅链接
持有订阅链接时，在 Add Server 中打开 Type 并选择 Subscribe，将自己的完整链接填入对应的 URL 字段，填写便于辨认的备注后保存。链接应来自你自己的服务商资料，复制时保留完整路径与参数。订阅链接往往带有身份信息，不要把它提交到公开讨论区或放进分享截图。
保存后等待订阅请求完成，返回 Home 查看订阅分组及其中的服务器条目。若只出现分组名称、下面没有可选服务器，不要立即打开连接开关：先尝试该订阅的更新操作，并核对返回内容是否为客户端可识别的订阅，而不是登录页面、错误页面或普通网页。
导入成功后，先选定其中一个服务器作为本次测试对象。后续排查都围绕这一条目进行，避免每次失败就同时更换多项设置。订阅与 .conf 配置文件不是同一件事；需要区分两者时，可查看概念速查中的订阅与配置说明。
STEP 02 / ROUTING CHOICE
Global Routing：选择本次流量处理方式
先确定本次是检查服务器，还是验证日常规则。在 Home 打开 Global Routing，可以选择配置(Config)、代理(Proxy)、直连(Direct)。这里改变的是流量如何处理，不会修复错误的服务器密码，也不会替你补充缺失的连接资料。
首次检查用 Proxy，规则分流用 Config
代理(Proxy)适合把本次测试集中到当前选中的服务器。首次导入后，可先选择 Proxy，再完成下一步连接，以减少规则命中差异带来的干扰。但它不代表所有服务都一定可访问，实际结果仍受服务器、目标服务与网络条件影响。
配置(Config)按当前启用配置中的规则处理请求。准备使用它之前，进入 Config 页面，确认哪个配置文件正在生效；打开文件查看内容时，重点辨认 General 与 Rule。仅打开或编辑某个文件，并不能据此认定它已经成为当前使用的配置，还需要核对配置列表中的选中状态。
直连(Direct)用于直接访问目标，不经所选代理服务器转发。它可帮助建立对照：同一目标在 Direct 与 Proxy 下结果不同，说明需要继续区分网络路径或服务器问题，而不是直接归因于应用开关。若希望流量经过已有服务器，不能只因为顶部显示已连接就忽略当前是否选了 Direct。
在 Config 中只核对，不急于改规则
右侧官方截图展示了配置文件的分段及 Add Rule 入口。上手阶段先确认现有规则的策略含义，不必修改 Hosts、URL Rewrite 或 HTTPS Decryption。下面是独立的语法示例，不是可直接替代你现有设置的完整配置，也不包含任何服务器信息。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXYRule 通常按顺序判断，前面的具体匹配可能先于后面的规则决定结果。示例中的 DOMAIN-SUFFIX 匹配域名后缀，IP-CIDR 匹配地址范围，FINAL 处理前面未匹配的请求；PROXY、DIRECT、REJECT 是策略关键字，与 Global Routing 中的界面选项需要分开理解。
确认模式后返回 Home，保留选中的服务器。需要进一步设计规则、理解 DNS 或调整配置分段时，阅读系统教程；此处先用一个明确的模式完成连接，避免边测试边重写整份配置。
STEP 03 / CONNECTION
Home：打开开关并完成系统授权
服务器与 Global Routing 都确认后，再打开 Home 顶部开关。连接前最后核对一次选中的服务器，尤其是订阅内有多个名称相近条目时；分组名称与实际选中的服务器并不总是同一层级。
首次连接先处理 VPN 配置提示
首次开启时，系统可能提示 Shadowrocket 请求添加 VPN 配置。该提示用于允许客户端通过系统网络功能处理流量；核对应用名称与提示内容后，按系统界面确认，并完成设备要求的验证。如果暂时取消，返回应用后需要再次触发授权，不能把未完成授权当作远端服务器故障。
完成授权后回到 Home，观察顶部状态是否从 Not Connected 变化为连接状态。不要只看开关被点亮的一瞬间：若它很快关闭，或状态反复变化，应先记录现象，再到第五步排查。系统授权成功说明本地配置获准建立，并不等于远端握手、DNS 查询及目标访问都已成功。
连接后先保持设置稳定
开关保持开启时，先不要再切换多个服务器或连续更换 Global Routing。保留当前组合，进入下一步运行 Connectivity Test，再打开一个你实际需要访问的目标。这样即使失败，也能知道失败对应哪一组条件。
在 iPad 上按相同顺序完成选择和授权。屏幕方向、窗口宽度可能影响列表与详情的摆放位置，应按 Home、Config 等界面名称寻找入口，而不是只凭截图中按钮的绝对坐标操作。若页面布局与截图不同，优先确认当前所在页面及操作对象。
需要停止本次连接时，返回 Home 关闭顶部开关，再观察连接状态是否结束。如果此前设置过 On Demand，系统可能按其条件再次触发连接；这时应先检查触发条件，而不是重复删除配置。首次上手无需额外开启 On Demand，先手动验证一轮更容易定位问题。
STEP 04 / VERIFY REQUESTS
Connectivity Test：把测试结果与实际访问分开核对
验证需要看三件事：测试有没有响应、实际目标能否访问、请求是否按预期策略处理。三者相互关联，但不能互相替代。某次测试显示响应，只能说明对应测试方法下得到了结果，不能据此推断所有协议、所有网站和所有规则都正常。
先做一次测试，再发起实际请求
保持第三步的连接与服务器选择，在 Home 点击 Connectivity Test，等待测试结果。记录当前使用的网络、服务器以及 Global Routing，不需要追求某个固定的延迟数字。若显示超时，也先不要删除条目，因为测试目标、测试方法与服务器状态都可能影响结果。
随后切换到需要联网的应用，打开一个明确的目标页面或刷新实际内容。尽量发起新的请求，避免把已经缓存的页面误认为连接有效。若目标需要账号登录或自身服务出现问题，也应把这些情况与网络连接问题分开判断。
用 Data 对照规则，而不是只看总流量
返回 Shadowrocket，在 Data 中查看可用的请求或连接记录，对照刚才访问的目标、时间及策略信息。使用 Config 时，重点检查请求是否走向预期的 PROXY、DIRECT 或 REJECT。总流量增长只说明有数据活动，不足以证明某个域名命中了你想要的规则。
如果 Proxy 下目标可以访问，切回 Config 后却失败，先核对当前启用的配置、具体规则顺序和 FINAL，而不是马上重填服务器密码。反过来，若 Proxy 下也失败，排查重点应先回到服务器参数、网络路径与实际目标。模式对照应在同一服务器、同一网络、同一目标下进行，才有解释价值。
如果只出现域名访问异常，再进一步考虑 DNS；不要在尚未确认症状时同时更换多个 DNS、协议参数和规则。每次修改一项，保存后重新建立连接并发送新请求，记录结果。缓存及既有连接可能让旧结果暂时保留，因此一次刷新不一定足以说明修改是否生效。
STEP 05 / ISOLATE FAILURE
Settings：按现象定位常见失败点
排错先分类，再改设置。保留原有配置和可恢复的记录，不要把清空所有条目作为第一步。以下顺序从导入、本地连接、远端测试到规则逐层检查；找到对应现象后，完成一项修改就回到第四步复测。
导入后没有服务器：先看输入内容
订阅无法更新或分组为空时，重新核对完整链接是否复制成功、是否失效，以及当前网络是否能访问订阅地址。若返回的是账户登录页或错误提示，需要处理订阅本身的访问问题。已有服务器不会因为再次点连接就自动补齐，反复开关也不能修复不符合预期的订阅内容。
手动条目保存成功但无法使用时，逐项比对 Type、Host、Port 及该协议要求的身份和安全字段。尤其要确认资料没有混用：一个服务器的主机名不能随意搭配另一个条目的密码或传输设置。对不理解的字段先查原资料，不凭名称猜测填写。
开关无法保持：先看本地授权与触发条件
开关一开就关时，先确认系统 VPN 配置授权是否完成，以及是否存在其他正在影响系统 VPN 连接的配置。回到 Settings 查看 On Demand；如果之前设置了按网络触发的条件，先记录原值，暂停自动触发后手动复测，区分主动连接失败与条件规则反复触发。
若需要检查系统中的 VPN 配置，可在系统设置中搜索 VPN 并核对对应项目。不要在没有备份的情况下批量删除配置，也不要仅凭状态栏图标推断某个远端服务器已经通过验证。
测试超时但表现不一致：检查 Test Method
在 Settings 找到 Test Method，确认当前测试方式。不同方法验证的对象和阶段不同，测试结果不能直接等同于实际应用的全部访问能力。先用同一方法比较，再配合实际目标请求判断；不要把所有条目的单次超时都认定为同一种故障。
必要时在原有网络与另一种自己可用的网络之间做对照，每次保持服务器和模式不变。若只有某一网络下失败，继续检查该网络的限制、认证或连接状态；若多个网络都在同一条目上失败，则回到服务器资料和服务状态核对。
只有部分请求失败：再检查规则与诊断
只有特定目标失败时，在 Data 中找到对应请求，检查它是否被 REJECT、是否走了意外的 DIRECT，以及更靠前的 Rule 是否已经匹配。修改前记录规则位置与原值；不要直接把所有请求改到同一策略来掩盖问题，临时对照完成后应恢复预期模式。
Settings 中的 Diagnostics 可作为进一步收集信息的入口。诊断内容可能涉及目标地址、订阅信息或连接参数，分享前应检查并遮去身份信息。首次设置阶段不要随意调整 Proxy、TCP、UDP 下不熟悉的项目，这些设置应围绕明确症状逐项验证。
完成排错后，回到 Home 选择确认可用的服务器，恢复预期的 Global Routing，再重复测试与实际访问。日常维护、订阅更新、Data 阅读和 Settings 的进一步解释，见Shadowrocket 系统教程。本页的终点是获得一组经过验证、能够恢复的基础设置，而不是一次调整完所有高级选项。
