Shadowrocket 使用教程
导入配置与连接验证

已有订阅链接：使用 Subscribe

打开 Shadowrocket 的 Home，在 SERVER 分组附近找到 Add Server。进入添加页面后点 Type，选择 Subscribe，再把用户已有的完整订阅链接填入对应地址字段。订阅不是普通网站首页，也不是单个服务器域名；应使用服务商明确提供给用户的订阅地址。复制时注意保留问号后的参数，不要混入空格、换行、引号或聊天消息的说明文字。

填写便于辨认的备注后保存，等待订阅内容读取。返回 Home，检查是否出现订阅分组及其服务器条目。如果只有分组名称却没有服务器，不要立即打开连接开关；先检查订阅是否读取成功，再核对地址是否完整、订阅权限是否仍有效。订阅更新会重新获取远端内容，手动修改订阅内的服务器参数可能在更新后被覆盖，长期调整应先确认配置来源。

已有单个服务器信息：按 Type 填写

如果拿到的是逐项参数，在 Add Server 中先选择对应 Type，再填写 Host、Port 以及该类型要求的认证信息。官方截图中的 Password、Method 等字段对应截图所选类型，并不是所有协议都使用同一组字段。Shadowsocks、VMess、VLESS 或 Trojan 等类型应分别按已有信息填写，不能仅凭字段看起来相似就相互替换。

Host 通常填写域名或 IP 地址，不要擅自加上网页路径；Port 应与服务器提供的端口一致。若已有信息还包含 TLS、传输方式、路径或其他参数，也应逐项核对。保存前再检查容易遗漏的首尾字符，尤其是复制得到的认证内容。无法确定某项含义时，先向自己的服务商核实，不用猜测值反复尝试。

已有二维码：使用 Scan QR Code

已有兼容的配置二维码时，可以从 Scan QR Code 进入扫描流程；系统请求相机权限时按实际需要允许。扫描完成后仍要检查识别到的 Type、Host 和 Port，再保存。Import from Cloud JSON 是另一个导入入口，不应把普通订阅地址、网页地址与 JSON 配置混为一谈。二维码和订阅链接都可能包含访问凭据，不要转发到公开讨论区。

回到 Home 后，在 SERVER 分组选择刚添加的一条服务器。此时列表出现条目只说明信息已经保存，不代表服务器一定可达。下一步先决定请求如何处理，再打开连接开关，这样验证结果才有明确依据。

添加完成后返回 Home，点 Global Routing 查看当前姿态。本教程按配置(Config)、代理(Proxy)、直连(Direct)说明三种选择。首次使用不要只记住某个选项的位置，应先确认这次测试要回答什么问题：是验证服务器能否工作，还是验证规则是否按预期分流。两种目标需要分别观察，不能用一次打开网页的结果同时证明全部设置正确。

配置(Config)：按当前配置处理

日常需要规则分流时选择配置(Config)。然后进入 Config 页面，确认当前启用的是自己准备使用的配置，而不是仅仅看到文件已经存在。服务器订阅与规则配置是两类内容：前者提供连接信息，后者描述请求如何处理；导入订阅不等于已经完成符合自己需求的规则配置。

官方 Config 截图展示了 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等分段。首次上手只需确认配置来源、当前启用状态，以及 Rule 中的处理意图，不必逐段修改。需要编辑时先保留副本，再通过 Add Rule 或现有规则编辑入口做单项调整。尤其不要为了让一次测试通过而同时修改 Hosts、DNS 相关设置与规则，否则出现异常时很难知道是哪项改变造成的。

代理(Proxy)与直连(Direct)：用于对照

代理(Proxy)用于把测试重点放在当前选中的代理连接上，适合临时判断服务器参数与连接是否可用，但不等于所有应用、所有类型的请求都必然具有相同结果。直连(Direct)则用于直连对照；在此姿态下网页能打开，不能据此断定服务器连接已经成功。完成对照后，应恢复原来计划使用的姿态。

例如，Rule 中的 DOMAIN-SUFFIX,example.com,PROXY 表达匹配 example.com 及其子域并交给 PROXY 处理；它不是可用服务器信息，也不能替代订阅。规则按配置中的顺序匹配，前面的命中可能改变后续结果。第一次连接无需编写复杂规则，先使用自己已经确认来源与用途的配置。更多规则边界与异常情况参阅问题诊断，常见概念参阅疑难解答。

现在回到 Home，确认 SERVER 分组中已经选中了要测试的服务器，并记住 Global Routing 的当前值。点页面顶部连接开关；尚未连接时可看到 Not Connected。首次建立连接时，系统可能弹出添加 VPN 配置的授权提示。核对请求来自 Shadowrocket 后允许，并按系统要求完成设备认证。这一步仅允许客户端创建系统网络配置，连接仍需使用用户已有的订阅。

完成授权后返回 Home，观察开关与连接状态是否保持。若先前取消过授权，应再次打开连接开关并查看系统提示，不要因为曾经点过一次开关就认为授权已经完成。iPad 的页面布局可能因屏幕宽度有所不同，但仍按 Home、Global Routing 和 SERVER 这些界面词查找对应位置，不必对照截图中的像素位置逐一点击。

开关已经打开只证明客户端进入了连接流程；系统显示 VPN 状态也不等于远端服务器、域名解析和每条规则都验证成功。因此此时先不要批量更换节点或导入更多配置，而应继续完成下一步测试。保留当前服务器、网络和姿态不变，可以让后续观察具有可比性。

如果开关打开后马上关闭，先看是否有权限提示或错误说明，再检查系统中的 VPN 配置是否允许使用。受组织管理的设备可能受网络权限策略限制，应向设备管理方确认，不要擅自删除管理配置。如果设备同时存在其他 VPN 连接，先停止冲突的连接再重试；不要在无法判断用途时删除系统配置。

准备切换服务器或大幅修改配置前，可先关闭连接，保存修改后再重新打开。这样既能确认当前究竟使用哪组信息，也能避免把旧连接的状态误认为新配置的结果。后续如果发现自动重新连接，先记下现象，再到 Settings 检查 On Demand，而不是连续反复拨动开关。

保存或导入失败：回查输入内容

订阅读取失败时，先核对完整地址是否复制成功，当前网络能否访问订阅所在的服务，以及用户自己的订阅权限是否有效。服务器条目保存失败时，检查 Type 与必填字段，不要用更换 Global Routing 来解决输入错误。订阅更新成功却没有预期条目时，先核对返回内容与分组，再联系自己的服务商确认；不要把链接发到公开页面让他人代测。

开关不能保持：回查授权与系统状态

如果问题发生在开关打开的一瞬间，优先检查系统授权是否完成，以及是否有其他 VPN 连接或设备管理策略影响。若明明关闭后又自动连接，进入 Settings 查看 On Demand 是否启用，并核对触发条件。On Demand 用于按条件连接，不会修复服务器密码或端口错误；为排查临时调整时，应记下原设置，验证后按自己的使用需要恢复。

测试超时：回查参数与 Test Method

打开 Settings 可以看到 Test Method 等选项。测试方式不同，结果含义也可能不同，因此先确认当前采用的方式，再解释 Connectivity Test 的表现。对照已有服务器信息检查端口、认证、TLS 和传输参数，并确认系统日期与时间准确。只在一种网络下失败时，可在条件允许的情况下换到另一种网络复测，但每次切换后应重新确认连接状态。

仅部分请求失败：回查配置与 Diagnostics

部分网页异常时，不要立刻把所有请求长期改为 Proxy。先对照上一步的姿态测试，检查 Config 中是否有更早命中的规则，再结合 Settings 的 Diagnostics 与可用记录定位问题。截图中的 Proxy、TCP、UDP 是设置分类，不应被理解为必须全部修改的修复清单。只有证据指向具体选项时，才调整相应设置。

需要分享诊断信息时，先移除服务器地址、认证信息、订阅参数及能够识别个人访问内容的记录。单次失败无法判断原因时，保留最少复现步骤，比反复删除应用更有帮助。重装前先备份已有配置，否则还会增加重新导入与恢复的工作。

本页到这里完成首次上手闭环。持续超时、DNS 异常、更新后异常或 iPad 特定问题，请到问题诊断按症状逐项处理；界面词与日常使用疑问可查看疑难解答。继续排查时沿用本页“每次只改一项、使用同一目标复测”的方法，避免引入新的不确定因素。