01 · Add Server / Subscribe：添加已有资料

先按资料类型选择入口，保存后必须能在 Home 找到服务器。打开 Home，在 SERVER 分组附近点击 Add Server，进入服务器编辑页。若手中是一条完整的服务器信息，先选择 Type，再填写对应字段；若手中是订阅链接，则在 Type 中选择 Subscribe，填入完整地址并保存。不要把订阅地址当作单个服务器的 Host。

手动填写时，Type 必须与已有资料中的协议一致。Shadowsocks、VMess、VLESS、Trojan 等协议使用的认证字段并不相同，不能因为服务器地址一样就互换类型。截图展示的是含 Type、Host、Port、Password、Method 的编辑页；切换 Type 后，出现的字段可能变化，按当前协议对应的资料逐项填写。

Host 是服务器地址，Port 是端口。认证信息要完整保留，复制时检查前后空格和换行。Method 等参数应与已有服务器配置一致，不要通过随机选择来尝试连接。涉及 TLS、服务器名称或传输设置时，也以你已有的配置资料为准；字段含义不清楚，可先查概念速查，再回到本步骤继续。

已有二维码时，可使用 Scan QR Code 导入并检查识别后的字段。Import from Cloud JSON 是另一类资料导入入口，不等同于 Subscribe；只有你已有对应格式的资料时才使用。无论选择哪种入口，都应在保存前确认服务器类型、地址与认证字段，而不是只看名称是否熟悉。

Shadowrocket Add Server 页，显示 Type、Host、Port、Password、Method 与 Scan QR Code、Import from Cloud JSON 入口 — Add Server：字段随 Type 变化，按已有服务器资料填写。

订阅保存后，检查的是列表而不只是名称

导入 Subscribe 时，复制完整订阅链接，包括地址末尾的查询参数。某些链接带有用于识别你账户的内容，删去参数可能导致返回内容不同或无法获取。本文不展示真实订阅地址；操作时使用你自己已有的链接，并避免把它放进公开截图、聊天记录或问题描述中。保存后等待应用获取内容，再返回 Home 查看是否出现服务器条目。

如果只出现订阅分组、没有可选服务器，先检查获取或更新结果，不要立即打开连接开关。确认地址仍有效、复制完整且当前网络可以访问；需要更新时，使用该订阅对应的更新操作。更新完成也要再次检查列表，因为服务器名称、顺序或内容可能发生变化。之后在 SERVER 列表选中准备使用的一条，核对选中标记，而不是默认把第一条当作当前服务器。

本步结束时，应能明确回答两件事：列表里是否已有可用的服务器资料，以及当前选中的是哪一条。订阅获取成功只说明列表内容已导入，并不代表其中每条连接都可用。确认这两点后再进入路由模式设置，避免把导入问题误判成规则问题。

02 · Global Routing：选择请求处理方式

先确认模式，再决定是否需要检查规则。回到 Home，点击 Global Routing 查看当前选项。三种姿态分别是配置(Config)、代理(Proxy)、直连(Direct)。这个设置控制请求的处理方式，不负责替你填写服务器地址，也不改变已有服务的认证信息。

配置(Config)按当前配置文件中的规则处理请求。需要让不同目标使用不同策略时，先确认已经选择正确的配置文件，再使用这一模式。代理(Proxy)适合临时检查请求经当前代理处理的情况，但它不能代替对配置规则的验证。直连(Direct)用于直接访问；选择后不应期待请求按代理模式处理。

准备使用 Config 时，打开底部 Config，找到当前使用的配置文件。进入文件编辑页检查 Rule；官方截图中还显示 General、Hosts、URL Rewrite 与 HTTPS Decryption 等入口。初次上手只需确认正在使用哪个文件、规则是否符合预期，不必为了完成连接而修改所有分段。

规则按顺序匹配，先命中的规则决定策略。DOMAIN 与 DOMAIN-SUFFIX 的匹配范围不同，FINAL 通常放在末尾作为兜底。PROXY、DIRECT、REJECT 是规则策略关键字；其中 PROXY 与 Global Routing 中的 Proxy 属于不同层级的设置，看到相似名称时要先分清是在编辑规则，还是切换全局模式。

Shadowrocket Config 配置文件编辑页，显示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 与 Add Rule — Config：先确认当前文件，再检查 Rule 的内容与顺序。

只用一小段规则理解 Config

下面是语法示例，不是要求替换你现有文件的完整配置。第一条让 example.com 及其子域名匹配 PROXY，第二条让其余未命中的请求使用 DIRECT。示例域名仅用于说明写法，不能据此判断你真实目标的访问结果，也不包含任何服务器认证资料。

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

如果把兜底规则放在前面，后续规则便可能没有机会参与匹配。检查真实配置时，除了规则内容，还要看它在列表中的位置。首次验证可先保留已有配置，记录 Global Routing 的选择；遇到“连接已建立，但特定目标走向不对”再回到这一层检查。复杂规则、策略及配置分段的详细解释见规则与配置字段参考，本教程只完成基本模式确认。

本步结束时，应知道当前使用的是 Config、Proxy 还是 Direct；若是 Config，还应知道当前文件的名称。返回 Home 后再次看 Global Routing 的显示值，确认选择已经生效，再进入连接步骤。

03 · Home：授权并打开连接开关

连接前同时核对服务器选择与 Global Routing。回到 Home，确认 SERVER 列表中已选中预期服务器，Global Routing 显示刚才确定的模式。顶部 Not Connected 表示当前尚未建立应用连接；此时打开旁边的开关，开始连接流程。

首次建立连接时，系统可能要求允许添加 VPN 配置。确认提示来自正在操作的 Shadowrocket 后，按系统提示允许，并完成设备要求的身份验证。这个授权用于在系统中创建连接所需的配置，不是订阅获取成功的提示，也不能证明服务器已经通过认证。

若刚才取消了系统提示，返回应用再次尝试连接，并检查系统 VPN 设置中的相关配置状态。不要在尚未确认授权是否完成时反复更换服务器。系统授权与服务器认证是两层不同的检查：前者由设备管理，后者取决于导入字段与已有服务器的状态。

完成授权后回到 Home，查看顶部连接状态和开关是否保持开启。若开关马上关闭、状态持续未连接或出现错误提示，先记下提示的具体文字，再前往本文排错步骤。不要只凭系统状态栏里的图标判断远端服务是否正常；图标、应用连接状态与实际请求成功并不是同一个结论。

Shadowrocket Home 页，顶部显示 Not Connected 开关、Global Routing 的 Config 选项与 Connectivity Test，下方是 SERVER 分组和 Add Server — Home：确认服务器与模式后，使用顶部开关建立连接。

如果设备上已有其他 VPN 配置，先检查当前实际启用的配置，避免测试过程中切换到非预期连接。第一次验证也不建议同时调整 On Demand：按需条件可能改变连接行为，使你难以区分是手动开关的结果还是条件触发的结果。先完成一次明确的手动连接，确认链路能工作，再按需要设置 On Demand。

连接状态稳定后，不必马上改动配置。保持同一条服务器和同一个 Global Routing 模式，进入验证步骤。这样下一步出现差异时，才能判断问题出在测试方式、目标匹配或服务器本身，而不是多个设置一起变化造成的混淆。

04 · Connectivity Test：验证连接与分流

[Rule]

测试结果要与实际访问一起看。在 Home 点击 Connectivity Test，等待结果返回。测试方式可在 Settings 的 Test Method 中查看；不同方法观察的是不同环节，不能把单次结果当作所有网站、所有协议和所有应用都可用的证明。测试未通过时，也应先确认所用方法和测试条件，再判断服务器是否有问题。

服务器可达、应用连接已建立、目标请求按预期策略处理，是三个需要分别确认的事实。即使列表测试有响应，认证信息或后续传输仍可能不正确；即使顶部开关保持开启，某个目标也可能被规则分配给 DIRECT 或 REJECT。验证时先记下服务器名称、Global Routing 和当前配置，建立一个可重复的检查条件。

接着打开浏览器或准备使用的应用，访问你自己熟悉且获准访问的目标，观察页面能否正常完成加载，而不只是首屏是否出现。使用 Config 时，再选择一个预期走 DIRECT 的目标与一个预期走 PROXY 的目标分别检查。如果应用内可查看相关连接记录，核对目标、命中的规则和最终策略；单看页面打开与否，不能可靠推断请求走向。

若实际结果不符合预期，回到 Config 检查目标对应的规则及其前面的规则。域名后缀、完整域名和 IP 地址匹配的条件不同；页面还可能请求其他资源域名，因此主页面能打开、某些资源失败时，需要检查具体失败请求，而不是只检查地址栏中的域名。规则写法有疑问时，查看DOMAIN-SUFFIX 概念说明及配置字段参考。

为了隔离问题，可以在记下原设置后，临时切到 Proxy 复测同一目标。如果 Proxy 下可用而 Config 下不符合预期，优先检查当前配置和匹配顺序；如果两者都失败，回头核对服务器资料与链路状态。这只是缩小排查范围的方法，不是要求长期保留某个模式。检查完成后恢复你实际需要的姿态，并再次验证。

本步结束时，至少应确认一项实际请求已经完成，并知道当前模式是否符合用途。如果只有测试结果、还没有实际访问记录，验证仍未完成。已有配置工作正常时，保留当前结果作为后续对照；如果仍然失败，带着具体症状进入下一步。

05 · Settings / Diagnostics：按失败环节排查

先查基础网络和导入资料，最后再查复杂设置。回到 Home 关闭连接，用同一设备确认基础网络可以完成正常访问。若基础网络本身异常，先处理网络连接，再测试 Shadowrocket。切换 Wi-Fi 与蜂窝网络可帮助判断是否与当前网络有关，但应保持服务器和模式不变，避免同时改变多个变量。

订阅无法获取或列表为空时，检查完整订阅地址、有效状态与更新结果。服务器已经导入但无法连接时，打开该条目的编辑页，对照原始资料检查 Type、Host、Port、认证字段以及相关传输设置。字符大小写、遗漏参数或多出的空格都值得逐项核对；不要用修改规则来补救认证字段错误。

若开关无法保持开启，检查系统 VPN 授权是否完成，并阅读应用给出的具体错误。若连接建立但目标异常，则检查 Global Routing、当前选中的服务器和 Config 文件。特别注意测试后是否仍停留在 Direct，或者更新配置后当前文件已变化。只有这些基本项都确认正确，才继续查看更细的设置。

打开 Settings，找到 Test Method 和 Diagnostics 等入口。Test Method 用来理解或调整测试方式；Diagnostics 可用于查看诊断信息。Settings 中还包含 On Demand、Proxy、TCP、UDP 等项目，初次排错不要逐个切换。只修改与当前症状有关的设置，并记下原值，以便测试后恢复。

Shadowrocket Settings 页，显示 Language、Test Method、Today Widget、On Demand、Diagnostics、Proxy、TCP 与 UDP — Settings：先确认测试方式，需要时查看 Diagnostics。

把症状与下一项检查对应起来

观察到的情况	优先检查	下一步
Subscribe 保存后没有服务器	完整地址、有效状态、获取结果	核对资料后重新更新，再检查 SERVER 列表
连接开关立即关闭	系统 VPN 授权、错误提示	确认授权完成，再对照服务器字段
Connectivity Test 失败	Test Method、基础网络、服务器状态	保持其他条件不变，结合实际访问复测
Proxy 可用，Config 结果异常	当前文件、Rule 顺序、命中策略	检查目标规则前是否已有其他匹配
只有部分请求失败	具体失败目标、协议要求、连接记录	按请求定位，不直接重置全部设置

需要进一步确认已有服务状态时，把症状、发生条件和已做过的检查整理清楚，再向原服务提供方核对。问题描述可包含使用的协议、当前 Global Routing、测试方式和错误文字，不应包含完整订阅链接、密码或其他认证资料。分享 Diagnostics 输出或截图前也要检查敏感内容，保留必要的错误信息即可。

完成基础排查后，若问题明确落在规则匹配或配置字段，转到规则与配置字段参考继续检查；若只是术语不清楚，使用概念速查补齐对应知识即可。快速上手的完成标准不是调整了多少选项，而是能说明当前导入了什么资料、选择了哪个模式、连接是否建立，以及实际请求是否按预期处理。

Shadowrocket 快速上手