Shadowrocket 使用教程

打开 Shadowrocket，进入 Home。在 SERVER 区域找到 Add Server，进入添加页面。此处首先要确认 Type：它决定随后需要填写哪些字段。已有订阅链接时按订阅方式导入；只有一台服务器的参数时，按对应协议手动填写。首次操作选择其中一种方式即可，不必同时添加多份相同记录。

已有订阅链接：选择 Subscribe

在 Add Server 中打开 Type，选择 Subscribe，回到添加页面后将自己的订阅链接填入 URL 对应输入框。粘贴后检查开头、结尾是否完整，特别留意聊天工具复制时附带的空格、换行和说明文字。保留原链接中的参数，不自行删改用于识别订阅的部分，然后使用页面的保存操作返回 Home。

导入需要通过网络读取订阅内容。等待读取结束后，检查 Home 的 SERVER 中是否出现相应分组或服务器记录。若只有订阅名称而没有可选记录，先确认读取是否成功；保存了一个地址，并不等于已经取得服务器列表。订阅内容更新后，使用该订阅记录提供的更新操作重新读取，再检查列表是否变化。

已有服务器参数：逐项填写

手动添加时，Type 必须与服务方提供的协议一致，再填写 Host 和 Port。Host 通常填写服务器域名或 IP 地址，不额外加网页路径；Port 填写对应端口。Password、Method 及其他认证字段随 Type 变化，截图展示的是其中一种字段组合，不能据此推断每种协议都需要相同内容。

逐项对照自己的资料，不凭名称相近猜测取值，也不要把订阅链接粘到 Host 中。若手头是二维码，可使用 Scan QR Code 读取后核对字段；Import from Cloud JSON 是另一种资料入口，只在自己的资料明确符合该格式时使用。导入完成仍应确认 Type、地址和认证信息，而不是仅检查记录是否出现。

保存后回到 Home，点选本次准备测试的服务器记录。订阅分组里有多条记录时，明确当前选中的是哪一条，后续测试才有对应对象。订阅地址和认证信息可能包含访问凭据，不要公开粘贴到求助文本或截图里。关于订阅与配置的区别，可继续查阅术语表；目前先保留一条信息完整、来源明确的记录，进入模式选择。

服务器记录保存后，回到 Home，打开 Global Routing。这里选择的是流量处理方式，不是更换服务器，也不是连接开关。三种姿态分别是配置(Config)、代理(Proxy)、直连(Direct)。先明确本次要验证什么，再选择模式，避免把模式切换当成连接失败时的随机尝试。

使用 Config 前确认配置文件

若已有明确用途的配置文件，进入 Config，确认当前使用的是哪份文件，再查看其中的 General、Rule 等内容。进入编辑页面看到文件，并不必然表示它已被选为当前使用配置；返回列表后核对使用状态。首次上手不建议一边导入服务器，一边修改大量规则，否则连接异常时很难区分问题来自哪一层。

Rule 中的规则顺序会影响匹配结果，最终匹配项决定前面未匹配请求的去向。下面只是规则语法示例：它表示示例域名走 PROXY，其余由 FINAL 指向 DIRECT。不要直接把这两行当作适合所有用途的完整配置，也不要仅为完成本教程而替换自己的配置文件。

DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

若当前目标只是判断新增服务器能否工作，可以先选代理(Proxy)进行一次范围明确的测试；验证后再切回所需的配置(Config)，检查分流是否符合预期。若选了直连(Direct)，网页能够打开只能说明直接连接在当前条件下可用，不能证明刚才添加的服务器有效。

截图中的 Hosts、URL Rewrite 和 HTTPS Decryption 属于更深入的配置内容，不是首次连接的必做项。本次保留现有值，不额外启用自己尚未理解的设置。规则关键字的含义见术语表，配置与 DNS 的系统说明见设置参考。选好模式后返回 Home，下一步再打开连接。

回到 Home，先看三处：SERVER 中是否选中了本次要使用的服务器，Global Routing 是否为刚才确定的模式，顶部是否仍显示 Not Connected。服务器记录的存在、模式的选择、连接开关的状态是三个不同条件，任何一处都不能替代另外两处。

确认后打开顶部连接开关。首次连接时，系统可能提示添加 VPN 配置。阅读提示，确认请求来自 Shadowrocket，再按系统流程决定是否允许，并完成设备要求的身份验证。此授权用于创建系统网络连接配置，不是订阅导入成功的证明，也不代表远端服务器已经可用。

若取消了系统授权，返回应用后连接可能无法建立。此时先重新发起连接并确认系统提示，不要急着删除已经正确保存的服务器信息。若设备受管理策略限制，系统可能不允许添加或启用相关配置，应先核对设备限制，不能仅靠修改客户端字段解决。

完成授权后返回 Home，观察顶部状态是否离开 Not Connected，并确认开关保持开启。如果开关立即回到关闭状态，记录是否出现提示；如果看起来已经连接，则继续下一步验证实际请求。不要只凭状态栏图标或开关颜色判断所有网站都能访问，连接状态与目标请求成功之间还隔着服务器、DNS 和规则等环节。

测试期间暂时避免同时调整 On Demand。它可能根据已保存条件影响连接行为，容易让首次操作时的开关变化难以解释。如果发现手动关闭后又重新连接，先检查是否设置过 On Demand，而不是不断重复开关。关于条件触发和系统行为，可在完成基础测试后阅读Settings 设置参考。

需要结束本次连接时，回到 Home 关闭顶部开关，并确认状态恢复。关闭连接不会自动删除已保存的订阅、服务器记录或配置文件，下次仍可在核对当前选择后继续使用。现在先保持连接，进行实际验证。

连接失败时先保留当前资料，不要一次删除订阅、替换配置并重置 Settings。按基础网络、服务器、模式、DNS、规则的顺序检查，每完成一项就复测前一节选定的目标请求。下面的顺序用于缩小范围，不意味着所有问题都能通过某一项固定设置解决。

先确认基础网络与服务器资料

关闭连接，检查设备当前网络能否完成日常网页请求。基础网络本身不可用时，应先处理 Wi-Fi、蜂窝网络或当前网络需要完成的接入步骤。网络恢复后重新打开 Shadowrocket，再测试同一服务器，避免把网络切换带来的变化误认为某个协议字段的效果。

如果订阅读取失败，先检查链接是否完整、是否仍有效，以及当前网络能否读取该地址；如果列表已出现但连接失败，检查所选服务器的 Host、Port、Type 和认证字段。订阅成功读取只说明取得了资料，不代表其中每条服务器都可连接。服务状态或资料有效性需要向自己的服务方确认，本站不提供替代连接资料。

再区分模式、DNS 与规则问题

确认 Global Routing 没有停在直连(Direct)。代理(Proxy)可用、配置(Config)不可用时，回到 Config 核对当前使用文件，查看目标是否被前面的规则匹配，以及 FINAL 指向哪里。修改前保留原配置，先定位导致差异的条目，不要把整份规则替换成来源不明的内容。

若表现为域名解析错误，检查是否改动过 DNS，以及设置是否与当前网络环境相符。不要为排错随意指定未核实的 DNS 地址，也不要通过关闭证书验证掩盖其他问题。DNS 与连接路径相互影响，详细参数及排查边界请参阅设置参考；本页只要求先识别问题发生在哪一层。

最后查看 Settings 与诊断信息

进入 Settings，找到 Test Method，先理解当前测试方法再解释 Connectivity Test 的结果；测试不响应可能与测试方法有关，仍应结合实际请求判断。需要进一步定位时查看 Diagnostics，结合错误发生时间寻找对应信息。Proxy、TCP、UDP 等项目属于具体行为设置，不是必须全部修改的“连接前开关”。

如果连接自动启停，检查 On Demand；如果只是 Today Widget 的状态与预期不同，先回到 Home 核对实际连接，再检查显示层面的问题。一次只处理一种现象，不把小组件显示、远端连接和规则匹配混成同一个故障。恢复已改动的单项设置后，再重复相同测试。

需要整理问题时，写清设备当前网络、导入方式、Global Routing、失败目标与提示内容。分享诊断信息前，遮盖订阅完整地址、Password、认证标识和其他私密字段，只保留定位所需的错误上下文。不要公开整份原始配置。协议名及规则关键字不熟悉时，先查看术语表，再决定是否继续调整。

排查结束后，恢复到已经验证过的服务器与模式，保留有效配置，关闭不再需要的诊断记录。基础连接稳定之后，再逐项学习 DNS、On Demand 和配置管理；详细操作集中在Settings 设置项参考，无需在首次连接时全部完成。