Shadowrocket 入门指南

已有订阅链接：选择 Subscribe

打开 Shadowrocket 的 Home，找到 Add Server，进入后点 Type，选择 Subscribe。把你已有的订阅链接完整粘贴到相应 URL 字段，填写便于自己辨认的备注，再保存。这里需要的是能返回订阅内容的链接，不是服务商的登录页面或介绍页面。链接末尾的参数可能用于身份验证，复制时不要删除，也不要额外加上引号、空格或换行。

保存后返回 Home，检查 SERVER 中是否出现订阅分组和服务器条目。如果应用提示请求失败，或只出现分组但没有条目，先不要继续连接。确认链接仍有效、内容格式能被识别，以及当前网络能否取得订阅内容。订阅获取与连接服务器是两个环节，订阅保存成功不代表其中每个服务器都能连接。

后续更新订阅时，应使用对应分组的更新操作，更新后重新检查当前选择。远端内容可能调整条目名称或移除旧条目，因此需要确认原来选中的服务器仍存在。为避免难以区分，首次操作不必重复导入同一个链接；先把一个分组核对清楚，再管理更多配置。

已有单个服务器：先核对 Type

如果你拿到的是一组地址、端口和认证字段，而不是订阅链接，在 Add Server 的 Type 中选择与服务器实际一致的协议。随后填写 Host、Port，以及该协议要求的 Password、Method 或其他认证字段。截图展示的是一种字段组合，不能据此把所有协议都按同一组字段填写。Type 选错后，即使地址与密码输入正确，也可能无法建立有效连接。

Host 应填写服务器给出的主机名或地址，Port 使用对应端口，不要把完整网页地址直接塞进 Host。Password、密钥等内容通常区分大小写；粘贴后应检查首尾空格。Method 只在相应协议需要时按原始信息选择，不以名称相近为依据猜测。遇到 TLS、SNI、传输方式等附加字段时，保持与原始配置一致；暂不理解的字段可查阅概念速查，协议参数的设计取舍见协议详解。

已有受支持的二维码时，可使用 Scan QR Code，并按系统提示授予相机权限。Import from Cloud JSON 是另一种输入方式，不应把普通订阅链接随意当作对应 JSON 地址使用。无论采用哪种方式，保存后都回到 Home，确认条目名称和类型符合预期。能在列表中看到服务器，才进入下一步；这仍只是信息已保存，还不是连接已验证。

回到 Home，点 Global Routing，先看当前选中的项目。入门时重点区分三种姿态：配置(Config)/代理(Proxy)/直连(Direct)。不要只凭连接开关的状态判断请求一定经过了哪条路径；姿态不同，同一服务器选择下的访问行为也可能不同。

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

选择配置(Config)时，应用依据当前配置中的规则处理请求。进入 Config，确认你准备使用的配置文件已被选中，再查看 Rule 中是否存在与你的用途相符的规则。配置文件不仅可能包含规则，还可能带有 DNS 等设置，因此导入服务器订阅与选择规则配置是两件不同的事。已有订阅并不等于已经取得适合自己的完整规则配置。

截图中的 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 是配置编辑中的不同分段。首次连接不需要逐个开启或修改。尤其不要为了让普通连接生效而随意调整 HTTPS Decryption；这不是基本连接的必经步骤。若只是核对规则，先查看 Rule，理解后再使用 Add Rule，编辑前保留原始配置以便恢复。

规则关键字需要保留原文。例如 DOMAIN-SUFFIX,example.com,PROXY 表示匹配指定域名后缀并使用相应处理方式；FINAL,DIRECT 是未被前面规则匹配时的一种兜底处理。这里的片段仅用于辨认语法，不是建议直接覆盖个人配置。规则顺序、处理方式与当前服务器共同影响结果，遇到陌生关键字先查说明，不要只复制单行就期待得到完整配置。

代理(Proxy)与直连(Direct)：用于区分路径

代理(Proxy)以代理路径处理请求，适合在排查时核对已选服务器能否承担实际访问；直连(Direct)以直连路径处理请求，可用来对照本地网络表现。两者是路由方式，不是新增服务器，也不会替你修改错误的认证信息。排查完成后，应回到你实际需要的姿态，而不是长期保留临时测试状态。

首次操作可以先明确自己的目标：已有可信的规则配置并希望按规则处理，就选 Config 并核对当前配置；只是要区分服务器路径与本地路径，可以在 Proxy 和 Direct 下分别做同一项访问测试。每次只切换一个选项，记录当前选择，避免同时更换服务器、规则和 DNS 后无法判断是哪一项产生了变化。准备好后返回 Home，进入连接步骤。

在 SERVER 选中要使用的条目

回到 Home，在 SERVER 中点选本次准备使用的服务器，确认选择标记位于预期条目。若你刚更新过订阅，尤其要检查当前选中的条目是否已改变。服务器名称只是便于识别的标签，不足以证明地址、认证信息和远端状态正确；首次测试尽量固定一个条目，避免在不同条目之间来回切换。

接着核对 Global Routing 显示的当前姿态。如果打算使用 Config，确认前一步已经检查了配置文件；如果正在用 Proxy 或 Direct 做对照测试，就记住这次测试的姿态。确认后打开 Home 顶部开关。未连接时，截图中的顶部区域显示 Not Connected；打开后应等待应用更新连接状态，不要连续快速点按开关。

核对系统提示后完成授权

首次建立连接时，系统可能询问是否允许添加 VPN 配置。这个权限让 Shadowrocket 能按所选设置处理设备网络请求。确认提示对应 Shadowrocket 后，选择允许，并按系统要求完成身份验证。如果暂时拒绝或取消，本轮连接可能无法继续；返回应用重新发起连接，再核对系统提示，不需要因此重新导入订阅。

授权不是购买服务器服务，也不代表服务器已经通过验证。系统显示 VPN 状态，只能说明相关连接或配置处于活动状态，不能据此断定所有页面都能正常访问。若你之前使用过其他 VPN 配置，先确认是否有仍在工作的配置或系统管理限制；不要在不清楚用途的情况下删除由工作或学习环境管理的项目。

状态稳定后再开始访问

返回 Home，观察顶部连接状态是否保持稳定。若开关立即回落、反复尝试或出现错误提示，先保留提示内容，转到最后的失败点排查，不要继续叠加修改。若状态稳定，可以先做 Connectivity Test，再打开平时要使用的目标页面。iPad 上也按这一顺序操作，控件位置以当前应用布局为准，关键界面词保持一致。

首次建立连接前，建议先保持 On Demand 为当前明确可控的状态，不急于添加按需条件。手动连接、断开和验证都能复现后，再了解自动触发的条件。这样遇到连接自行恢复时，可以区分是手动操作结果，还是按需行为，减少排查时的变量。

订阅失败：先确认能否取得内容

如果失败发生在导入或更新阶段，先检查 URL 是否完整、订阅是否仍有效，以及当前网络能否访问订阅地址。若返回的是登录页面、错误页面或不受支持的内容，即使浏览器能打开这个地址，也不代表应用能把它识别为订阅。不要把完整链接交给陌生的检测页面；订阅链接本身可能包含访问凭据。需要确认内容状态时，向你已有的服务商核对，不必先修改所有连接设置。

服务器存在但连不上：复核字段与权限

列表有条目而连接失败时，先核对 Type、Host、Port 和认证字段，再检查该协议要求的附加参数。不要通过随机更换 Method、TLS 或传输方式试错。若配置来自订阅，先更新并检查条目是否仍有效；若来自手动填写，则逐项对照原始信息。系统 VPN 授权未完成时，回到连接步骤处理权限；身份验证错误则需要回到服务器字段，而不是反复申请权限。

连接稳定但打不开：区分 DNS 与规则

能保持连接却打不开目标时，先用相同目标比较 Proxy 与 Config 的结果。如果只在 Config 下异常，查看当前配置是否选对、Rule 是否把目标交给了不合适的处理方式，以及 DNS 是否能完成解析。域名解析失败与远端连接失败是不同环节，不应一看到超时就同时修改 DNS、规则和服务器。更详细的概念可在DNS 与网络术语中核对，常见表现见问答与故障排查。

若只有部分页面或应用异常，记录具体目标与发生条件，比笼统描述“全部连不上”更有帮助。若所有测试都异常，先确认本地网络本身可以使用，再在另一个你有权使用的网络中做对照。网络切换会改变条件，因此切换后重新记录结果，不要混用前一轮的测试结论。

测试矛盾或连接自行恢复：检查 Settings

进入 Settings，先看 Test Method，确认 Connectivity Test 使用的方法，再比较同一方法下的结果。On Demand 可能使连接按条件触发；如果手动断开后又重新建立连接，应检查已有按需条件，而不是仅反复关闭开关。首次排查应先让手动操作可以稳定复现，再配置自动行为。

需要进一步定位时，可查看 Diagnostics 中当前可用的诊断项目。Settings 中的 Proxy、TCP、UDP 等设置与具体连接行为有关，但不是统一的“修复按钮”。保留默认或已经验证的设置，只有在掌握原因时才调整。每次更改后重复同一个测试；如果没有改善，就恢复原值，避免积累无法追溯的修改。

保留必要记录，遮盖敏感信息

记录问题时，保留失败发生的步骤、当前姿态、协议类型、错误提示，以及“本地网络是否可用、其他条目是否同样失败”等判断信息即可。分享截图或诊断内容前，遮盖完整订阅 URL、认证参数、Password、密钥与个人地址。不要为了求助公开整份配置文件。

至此，首次操作的闭环是：信息已保存、姿态已明确、权限已完成、实际访问已验证。若仍有异常，按对应失败层继续阅读问答；需要理解不同协议参数时再进入协议详解。不必在入门阶段一次改完所有高级设置。