Shadowrocket 使用教程：从导入到连接验证

订阅地址：选择 Subscribe 后保存

打开 Shadowrocket 的 Home，找到 Add Server，或使用页面上的添加入口进入新增页面。打开 Type 列表，选择 Subscribe，再在订阅的 URL 输入位置粘贴自己已有的完整地址。可以填写便于辨认的名称，然后保存返回 Home。若保存后尚未出现服务器，使用该订阅条目的更新操作，等待获取结果，不要连续重复添加同一地址。

复制时应从地址开头到结尾完整选取，尤其注意问号后面的参数。不要把网页标题、说明文字、引号或末尾空格一起粘贴进去。订阅地址通常含有访问凭据，应当像密码一样保管。如果拿到的是账户管理页面而非订阅地址，客户端无法把它当作服务器清单解析；应先向你自己的服务商确认地址用途，再尝试导入。

导入成功后，回到 Home 的 SERVER 分组，检查是否出现订阅分组与服务器条目。名称出现只说明资料已进入客户端，不代表远端服务器一定可连接。先选中其中一个条目，再继续下面的模式选择。订阅中的流量或有效期说明如有显示，应以对应服务的账户信息为准，不能据此推断客户端的购买状态。

手动填写：Type 决定后续字段

如果准备的是单条服务器信息，在 Add Server 中先选 Type，再逐项填写。以截图中的字段为例，Host 是服务器地址，Port 是端口，Password 是认证内容，Method 需与服务器端给出的加密方式一致。其他协议可能显示不同的认证、传输或 TLS 字段，应按已有资料填写，不能把一种协议的字段机械套到另一种协议上。

Host 一般填写域名或 IP 地址，不要顺手加上网页路径；Port 应按服务端实际配置输入，不因某个常见端口更熟悉就替换。保存前逐项回看，尤其是密码中的大小写、数字与符号。若资料没有说明某项是否必填，先确认协议要求，而不是随机打开额外选项。协议名称与字段关系可查看术语表。

二维码与 JSON：先确认内容类型

已有服务器二维码时，可以使用 Scan QR Code 并按系统提示允许相机访问。扫码后仍需核对 Type、地址与端口，再保存。Import from Cloud JSON 面向对应的 JSON 导入内容，不是粘贴任意订阅地址的通用入口。无论使用哪种方式，最终都应回到 SERVER 分组检查条目，避免停留在编辑页面却以为已经完成添加。

本步完成标志：Home 中已经有可选的服务器记录，并且你明确知道当前选中的是哪一条。接下来决定哪些请求使用该服务器。

回到 Home，点击 Global Routing，查看当前选择。首次操作先辨认三个姿态：配置(Config)、代理(Proxy)、直连(Direct)。此处的 Config 是模式名称，底部导航中的 Config 则用于管理配置文件；它们相关，但打开某个文件进行查看不等于已经把该文件选作当前配置。

配置(Config)：让规则决定请求路径

如果你已经有明确来源并理解用途的配置文件，可以选择配置(Config)。随后到 Config 页面确认正在使用的文件，查看 Rule 中的策略与顺序。通常请求会按规则匹配结果走 PROXY、DIRECT 或 REJECT。配置里引用的策略名称必须有对应定义；仅导入服务器订阅，不应直接当作已经导入了一套完整规则。

官方截图展示了配置编辑页中的 General、Rule、Hosts、URL Rewrite 与 HTTPS Decryption 等分段。初次连接只需确认当前文件与 Rule，不必为了完成教程而修改每个分段，也不需要开启 HTTPS Decryption。Add Rule 用于新增规则；在尚未理解现有顺序时，不要随意追加规则，否则可能把问题从“连接失败”变成“规则提前命中”。

代理(Proxy)与直连(Direct)：用于明确路径

暂时没有可确认的规则配置时，可以短暂使用代理(Proxy)检查当前服务器的基本可用性。该模式下通常由所选服务器处理可代理的请求，不能据此假定所有系统流量都经过相同路径。直连(Direct)则用于不经代理服务器的访问；在此模式下能够打开网站，并不能证明刚添加的服务器可用。

如果 Proxy 可以访问、Config 却无法访问同一目标，应优先检查规则、策略引用与解析路径，而不是马上更换密码。反过来，若两者都失败，先确认服务器与当前网络。模式切换后要重新发起一次请求，旧连接可能仍保持原来的路径。需要理解 DOMAIN-SUFFIX、IP-CIDR、FINAL 等匹配方式时，阅读代理模式说明与Settings 设置参考，本教程先保留最小调整范围。

本步完成标志：能说清当前选用的模式；使用 Config 时，还能确认当前配置文件。记住这个状态，再进行连接授权。

返回 Home，在 SERVER 分组点选准备使用的服务器，检查选中标记。随后打开顶部连接开关。首次运行时，系统可能提示允许 Shadowrocket 添加 VPN 配置；阅读提示并确认是本次主动操作后，按系统要求完成授权或设备身份验证。此授权用于让客户端接管相应网络请求，不会自动补齐缺失的服务器参数。

如果刚才拒绝了授权，先返回应用重新发起连接，查看是否再次出现系统提示；仍无法继续时，到系统的 VPN 配置管理中确认相关状态。不要从陌生页面安装额外的描述内容来“修复”连接。设备受组织管理时，系统策略也可能限制 VPN 配置，应先确认设备允许的操作范围。

授权完成后回到 Home，观察顶部是否离开 Not Connected 状态，并等待状态稳定。不要快速反复开关：这会让连接建立、断开与测试请求相互交错，反而难以判断哪次操作产生了结果。如果开关立即弹回，记录当时出现的错误；若一直停留在建立连接阶段，先保留当前配置，转到最后的排错步骤检查。

系统显示 VPN 状态，只能说明隧道或网络扩展处于相应状态，不代表每个远端请求都已成功。服务器认证、目标访问、DNS 解析和规则命中仍需要分别验证。完成测试之前，也先不要启用 On Demand，以免自动连接行为干扰对手动开关的判断。

本步完成标志：系统授权已完成，Home 的连接状态稳定，且当前选中服务器没有在操作中被误换。接下来用实际请求确认可用性。

订阅未导入，或更新后没有服务器

先看订阅更新给出的具体错误。获取失败与内容解析失败不是同一件事：前者先检查设备基础网络、地址完整性和订阅访问权限；后者应确认返回内容确实是客户端可识别的服务器资料，而不是登录页、到期提示页或普通网页。更新成功却没有可用条目时，再检查是否有筛选条件，以及订阅本身是否包含有效服务器。

不要为了测试地址而把含凭据的完整订阅链接粘贴到公开检测服务。需要确认订阅状态时，应在自己服务的账户页面核对，或向原服务方说明错误现象。保留已有条目，先尝试更新和核对，不要连续删除全部记录后重新添加。

有服务器，但连接失败或立即断开

重新打开服务器编辑页，对照 Type、Host、Port 与认证参数。使用 TLS 或特定传输时，还应核对对应的服务器名称、路径等字段；这些值应来自既有资料，不凭经验补写。确认设备时间正常，再检查当前网络是否允许访问该地址与端口。参数正确也不代表服务端一定在线，必要时向原服务方确认状态。

如果系统授权没有完成，优先处理授权，而不是修改服务器密码。若连接一打开就被其他自动连接行为改变，进入 Settings 检查 On Demand，并结合系统中其他 VPN 配置的当前状态判断。先用手动连接完成一次验证，之后再配置按需连接条件。

Connectivity Test 失败，但部分访问正常

进入 Settings 查看 Test Method，确认使用的测试方式与要判断的问题一致。某种测试没有响应，不等于网页请求一定失败；同样，某项测试通过也不能证明认证、DNS 与目标服务都正常。保持服务器和模式不变，换一个自己需要使用的实际目标交叉验证，再决定是否继续调整测试设置。

连接正常，但目标打不开或分流不符

先区分域名解析失败、连接超时、认证错误和目标服务返回错误。怀疑 DNS 时，先记录当前取值，再按Settings 设置参考检查系统 DNS、自定义 DNS 与规则的配合；不要一次性加入多个不明来源的解析地址。若 Proxy 正常而 Config 异常，重点查看 Rule 中是否提前命中 REJECT、是否走了非预期的 DIRECT，以及策略引用是否存在。

规则调整前保留一份原配置，修改后重新建立相关请求，再查看命中情况。DOMAIN-SUFFIX 与 DOMAIN-KEYWORD 的匹配范围不同，IP-CIDR 又涉及地址匹配，不宜只凭规则名称猜含义。需要补充基础概念时，先查规则关键字术语，再回到配置修改。

准备可复查的诊断信息

Settings 中的 Diagnostics 可作为诊断入口，具体可用项目以当前界面为准。记录模式、服务器协议、使用网络、失败步骤和错误原文；提供日志前检查其中的地址、认证内容与订阅参数，删除敏感信息。对外说明“在 Config 下某域名超时、切到 Proxy 后恢复”，比只说“不能用”更容易定位。

本步完成标志：能把故障归到导入、授权、服务器、DNS 或规则中的一个阶段，并保留相应观察结果。若连接已恢复，再逐项恢复日常设置，不把排错期间的临时模式当作最终配置。