Shadowrocket 入门指南

先判断手中的资料是哪一种：一条用于更新服务器列表的完整链接，通常按订阅处理；一组协议、地址、端口和认证信息，则按单个服务器处理。两种方式都从 Home 的添加入口开始，但填写内容不同。不要把订阅地址当作 Host，也不要把单个服务器地址直接填进 Subscribe。

已有订阅：选择 Subscribe

在 Home 点击 Add Server 或顶部的添加按钮，进入 Add Server 后打开 Type，选择 Subscribe。在订阅的 URL 字段粘贴自己的完整链接，检查开头、结尾及查询参数是否齐全，再填写便于辨认的名称并保存。链接中夹入空格、换行，或只复制了消息中的一部分，都可能导致导入失败。

保存后回到 Home，等待服务器列表载入；如果没有出现条目，在对应订阅的操作菜单中执行更新，再观察是否返回错误信息。导入成功的核对点是：Home 中出现对应分组及其服务器条目，并且可以选中其中一项。只有订阅名称出现，不等于订阅内容已成功取得。

订阅更新会根据远端内容调整列表。日常不要同时修改订阅地址、服务器字段和配置文件；先确认列表能正常更新，再继续下一步。更新失败时，应核对原链接是否仍有效、当前网络能否访问订阅地址，以及返回内容是否为应用支持的订阅格式，而不是网页提示或登录页面。

已有服务器信息：逐项填写 Add Server

手动添加时，先把 Type 改为资料所对应的协议，再填 Host 和 Port。随后按页面出现的字段填写 Password、Method 或该协议所需的其他认证参数。不同 Type 的字段并不相同：截图中的 Password 与 Method 只是相应类型下的示例，不能据此给所有协议填入同一组参数。

Host 只填写资料指定的服务器域名或地址；Port 必须与服务器实际监听端口一致。密码区分大小写，复制时要注意前后空格。涉及 TLS、服务器名称或传输路径时，也应逐项照原始资料核对，不要凭域名外观推测。保存前再检查一次 Type，避免地址和密码正确，却选错连接协议。

若手中已有对应的二维码，可使用 Scan QR Code 导入后再检查字段。Import from Cloud JSON 只适用于已有且格式相符的云端 JSON 资料，并非任意订阅链接都应从这里导入。完成任一路径后，返回 Home 的 SERVER 分组，确认保存的服务器能被选中，再进入 Global Routing 的设置。

服务器决定代理连接使用哪一组远端信息，Global Routing 决定哪些请求交给它处理。回到 Home，点击 Global Routing，先辨认配置(Config)、代理(Proxy)、直连(Direct)三种姿态。初次使用不要只看开关是否打开，还要确认这里的选择与验证目标一致。

配置(Config)：按照规则决定走向

日常需要按域名或地址分流时，选择配置(Config)，再进入 Config 页面确认正在使用的配置文件。Config 中保存的是规则与相关设置，不是订阅服务器列表；导入订阅成功，不代表已经选中了预期配置。应分别检查 Home 中的服务器和 Config 中的当前文件。

打开配置文件的编辑页面，可以辨认 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等分段。初次上手先核对当前文件来源与 Rule 的末尾策略，不要为了完成连接流程而改动全部分段。尤其不要把 HTTPS Decryption 当作首次连接的必要步骤，本页的连接验证不依赖该项设置。

下面的片段只解释匹配含义，不要求直接替换现有文件。规则通常从上到下检查，先命中的规则决定处理策略；前面的规则都没有命中时，才使用 FINAL。实际请求还会受到当前 Global Routing 姿态和其他设置影响，不能只看某一条规则就判断整个连接结果。

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY

在这个片段中，example.com 及其子域名使用 PROXY；匹配指定私有地址段的请求使用 DIRECT；其余请求最终交给 PROXY。这些地址用于说明语法，不是可用连接资料。修改已有配置前先保留副本，避免测试规则覆盖原有设置。

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

代理(Proxy)让流量主要按代理路径处理，适合在排查时判断问题是否与规则分流有关；直连(Direct)则用于对照当前网络直接访问的结果。两者都不会修复失效的服务器或错误的认证参数。Proxy 下访问失败，应继续检查连接资料，而不是反复切换模式期待参数自动改变。

完成模式核对后，回到 Home 保持选中预期服务器。若只是临时使用 Proxy 或 Direct 做测试，结束后记得恢复日常所需的 Config。配置文件各分段、规则优先级及策略含义见规则与配置字段参考，首次使用先把“服务器、模式、当前配置”三项区分清楚即可。

现在回到 Home，在 SERVER 分组中点击准备使用的服务器，确认选中标记落在预期条目上，再核对 Global Routing。截图顶部的 Not Connected 表示当时尚未连接；它只是状态提示，不能用服务器条目的名称或测试数值代替。

点击 Home 顶部连接开关。首次建立连接时，系统可能提示允许 Shadowrocket 添加 VPN 配置。先阅读系统弹窗中的应用名称与说明，确认这是刚才主动发起的操作，再按系统流程允许，并完成设备要求的验证。此授权用于让系统把相应网络流量交给应用处理，不会替用户补齐服务器地址或认证信息。

完成系统授权后返回 Shadowrocket，观察顶部开关和状态文字是否保持在连接状态。如果开关随即退回，或弹出错误提示，先记录提示内容，回到服务器字段核对，而不是连续快速重复点击。未完成系统授权时，应重新发起连接并处理提示；设备受管理策略限制时，也需要先确认相关限制。

连接状态建立，只说明系统侧的网络处理已启动，不等于目标服务器和所有网页都已可用。某些错误会在实际请求发生后才暴露，例如密码错误、远端不可达、域名解析失败或规则走向不符。因此这一步结束后，必须继续执行下一节的测试与实际访问。

需要停止时，可回到 Home 关闭顶部开关，并确认状态变化。暂时不要在首次验证阶段同时开启新的自动连接条件，否则手动关闭后又重新连接，会让结果难以判断。若已有 On Demand 设置，先了解其触发条件，再决定是否暂停自动行为；相关核对方法见本页设置与排错。

排查时沿着“基础网络 → 资料 → 连接 → 模式 → 规则”的顺序检查。先保存当前配置，记下失败发生在导入、测试、连接还是实际访问阶段；避免一次修改多个字段，否则即使恢复可用，也难以知道是哪项设置起了作用。

列表没有出现：检查导入阶段

先确认设备当前可以正常访问网络，再检查 Subscribe 中的完整地址，尤其是链接末尾的参数。手动更新后若仍没有服务器条目，应核对远端是否返回有效订阅内容，以及自己的订阅是否仍处于可用状态。错误提示应保留原文，但向他人描述时需要隐藏订阅地址中的认证部分。

已有条目但连接失败时，重新打开该服务器编辑页，按原始资料逐项核对 Type、Host、Port 和认证参数。涉及额外传输设置时，也要确认路径、服务器名称等字段。这里的目标是恢复资料一致，而不是尝试随意替换某个协议或加密方式。

开关已开但访问失败：分层定位

先运行 Connectivity Test，再检查 Global Routing。若当前为 Direct，不能用它验证代理服务器是否有效；若当前为 Config，应检查当前配置是否选对，以及目标是否被前面的规则提前匹配。FINAL 只负责此前未命中的请求，不能覆盖前面已经命中的 DIRECT 或 REJECT。

若服务器测试有结果，但域名访问失败，应进一步检查 DNS 设置及相关请求记录。不要把更换 DNS 当成所有问题的统一处理方法：错误认证、远端不可达和规则阻断都不能靠 DNS 调整解决。先记录当前解析设置，确认问题确实发生在域名解析环节后再做单项对照。系统化的检查顺序见开关已开却无法上网的逐项排查。

Settings：先核对，不批量改动

进入 Settings，可以辨认 Test Method、On Demand、Diagnostics、Proxy、TCP、UDP 等入口。Test Method 用于核对当前测试方式；On Demand 用于管理按条件自动连接的行为；Diagnostics 用于查看或生成诊断信息。这些项目用途不同，首次使用不需要把每个设置都改一遍。

若手动关闭后又自动连接，先检查 On Demand 是否仍有满足条件的规则，而不是立即删除应用。若只有某类应用或某种网络下失败，应记录 Wi-Fi 或蜂窝网络、失败目标与发生时间，再结合 TCP、UDP 等相关设置核对。高级设置的具体含义应在确认问题范围后查阅，避免改变与故障无关的项目。

需要保存 Diagnostics 信息时，先检查其中是否包含服务器地址、订阅链接、认证字段或个人访问记录，分享前进行脱敏。可以保留错误类型、发生顺序和已执行的检查，这些信息比完整暴露连接资料更适合用于复查。

完成排查后，回到 Home 重新确认服务器、Global Routing 和连接开关，再按验证步骤复测一次。涉及配置文件结构、DOMAIN-SUFFIX、GEOIP、IP-CIDR 与 FINAL 的深入说明，继续阅读配置字段与规则参考；需要重新梳理操作顺序时，从本页添加与导入重新开始即可。