Shadowrocket 使用教程

打开 Shadowrocket 后先停留在 Home，暂时保持连接开关关闭。查看下方 SERVER 分组：如果还没有自己的服务器条目，打开 Add Server。这里需要先判断手中信息属于哪一种：一条可以更新服务器列表的订阅链接，还是某台服务器的协议、地址、端口与认证参数。两者使用的填写方式不同，不要把订阅链接直接填到 Host。

已有订阅：选择 Subscribe

在 Add Server 中打开 Type，选择 Subscribe，再把自己的完整订阅链接填入对应的 URL 输入项。链接应来自你已有的服务信息，复制时保留完整路径及查询参数；聊天记录或文档中的换行、前后空格、中文标点都可能导致读取失败。备注用于区分订阅，可以按自己的用途填写，但备注本身不会改变连接参数。

保存后返回 Home，检查是否出现对应订阅分组及服务器条目。如果只出现分组名称而没有条目，先检查链接是否填写完整，再尝试该订阅的更新操作。订阅导入成功表示客户端已经读取到服务器资料，并不代表每台服务器都可连接，也不代表服务仍在有效期内。下一步需要实际选择一项，而不是只选中分组标题。

已有参数：按 Type 手动填写

如果拿到的是单台服务器的信息，在 Type 中选择与资料一致的协议，再逐项填写。例如 Shadowsocks 常见字段包括 Host、Port、Password、Method。Host 填主机名或地址，Port 填端口，Password 与 Method 必须与原始信息一致；不要凭名称相似自行替换。其他协议可能出现不同的认证、传输或 TLS 参数，字段含义不确定时先查名词解释，不要沿用另一种协议的填写方式。

二维码或分享链接也是导入已有参数的方式。Add Server 中的 Scan QR Code 可用于识别自己的二维码；通过剪贴板导入时，复制完整分享链接后按应用显示的导入提示操作，并在保存后重新核对 Type 与地址。Import from Cloud JSON 面向相应格式的资料，不是任意订阅链接的通用入口。没有对应格式时，继续使用 Subscribe 或手动填写即可。

在 iPad 上，内容区宽度及列表排列可能与 iPhone 不同，但仍先找 Home、SERVER 与 Add Server。导入完成后至少确认三件事：条目确实出现、类型与资料相符、需要使用的条目可以被选中。到这里先不要反复批量添加相同订阅；重复条目会增加后续判断难度。确认一组资料后，再进入 Global Routing。

添加服务器后回到 Home，打开 Global Routing。这里决定请求采用怎样的路由策略；它与 SERVER 中选择哪台服务器是两个不同的设置。首次操作应记录当前选项，避免在连接失败时同时更换服务器和模式，导致无法判断是哪一步改变了结果。

配置(Config)：按配置文件匹配

选择配置(Config)时，请求按照当前使用的配置文件与其中规则处理。进入 Config，先确认实际选用的是哪份文件，再查看 Rule 等分段。仅把文件导入 Config 列表，不等于它已经成为当前生效配置；应按应用显示的选用状态核对。已有经过确认的配置时，先使用原来的文件，不必在首次连接前额外增加复杂规则。

规则通常包含匹配条件与动作。PROXY 表示按相应代理策略处理，DIRECT 表示直接连接目标，REJECT 表示拒绝匹配请求；规则中也可能引用具体策略名称，需要结合文件检查。规则按顺序匹配，因此较前面的条件可能先决定结果。FINAL 用于处理前面未匹配的请求，它的动作同样影响最终路径。理解这些边界后，才能解释为什么连接开启时仍有部分访问走直连。

代理(Proxy)与直连(Direct)

代理(Proxy)以代理路径处理请求，可用于隔离“服务器连接是否可用”与“规则是否符合预期”这两类问题，但它不能保证每个目标都能访问。直连(Direct)使用直接连接路径；如果当前目标本身需要代理路径，选择直连(Direct)后打不开，并不能据此认定服务器参数有误。排查结束后，应恢复适合自己日常使用的姿态。

初次验证可先明确选择一种姿态，再用同一目标测试。已有可信配置并希望按规则使用时，选择配置(Config)；需要暂时排除规则影响时，记录原设置后切换代理(Proxy)做对照。不要因为一次延迟测试成功就长期保留不符合需求的模式，也不要把三种姿态理解为三个不同服务器。

右侧截图展示 Config 编辑中的 General、Rule、Hosts、URL Rewrite 与 HTTPS Decryption。首次连接并不要求逐项编辑这些分段，也不需要为完成本教程去调整 HTTPS Decryption。确认当前配置与预期一致即可继续。规则关键字和匹配条件的详细含义见规则与界面名词解释，文件管理则见订阅指南。

路由姿态确认后回到 Home，在 SERVER 分组中点选准备使用的具体服务器。先核对条目旁的选中标识，再看 Global Routing 是否仍是刚才确定的姿态。订阅中有多个条目时，先选一个资料明确、仍可使用的条目完成验证；不要在浏览器每次刷新时都随意切换，否则前后结果不具有可比性。

接着打开 Home 顶部连接开关。未连接时可见 Not Connected 一类状态提示；打开开关后观察状态变化，而不是仅凭按钮位置判断是否成功。首次建立连接时，系统可能弹出添加 VPN 配置的授权提示，需要阅读提示并按系统要求确认，必要时通过设备认证。该授权用于让 Shadowrocket 建立系统网络连接，不会替代订阅导入或自动补全服务器资料。

完成系统确认后返回 Shadowrocket，等待连接状态更新。如果先前取消了授权，回到应用重新发起连接并处理提示。不要连续快速开关来回尝试：先看提示是否已处理、状态是否稳定，再决定下一次操作。设备上存在其他正在工作的 VPN 配置时，也应先确认实际启用的是哪一个，避免把另一条连接的状态误认为当前结果。

连接状态与实际访问分别确认

连接开关开启，说明客户端正在建立或已经建立相应连接，但还不能证明目标网站、DNS 与所有协议流量都工作正常。此时应继续执行下一步验证，而不是立即修改大量 Settings。尤其在配置(Config)下，一部分请求按 Rule 选择 DIRECT 是正常策略结果，不能只凭某一个页面的出口表现判断整个连接失败。

切到浏览器之前，可以记下当前服务器名称与 Global Routing。返回 Home 后如果状态已经断开，先查看是否出现错误提示；如果状态保持连接但网页无法打开，则把问题归到“已连接但访问异常”，留到第五步按顺序定位。两类现象对应的检查重点不同，区分清楚能减少重复填写参数的操作。

本轮先采用手动连接，暂不启用 On Demand 自动触发。手动验证成功后再配置自动连接条件，比较容易区分系统触发问题与服务器问题。测试完成且暂时不需要连接时，可以回到 Home 关闭开关；后续若已设置 On Demand，还需要结合该设置确认是否会重新触发。

遇到异常先回到最简单的检查顺序：设备基础网络、导入资料、当前选择、连接状态、目标访问。不要一开始就删除全部配置。已有可用备份时保留备份；没有备份时，至少先记录当前设置及错误文字，再做可恢复的小范围调整。

导入后 SERVER 没有条目

确认使用的是 Subscribe，并检查 URL 是否完整。订阅地址与管理页面地址并不相同，浏览器能打开某个管理页面，也不能说明该地址可直接导入。若更新返回错误，记录错误类型，并核对自己的服务状态与链接有效性；不要连续创建同名分组。手动添加时则回到 Add Server 检查保存是否完成，尤其注意是否存在未填写的必需字段。

开关无法保持连接

先确认系统 VPN 配置授权已处理，再检查所选服务器的 Type、Host、Port 与认证字段。密码区分大小写，端口必须与资料一致，协议附加字段也不能任意省略。随后检查设备当前网络是否本身可用；可暂时关闭连接，用熟悉的页面确认基础访问，再回到 Shadowrocket。切换网络做对照时保留其他设置，避免同时更改太多条件。

测试有结果，但网页打不开

先区分浏览器提示的是解析失败、连接超时、证书问题，还是网站本身返回错误。然后检查 Global Routing：如果配置(Config)失败而代理(Proxy)正常，重点查看当前 Config 的 Rule、策略引用与 FINAL；如果两种姿态都失败，继续检查服务器与解析相关设置。不要把所有错误都归给 DNS，也不要因为一次测试正常就完全排除服务端连接问题。

在 Settings 中可以找到 Test Method 与 Diagnostics 等入口。Test Method 用于核对当前测试方式；Diagnostics 可作为进一步查看诊断信息的入口，具体可用项目以应用内显示为准。记录测试时的网络、所选条目、路由姿态与错误现象，才能比较前后结果。DNS 涉及配置中的解析路径与网络条件，先理解当前设置，再有针对性地调整，详细术语可查DNS 与网络名词解释。

只有部分目标失败，或连接反复恢复

只有特定目标失败时，检查对应域名是否被 REJECT、是否命中了不合适的 DIRECT 规则，以及页面资源是否来自其他域名。不要为了一个页面把所有规则全部删除。需要进一步定位时，回看 Config 中的实际匹配顺序，并参考功能与规则分流说明理解动作边界。

如果手动关闭后又重新连接，查看 Settings 中的 On Demand 及相关触发条件。自动连接解决的是何时发起连接，并不保证服务器一定可达。先暂停相关自动触发、完成手动测试，再逐项恢复；不要把“自动重连”与“已经验证可用”混为一谈。迁移、订阅更新和批量删除不属于首次连接的必要步骤，操作前阅读订阅与服务器管理手册中的整理与备份说明。

按本页完成一次连接后，日常使用只需核对所选条目、Global Routing 与连接状态。新增规则或开启 On Demand 时，沿用同样的“小范围修改、实际验证、保留可恢复设置”顺序，不必每次从头导入。