Shadowrocket 使用说明

打开 Shadowrocket，进入 Home。在 SERVER 分组查找现有条目；如果尚未添加，点 Add Server 进入填写页面。先判断手中的资料是哪一类：包含协议、服务器地址和认证字段的是单台服务器信息；用于拉取多个条目的网址是订阅地址。两者都能用于配置，但填写位置不同，不要把订阅网址直接放进 Host。

手动添加单台服务器

在 Add Server 中先点 Type，选择资料对应的协议，再填写下方字段。Type 会影响需要显示的输入项，所以应先选协议、后填内容。以 Shadowsocks 为例，核对 Host、Port、Password 和 Method；Host 填服务器域名或 IP 地址，Port 填连接端口，Password 与 Method 按已有资料逐字填写。不要将网页路径、说明文字或多余空格带入服务器地址。

不同协议的认证方式不同。VMess、VLESS、Trojan 等条目可能需要其他标识、传输方式或 TLS 相关字段，应以用户已有的完整连接资料为准。不要为了让表单看起来完整而猜测参数，也不要将一种协议的字段机械套到另一种协议。填完后保存，返回 Home，确认 SERVER 下新增了可选择的条目。

导入用户已有的订阅

如果已有订阅链接，在 Add Server 的 Type 中选择 Subscribe，在订阅地址字段粘贴完整网址，按页面提示保存。订阅地址可能包含用于识别用户的查询参数，应保留原有内容；不要截断问号后面的部分，也不要将网址发到公开讨论区。保存后等待读取完成，回到 Home 查看对应分组是否出现服务器条目。

订阅导入成功的判断依据是实际出现了服务器，而不只是保存了一个名称。若仅出现订阅分组但没有条目，先检查链接是否完整、当前网络是否能读取订阅、服务是否仍有效，再执行该分组的更新操作。连续重复添加同一个地址通常只会增加重复分组，不会解决读取失败。

使用二维码或分享链接

用户已有二维码时，可从 Scan QR Code 读取；首次使用相机时按系统提示授权。已有协议分享链接时，使用应用提供的导入入口，并在保存前核对解析出的 Type、Host 和 Port。Import from Cloud JSON 是另一种数据导入方式，只有资料确实采用相应格式时才使用，不要把任意订阅网址放进去试填。

完成其中一种方式即可，不需要三种方式都做。返回 Home，点选一个服务器作为本次测试对象，记住所选条目的名称。下一步只调整 Global Routing，不再同时更换服务器，这样验证失败时才能判断问题来自哪一处。链接类型的详细区别见术语表。

已有可选服务器后，回到 Home，点 Global Routing。这里决定连接采用哪一种路由姿态，不是再次选择协议。界面的三种姿态对应配置(Config)、代理(Proxy)、直连(Direct)。先理解它们分别做什么，再选本次连接需要的选项。

配置(Config)：按当前配置文件分流

配置(Config)按当前生效的配置文件处理连接。规则可能将一部分目标交给代理、另一部分目标直接连接，也可能拒绝特定连接。因此，选中某台服务器不代表全部访问都会经过它，还要看目标匹配到哪条规则以及该规则使用什么策略。

切换到底部 Config，查看当前使用的配置文件，再进入文件检查内容。官方截图中的 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 是配置编辑页的不同分段；规则主要在 Rule 中查看，Add Rule 用于添加规则。首次上手不必逐段修改，更不需要为普通连接测试启用 HTTPS Decryption。

规则通常按顺序匹配，具体行为取决于规则类型和配置。下面是便于识别语法的片段，不是可直接替代现有文件的完整配置；其中 example.com 是示例域名，PROXY 也需要在实际配置中有对应的可用策略。没有完整配置资料时，不要仅复制几行就覆盖当前文件。

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

代理(Proxy)：先确认服务器是否可用

代理(Proxy)将可代理的连接交给当前选中的服务器，适合首次验证服务器或与 Config 的结果做对照。它不能修复填错的密码、失效的服务或不可达的端口，也不等于所有应用的所有系统流量都必然经过同一条路径。测试前先确定服务器选中状态，再切换姿态。

直连(Direct)：用于直接访问对照

直连(Direct)直接连接目标，不通过所选代理服务器转发。它可以帮助判断当前基础网络是否可用，但不能用来验证代理服务器的可用性。若开启开关后访问表现与原来相同，先看 Global Routing 是否停在 Direct，而不是立即重装应用。

建议首次先用代理(Proxy)完成一次连接验证，确认服务器基本可用后，再切回配置(Config)检查规则是否符合日常需求。姿态是本次排查的一个变量，修改后记住原来的选择。规则顺序、策略引用与配置文件管理的完整说明见使用手册。

回到 Home，先做两项确认：SERVER 分组中已选中刚才添加的服务器，Global Routing 显示本次要用的姿态。确认后打开顶部开关。未连接时页面会显示 Not Connected；不要把这段状态文字误认为服务器名称，也不要只因服务器条目已保存就认为连接已经建立。

允许系统添加 VPN 配置

首次连接时，系统可能弹出添加 VPN 配置的请求。这个权限让 Shadowrocket 建立系统网络连接通道，不是导入节点，也不会替用户补齐服务器信息。确认请求来自刚打开的 Shadowrocket 后，选择允许，并根据设备提示使用密码或系统身份验证完成授权。

如果点了取消，应用可能仍回到未连接状态。重新打开顶部开关，再完成系统请求即可；不要为此反复新增相同服务器。若设备受组织管理或系统限制，权限可能无法由当前用户批准，应先核对设备管理要求，不要通过删除不明配置来试错。

返回 Home 核对连接结果

完成授权后回到应用，观察顶部状态是否从 Not Connected 切换为已连接的状态。建立连接需要一定时间，不要连续快速拨动开关。状态持续不变时，先记录是否出现错误提示、系统是否完成授权，以及当前所选服务器，再进入后面的排查步骤。

需要从系统设置检查时，可在 iPhone / iPad 的设置中搜索 VPN，查看对应配置及连接状态。系统版本不同，入口层级可能变化，使用设置搜索比记住固定层级更稳妥。若之前删除过 Shadowrocket 的 VPN 配置，再次连接时按提示重新允许添加。

VPN 状态只表明系统通道是否建立，不保证服务器能转发请求，也不说明某个网站命中了代理规则。此时先保持服务器与路由姿态不变，进入下一步做访问验证。测试期间若有其他管理网络连接的功能正在工作，应先确认是否存在冲突，并保留原设置以便恢复。

遇到问题时，先保留服务器与配置文件，不要从删除全部内容开始。用“当前网络、已有资料、所选姿态、实际错误”四项描述现象，再按下面的顺序检查。每改一项，重新连接并重复同一个访问测试；没有改善就恢复原值，避免多个修改叠加后无法判断原因。

没有服务器，或订阅更新后仍为空

返回添加步骤，确认订阅地址没有漏字符、附带空格或被聊天工具拆行。地址可保存不代表能够读取到有效内容。检查基础网络与服务有效期，查看更新时的错误信息。如果服务方更换了订阅地址，按用户已有的新地址修改原分组即可，不必保留多份相同订阅。涉及用户凭据时，只通过适当的私密渠道核对。

开关无法保持连接

先确认系统 VPN 授权是否完成，再检查当前是否选中了服务器。若有明确的认证或连接错误，按提示检查 Type、Host、Port 和认证字段。切换 Wi-Fi 与蜂窝网络做一次对照，有助于区分当前网络问题和服务器问题；使用蜂窝网络前应注意自己的数据使用安排。

连接建立，但所有目标都失败

先断开连接，确认基础网络可以访问正常服务；基础网络本身不可用时，先处理登录网络或信号问题。基础网络正常后，短时用代理(Proxy)验证同一个服务器。如果仍失败，核对服务有效期、服务器状态与协议参数；若用户已有其他可用条目，可只更换服务器进行对照，不要同时改 DNS 和规则。

只有 Config 下部分目标失败

确认当前生效的是预期配置文件，再检查规则顺序和实际命中。较宽泛的规则放在前面可能让后面的细规则没有机会生效，FINAL 则处理前面未命中的请求。不要一看到访问失败就删除全部 Rule，也不要直接将所有连接改成 DIRECT；应先定位目标实际使用了什么策略，再修改最小范围的规则。

测试失败，或域名解析异常

打开 Settings，检查 Test Method。不同测试方法测到的内容不同，单个结果不能代表全部应用流量。若出现域名解析相关错误，先记录当前 DNS 设置，使用同一个域名复测，必要时恢复已知可用的配置后比较。不要一次填入多个不明 DNS 地址，也不要通过关闭 TLS 验证来掩盖域名或证书不匹配。

Settings 中的 Diagnostics 可用于进一步定位。查看诊断结果时，重点保留错误类型、发生时的网络环境与操作顺序；分享前遮盖订阅地址、认证信息、个人域名和其他敏感内容。Proxy、TCP、UDP 等设置会影响不同层面的行为，初次排错先保留原值，不要把所有开关都改动一遍。

如果问题只在锁屏、切换网络或自动重连后出现，再检查 On Demand 的条件与系统网络变化。先证明手动连接可用，再处理自动触发。更细的权限、订阅更新和 DNS 问题可查常见问题；需要理解每个英文设置项时，查术语表，不必在一次上手过程中修改所有高级选项。