01 · Add Server：添加已有服务器

打开 Shadowrocket，进入 Home，点击添加按钮打开 Add Server。先选择 Type，再填写其他字段。Type 必须与已有资料中的协议一致，不能仅凭服务器名称推测。Shadowsocks、VMess、VLESS、Trojan、WireGuard 等类型需要的字段不同，切换 Type 后，应重新检查界面显示的必填项。

将服务器地址与端口分别填入对应字段。地址栏通常只接收主机名或 IP 地址，不应把整段网页地址和端口一起粘进去。认证信息按资料填写，注意前后空格、换行以及大小写。若资料包含 TLS、传输方式或其他附加参数，也要逐项对应，不能只填地址和认证信息就保存。

确认 Type 与资料一致，再检查地址、端口和认证字段。
核对附加参数；资料未说明的选项不要随意启用。
填写便于辨认的备注，保存并返回 Home。
点击刚添加的条目，确认其显示为当前选中项。

保存成功只说明客户端接受了这些字段，不代表服务端已经通过验证。暂时不要连续更换多个参数；先保留这一份输入，稍后用统一的验证方法检查。若已有资料是二维码，可以使用 Scan QR Code 读取，保存前仍需核对协议、地址与附加参数。

Home 中已出现服务器后，可以跳过订阅步骤，继续检查 Config。如果计划用订阅统一维护多条服务器信息，则按下一步导入，不必再逐条手动录入同一批内容。

订阅 URL 用来获取服务器条目，不是普通的服务介绍网页。先从你自己的服务商资料中复制完整链接，再到 Home 打开 Add Server，将 Type 选择为 Subscribe，在 URL 字段粘贴链接。可填写容易辨认的备注，检查后保存，等待客户端获取并解析订阅内容。

粘贴时不要手动删减问号后面的参数。某些链接中的参数用于识别访问权限，少一个字符也可能导致获取失败。复制结果若带有引号、前后空格或换行，应与原始资料对照修正。不要把包含个人认证参数的真实链接发给其他人代为测试。

保存后返回 Home，检查对应订阅分组是否出现服务器条目。分组名称可见但内容为空，并不代表已成功导入。需要区分“订阅地址已保存”和“服务器列表已解析”这两个结果。列表正常时，展开分组并选中准备使用的条目，再进入后续连接步骤。

Subscribe 更新后的复查

当服务商说明内容发生变化，或现有条目可能已过期时，在 Home 对应订阅的操作菜单中执行更新。菜单位置和具体显示形式可能随应用界面变化，应以当前应用为准。更新完成后，重新检查列表及选中项；原条目可能被调整或移除，不能只看到更新动作结束就继续使用原选择。

不要在短时间内反复刷新来代替排查。更新失败时先记下错误现象，核对当前设备能否访问订阅地址，以及服务商是否说明了访问限制。订阅列表正常而服务器连接失败，应继续检查服务器参数与连接路径，而不是立即删除整个订阅。

需要进一步区分链接格式与服务端响应问题时，可阅读订阅导入失败或节点为空的自查笔记。导入完成后，下一步检查决定规则行为的配置文件。

03 · Config：确认当前配置文件

打开 Config，查看当前启用的配置文件。服务器条目决定可以使用哪条连接，配置文件则描述规则等处理设置，两者不是同一份内容。订阅导入成功，不意味着当前 Config 中的规则已经更换；反过来，选择了配置文件，也不会自动补齐缺失的服务器认证信息。

第一次使用时先确认现有配置，不必为了完成连接测试立即替换整份文件。如果已有可信且理解用途的配置，可按其说明在 Config 中导入并选用。导入前保留原文件，修改前保存副本。来自未知内容的配置可能改变流量处理路径，不应仅凭文件名称决定是否启用。

下面只用短规则说明阅读顺序，不要求将其直接覆盖到当前文件。示例中的 example.com 是示例域名；PROXY 所对应的实际代理选择仍需核对当前配置与客户端设置。

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

在配置(Config)姿态下，请求按规则顺序查找匹配项。第一行按域名后缀匹配，第二行按目标 IP 范围匹配，FINAL 处理前面没有匹配到的请求。因此，“文件里存在某条规则”不等于它一定会命中，排在前面的规则与最终策略同样重要。

本次先完成“知道正在使用哪份配置”这项检查。需要回看三种处理方式时，使用Global Routing 步骤；应用获取、商店地区与购买恢复等完整背景见安装指南。

04 · Global Routing：选择处理方式

返回 Home，打开 Global Routing。这里决定请求整体采用哪种处理方式，不负责导入服务器，也不会修复错误的认证字段。三种姿态写作配置(Config)、代理(Proxy)、直连(Direct)。先按当前任务选择，再回到 Home 检查所选结果。

配置(Config): 按当前启用的配置文件匹配规则，并执行对应策略。希望区分不同目标的处理路径时使用这一姿态。使用前要知道当前配置及其最终策略，否则某个请求的实际路径可能与预期不同。
代理(Proxy): 以代理方式处理客户端接管的请求，适合在首次检查时减少规则差异的干扰。它仍依赖正确的服务器选择与参数，不能把不可用的服务器变成可用服务器，也不代表每个应用的全部流量都一定被接管。
直连(Direct): 以直连方式处理请求，可用来对照当前网络本身的访问情况。它不等于关闭客户端连接开关。若需要完全停止当前连接，应返回 Home 关闭开关，而不是只切换为 Direct。

首次验证可先用代理(Proxy)检查已选服务器，再切回配置(Config)检查规则行为。若 Proxy 下目标正常、Config 下异常，应优先看规则和策略，而不是马上重新填写服务器。若两种姿态都失败，也不能直接认定服务器失效，还需检查系统连接状态与目标服务本身。

每次切换后使用同一目标重新发起请求，避免用不同页面的表现作比较。验证结束后恢复准备长期使用的姿态，并记录当前配置文件与服务器名称，便于下一次复现。

05 · Home：打开连接并完成系统授权

在 Home 再检查两项：当前服务器确实是准备使用的条目，Global Routing 确实是刚选择的姿态。然后打开顶部连接开关。首次建立连接时，系统可能请求添加 VPN 配置；确认请求由当前正在操作的 Shadowrocket 发起后，再按系统提示允许并完成设备验证。

这个系统授权允许客户端建立所需的网络处理配置，不是购买提示，也不代表服务器认证已经成功。如果先前取消了请求，应回到 Shadowrocket 再次发起连接，按系统提示处理。不要因为开关没有保持开启就连续重复添加服务器，输入内容与系统授权属于不同检查环节。

授权结束后回到应用，观察开关和连接状态是否保持。系统显示 VPN 状态，只能说明相应网络连接状态已经建立，不能单独证明目标网站访问正常，更不能说明某条 Rule 已命中。此时应进入下一步做实际验证，而不是仅凭状态标识结束操作。

若设备上已有其他 VPN 连接，先明确当前哪一个连接正在使用，再进行对照测试。如果连接会在特定网络下自动恢复，可到 Settings 检查 On Demand 是否启用；首次排查建议先记录其设置，避免把按需连接行为误判成手动开关失效。受管理设备的限制应按管理要求处理。

06 · Connectivity Test：验证是否生效

回到 Home，运行 Connectivity Test，观察已添加服务器的测试结果。测试方式和当前网络会影响结果，应先确认本次测试采用的设置。某条记录有响应，说明它通过了该项测试；这不等于认证、目标服务访问以及所有业务请求都已经通过验证。

接着打开浏览器，访问一个你有权使用、能够明确判断是否加载完成的目标服务。不要只看页面标题或已有缓存图片，应重新加载并确认实际内容返回。若目标需要登录，先把登录状态问题与网络连接问题分开，不把权限提示直接当成连接失败。

记录测试时的网络、服务器、Global Routing 与当前 Config。
在代理(Proxy)下重新访问同一目标，确认基本代理路径。
切换到配置(Config)，重新访问并核对规则处理结果。
需要对照时使用直连(Direct)，随后恢复预期姿态。

若要确认规则是否生效，查看应用中可用的连接记录或日志，找到刚发起的目标请求，再核对匹配规则与执行策略。域名命中 DOMAIN-SUFFIX 和最终落入 FINAL 是不同结果，即使两者恰好使用同一策略，也不应当作同一条规则命中。

延迟测试的数值反映特定测试方法下的响应情况，不等同于实际传输速度。应用内测试正常而网页异常时，还应考虑 DNS、目标服务状态和认证问题。一次只换一个条件，并重复同一操作，这样才能判断变化来自服务器、网络还是配置。

07 · 按失败位置排查，不重复清空配置

先用一句话描述失败发生在哪里：“订阅没有解析出条目”“开关不能保持开启”“测试有响应但网页打不开”或“只有 Config 下异常”。这些现象对应不同环节。保存当前配置与必要记录后再处理，不要同时删除订阅、换服务器、改 DNS 和替换规则，否则难以判断哪项修改产生作用。

订阅已保存，但列表为空

回到Subscribe 步骤，核对 URL 是否完整、是否为订阅地址，以及现有访问权限是否有效。如果返回的是登录页面或错误说明，客户端就可能无法解析为服务器列表。需要确认内容格式或权限时，联系自己的服务商，不必先修改 Global Routing。

服务器存在，但连接失败

先看是否选中了正确条目，再逐项核对 Type、地址、端口、认证信息和附加参数。订阅维护的条目可先正常更新一次，随后重新选择。手动录入的条目则按原始资料逐项比较。若换到另一种可用网络后结果不同，应记录网络差异，而不是据此直接修改认证字段。

开关无法开启，或开启后很快断开

检查系统授权是否完成、是否存在其他正在使用的 VPN 连接，以及设备是否有管理限制。若开关会自动重新开启，检查 On Demand 的条件。先解决系统连接环节，再做网页访问测试；反复改规则通常无法解决授权未完成的问题。

Proxy 正常，Config 下部分目标异常

确认 Config 中启用的是预期文件，查看目标请求实际命中的规则，并检查 FINAL 指向。域名规则与 IP 范围规则的匹配依据不同，DNS 结果也可能影响后续处理。先在副本中修改一条规则并复测，不要为了单个目标把整份规则替换掉。

测试有响应，但实际服务仍不可用

检查目标服务是否正常、账号是否具有访问权限，以及客户端记录中是否出现认证、解析或连接错误。向服务商反馈时说明发生时间、当前网络类型、协议类型与已经完成的对照步骤；隐藏订阅 URL、密码和其他认证信息。测试结果只是一条线索，应与实际请求表现一起判断。

后续只需更新已有订阅时，直接返回订阅更新步骤；需要比较分流行为时，返回Global Routing 说明。换机、重装或购买记录问题应阅读App Store 安装指南，不必重新从服务器参数开始排查。

Shadowrocket 使用教程