Shadowrocket 使用教程：
导入、连接与验证

打开 Shadowrocket，进入 Home，在 SERVER 分组附近找到 Add Server；也可以使用界面上的添加入口进入同一编辑页。先查看 Type，再开始填写。Type 决定后面出现哪些字段，不能只因某个表单更短就随意选择协议。订阅链接是一段用于获取条目列表的地址；单个服务器信息则通常包含协议、地址、端口以及对应的认证参数，两者用途不同。

已有订阅链接：选择 Subscribe

在 Add Server 的 Type 中选择 Subscribe，将本人已有的完整订阅链接填入 URL。粘贴后检查首尾是否带空格、换行，是否只复制了地址的一部分。链接中的查询参数也属于地址内容，不要为了缩短文字而删除。可用备注区分不同配置来源，但备注只是本地识别信息，不会修正错误链接。确认后使用当前页面的保存或完成入口，返回 Home，等待列表获取结束。

成功保存与成功获取列表不是同一件事。返回后应确认订阅下已经出现实际服务器条目，而不是只有一个订阅名称。若列表为空或提示获取失败，先检查网络是否能访问该订阅地址、链接是否仍有效，再向原有服务提供方核对订阅状态。此时反复打开连接开关不能补齐缺失的条目。订阅内容后续变化时，可使用对应订阅的更新操作重新获取；更新前注意保留需要的本地备注，并确认没有选中已被移除的旧条目。

已有单个服务器信息：逐项填写对应字段

如果拿到的是服务器参数，在 Type 中选择与资料一致的协议，再填写 Host、Port 等字段。Host 填服务器域名或地址，不要把整段订阅链接填进去；Port 填资料给出的端口。以 Shadowsocks 为例，Password 与 Method 都需要与服务器端一致。其他协议可能出现不同的认证、TLS 或传输字段，应按原始资料逐项对应，不能把一种协议的参数套进另一种表单。

核对时尤其注意数字与字母、密码前后空格，以及 TLS 相关名称是否与原始配置一致。遇到没有提供的字段，先确认它是否为该协议必需，不要根据网上另一份示例猜值。页面底部的 Scan QR Code 可用于读取本人有权使用的配置二维码；Import from Cloud JSON 面向相应格式的数据，不是把任意文本变成可用配置的通用入口。对首次使用者，保持一种导入方法便于定位错误。

保存后回到 Home，确认 SERVER 中出现可识别的条目，并点选本次要使用的服务器。订阅可能包含多个条目，导入完成并不代表当前选中项一定正确。到这一步，应已经有一个选中的服务器；接下来再决定哪些请求使用它。Subscribe 与 Config 的区别可在概念速查继续阅读。

返回 Home，点开 Global Routing，区分配置(Config)/代理(Proxy)/直连(Direct)。这里的选择是处理请求的总体方式，不是服务器协议，也不是订阅类型。切换后回到 Home 核对当前显示的名称，避免以为已经选中、实际仍停留在上一种姿态。

配置(Config)：按当前配置文件匹配规则

Config 会根据当前配置文件中的规则决定请求使用的策略，例如 DIRECT、PROXY 或其他已定义策略。使用前进入 Config，确认正在使用哪个文件，再查看其中的 Rule。不要仅凭文件名称判断内容，也不要把“列表里存在这个文件”等同于“这个文件正在生效”。如果规则引用了特定策略或服务器，还要确认这些引用在当前配置中有对应对象。

截图中的 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 是配置文件不同部分。首次连接并不要求逐段编辑，更不需要为了连接而开启所有相关功能。先使用本人理解且有权使用的配置，保留原始副本，确认基础请求能通过，再逐项增加需要的规则。Add Rule 用于新增规则，不是添加服务器的入口；服务器条目仍应在 Home 中管理。

规则顺序会影响结果。若目标请求先命中了 DIRECT，后面更具体的 PROXY 规则就可能没有机会被检查。因此，“选中了服务器但网站仍直连”不一定是服务器保存失败，也可能是 Config 的匹配结果。此处先掌握选择与核对方法，规则关键字和更完整的配置说明见Settings 与规则参考，避免在首次连接时同时修改复杂配置。

代理(Proxy)：用于检查所选服务器的代理路径

Proxy 让通常受该姿态处理的请求使用代理路径，可用于临时排除规则选择带来的干扰。它适合回答一个较窄的问题：在不依赖当前分流规则的情况下，所选服务器能否完成目标访问？它不是“所有问题的修复开关”，也不会自动纠正密码、端口或 TLS 字段。完成对照后，若日常需要按规则分流，应切回 Config 并继续核对规则。

直连(Direct)：作为直连对照

Direct 用于直接连接的路径，不应在该姿态下期待请求按所选服务器代理。需要比较直连和代理表现时，可以保持同一个目标地址，只切换姿态后重新发起请求。一次只改变一个条件，才能判断差异来自哪里。选择完成后记下当前姿态和服务器名称，下一步的连接、验证都以这个状态为起点。

回到 Home，核对 SERVER 中选中的条目，并确认 Global Routing 是刚才选择的 Config、Proxy 或 Direct。若刚才更新过订阅，应再看一次选中项是否仍存在。首次测试尽量保持当前网络稳定，不要在点开连接的同时切换 Wi-Fi、修改配置或更新订阅，以免无法分辨是哪一步改变了结果。

打开 Home 顶部的连接开关。首次建立连接时，系统可能提示允许添加 VPN 配置。阅读提示，确认操作来自当前打开的 Shadowrocket 后，按系统要求允许并完成设备验证。这个授权用于让应用建立相应的本机网络连接；它与购买应用、填写订阅链接、验证服务器密码是不同环节，不能互相替代。

如果此前取消了授权，先回到应用重新尝试，并留意是否再次出现系统提示。不要为了通过授权而提供与当前设备验证无关的账号信息。若设备由组织管理，相关限制可能影响 VPN 配置的添加，应按设备管理要求处理，而不是不断删除已有配置。系统设置路径可能随系统版本变化，应以设备实际显示为准。

授权完成后返回 Home，等待连接状态变化。官方截图中的 Not Connected 表示截图拍摄时尚未连接，不是要求把应用保持在这个状态。实际操作应观察开关是否保持开启、状态是否转为已连接；若立即关闭或持续无法建立，先进入本页常见失败点检查授权与参数，不要继续把“连接未建立”当成规则错误来处理。

连接状态成立，只说明本机连接流程已经进入相应状态，并不能单独证明某个网站走了 PROXY，也不能保证远端服务可用。反过来，看到系统 VPN 标识也不能据此判断每个请求的最终策略。下一步需要通过 Connectivity Test、实际访问和请求记录进行交叉验证。首次验证完成前，先不要增加 On Demand 等自动化设置。

列表没有内容：先检查订阅获取

若 Home 中尚未出现可选服务器，检查 Subscribe 的 URL 是否完整、订阅请求是否返回错误，以及本人已有的订阅是否仍可用。确认获取完成后再选择条目。订阅获取失败与某个服务器连接失败应分开处理；不要把服务器的 Host 和订阅 URL 互换，也不要把包含认证参数的链接发到公开讨论中。信息是否有效应向原有服务提供方核对，客户端购买记录不能代替这项核对。

条目存在但访问失败：回看 Type 与认证字段

打开对应条目的编辑页，与原始资料逐项对照 Type、Host、Port 和认证字段，再检查该协议需要的传输与 TLS 参数。只改动已经发现不一致的字段，保存后用同一目标复测。不要以关闭证书校验作为通用排错方法；证书名称、系统时间与配置资料需要分别核对。若所有字段一致但仍失败，记录当前网络和错误现象，再判断是否需要服务端状态信息。

连接开关不保持：检查授权及自动连接条件

若连接尚未建立就自动关闭，先检查系统 VPN 配置是否允许添加、是否有其他已启用的网络配置影响当前连接。Settings 中的 On Demand 用于按条件触发连接，不会修复错误的服务器参数。若已经设置过 On Demand，排查时先确认当前条件是否会触发自动连接或改变预期行为；基础手动连接验证完成后，再按实际需要设置。相关说明见On Demand 参考。

测试与实际访问不一致：检查测试方法和请求记录

Settings 中的 Test Method 会影响测试方式。比较前后结果时，应保持测试方法一致；更换方法后结果变化，不应立即解释为服务器性能改变。需要进一步分析时，可查看 Diagnostics 相关入口，并结合 Log 中的实际错误判断。Language、Today Widget 等设置不是修复认证失败的必要步骤；Proxy、TCP、UDP 下的设置也不宜在没有明确依据时成组修改。

若只有某个域名失败，优先检查该请求的规则命中、DNS 结果以及目标本身状态；若所有请求失败，先回到连接和参数阶段。特别是 Proxy 可用、Config 不可用时，应先找配置差异，而不是立即重填订阅。每次改动后都使用步骤四的基准重新验证，确认改善能够重复出现，再保留这次修改。

分享排错信息前：删除敏感内容

可记录失败发生在哪一步、当前姿态、所用协议、错误文字以及是否能稳定复现，但不要公开完整订阅链接、密码、认证标识或带私人信息的配置文件。截图和日志也可能包含这些内容，应逐项检查后再分享。保留原始配置副本，避免在连续试改后失去可恢复的起点。更多分场景说明见疑难解答；需要逐项理解 Settings 时再进入选项手册。