Shadowrocket 使用教程：
订阅导入与首次连接
从已有连接信息开始，依次完成添加、选择路由、连接授权和验证。本文只讲首次使用所需的操作；规则字段与匹配原理另见配置参考。
如果已经完成某一步，可直接跳转到后续章节。排查时尽量保留当前设置记录，每次只改变一个条件。
STEP 01 / IMPORT
Add Server：添加服务器或导入订阅
打开 Shadowrocket 后，先进入 Home。这里用于查看服务器列表、选择当前服务器和控制连接。首次使用时，先判断手中资料是哪一种：完整的订阅链接，还是包含协议、服务器地址、端口及认证字段的单台服务器信息。两种方式择一即可，不必为了开始连接同时完成两套操作。
已有订阅链接：选择 Subscribe
在 Home 点击右上角的添加入口，进入 Add Server，打开 Type 并选择 Subscribe。在 URL 栏粘贴完整订阅链接，为条目填写便于辨认的备注，再通过页面右上角的保存入口完成添加。粘贴后先核对开头、结尾与查询参数，特别注意复制过程是否带入空格或换行。
保存后返回 Home，等待订阅内容获取完成，再检查订阅分组及其中的服务器条目。订阅名称出现，并不一定表示服务器内容已经成功载入；应展开对应分组，确认里面有可选择的条目。若列表为空或出现获取错误，先停在本步骤，核对链接及当前网络，不要急着打开连接开关。
订阅更新是重新获取服务端发布的列表，不等于连接已经建立。以后服务商调整服务器信息时，可在对应订阅的操作菜单中使用更新操作，并检查更新后的条目。已有选择可能因列表变化而需要重新确认，更新完应再查看当前选中的服务器。
已有服务器信息：按 Type 填写
如果拿到的是单台服务器参数，同样从 Home 进入 Add Server，但 Type 应选择资料指定的协议，例如 Shadowsocks、VMess、VLESS 或 Trojan，而不是 Subscribe。根据所选 Type 显示的字段，填写服务器地址、端口、密码或其他认证信息。字段是否需要填写，由协议和你已有的资料决定，不能从另一个协议的示例中随意补值。
服务器地址与完整网页地址不是同一个概念。资料要求填写主机名时，应只填对应主机名；端口填写到端口栏，认证内容填写到对应认证栏。涉及 TLS、Server Name 或传输参数时，按资料逐项核对，不要用关闭安全检查来代替修正参数。完成后保存，返回 Home 查看条目是否出现。
已有二维码：使用 Scan QR Code
如果已有资料以二维码提供，可使用 Scan QR Code 读取，并按系统提示授予相机权限。识别完成后，仍需检查导入结果中的 Type、地址及必要字段；识别成功只说明二维码内容被读取，不代表服务器能够连接。二维码与订阅链接一样，可能含有私人认证信息，不要公开展示。
最后，在 Home 选择一个准备使用的服务器，确认列表中的选中标记落在目标条目上。到这里，连接资料才算准备完成。下一步先决定流量按哪种方式处理，再启动连接。
STEP 02 / ROUTING
Global Routing：选择流量处理姿态
回到 Home，点击 Global Routing 查看当前选择。三种姿态分别是配置(Config)、代理(Proxy)、直连(Direct)。它们决定请求如何选择策略，不会改变服务器的地址或认证资料，也不能修复错误的订阅链接。
配置(Config)：按当前配置文件处理
Config 会使用当前启用的配置文件，根据规则判断请求应走 PROXY、DIRECT、REJECT 或配置指定的策略组。准备使用这个姿态时，先进入底部的 Config 页面，查看当前生效的配置文件。仅有一份文件出现在列表中，不等于它已经被选为当前配置；应通过选中标记或当前配置状态确认。
首次使用不需要立刻编辑整份规则。若已有可信且符合自身需求的配置，先确认它已启用，再返回 Home 选择配置(Config)。订阅主要用于更新服务器资料，配置文件则负责规则及其他设置，两者不是同一份内容；添加订阅后，不能据此认定所有分流规则也已配置完成。
代理(Proxy)：先检查服务器链路
Proxy 将请求按代理姿态处理，适合在首次连接时减少规则分流对判断的影响。已有服务器且想先确认它能否工作，可以暂时选择代理(Proxy)，完成后面的连接与网页测试。它不意味着每个应用、每种请求都会得到相同结果，也不能保证服务端一定可达。
如果 Proxy 下目标可以访问，而切回 Config 后同一目标失败，应优先核对当前配置、命中规则和策略组选择，而不是立即删除服务器。验证结束后，根据日常使用需求恢复合适的姿态，不必一直停留在用于排查的选择上。
直连(Direct)：请求不经代理服务器
Direct 用于直连处理。它适合确认原有网络访问是否正常，或在需要直连的场景下使用。选择直连(Direct)后，即使连接开关仍处于打开状态，也不能据此认为请求正在经过所选代理服务器。判断结果时，必须把 Global Routing 与开关状态放在一起看。
选好姿态后返回 Home，再确认一次服务器选中状态。接下来启动连接，并处理首次使用时的系统授权。
STEP 03 / CONNECT
Home：打开连接开关与首次授权
在 Home 确认目标服务器已选中、Global Routing 符合本次测试目的，然后打开顶部连接开关。首次建立连接时，系统可能提示 Shadowrocket 添加 VPN 配置。先核对提示中的应用名称，再选择允许，并根据系统要求通过设备密码或生物识别完成确认。
这个提示用于允许应用建立系统网络连接配置，不是订阅登录，也不要求在弹窗中输入服务器密码。完成系统认证后回到 Shadowrocket，检查开关和连接状态；如果授权过程打断了操作，可能需要再次打开开关。不要只看到系统弹窗消失，就认定连接已经建立。
如果之前取消过授权，再次打开连接开关，按出现的系统提示完成操作。若设备由组织管理、存在配置限制，或系统明确显示不允许修改相关设置，应先确认设备管理要求，不要反复删除现有系统配置。授权类问题与服务器认证失败是两个不同阶段，应分别处理。
首次验证期间，建议先把 On Demand 保持为关闭状态，以便明确观察手动打开和关闭的结果。On Demand 用于按设定条件触发连接，不是提升连接质量的开关。等手动连接、路由选择和目标访问都确认正常后，再按实际需要了解它的条件设置。
系统显示 VPN 状态或应用显示连接已开启，只能说明相关连接状态已经建立，不能保证远端服务器、DNS 和目标网站都工作正常。不要在这一刻就结束检查；下一步需要用实际请求验证结果，并区分“开关打开”和“目标访问成功”。
结束使用时，可回到 Home 手动关闭连接，再检查系统状态是否随之变化。如果关闭后又自动连接，先查看 On Demand 是否启用及其条件，而不是马上判定开关失效。有关按需连接的完整说明，可继续阅读问答中的 On Demand 相关问题。
STEP 04 / VERIFY
Connectivity Test：验证连接与分流
验证应从原有网络开始。若当前 Wi-Fi 需要先完成网页登录认证，应先在浏览器完成认证；移动网络则先确认数据连接正常。基础网络本身无法使用时，反复切换服务器通常不能解决问题。保留一个你平时确定可访问的页面，作为基础网络的检查对象。
先测试当前服务器，再发出实际请求
回到 Home，使用 Connectivity Test 检查服务器连接情况，并确认测试对象包含当前选中的服务器。测试结果可以帮助定位服务器是否可达，但具体结果受测试目标、当前网络和服务器状态影响。一次测试有结果，不等于所有网站及应用都能访问；一次超时也不能单独说明订阅已经失效。
接着打开浏览器，访问一个已知可访问的目标页面。为了避免把缓存页面误认为新请求成功，可刷新页面或重新打开目标地址，并观察是否能继续进入其他页面。使用实际需要的应用再做一次检查，比只看连接状态更能说明当前配置是否适合使用。
在 Config 下检查命中策略
如果使用配置(Config)，应进一步查看 Logs 中与刚才请求对应的记录，关注目标域名、命中规则及最终策略。某个请求命中 DIRECT 并不一定是异常，它可能正是当前规则的预期结果；同样，看到 PROXY 也只说明选择了代理策略，仍需结合请求成功与否判断。
对于“应该经过代理却走了直连”的情况，先检查当前配置是否选对、是否有更靠前的规则先命中，以及策略组是否选择了预期成员。规则通常按顺序匹配，改变其中一条可能影响后续请求。首次上手阶段只需要确认结果，不建议为一次异常连续修改多条规则。
可以做一次有边界的对照：保持同一网络、同一服务器及同一目标，分别在 Proxy 与 Config 下重复请求。如果只有 Config 失败，重点转向规则与配置；如果两者都失败，继续检查服务器资料、基础网络和服务端状态。对照时一次只改一个条件，结果才有解释价值。
STEP 05 / DIAGNOSE
常见失败点：按发生阶段逐项检查
如果前面的验证没有通过，先记录失败发生在哪一步，再按以下顺序检查。订阅无法获取、服务器无法建立连接、特定网站无法访问，分别涉及不同环节。把它们统一归为“Shadowrocket 无法连接”，会让排查范围过大，也容易误改原本正确的设置。
订阅未导入：核对 URL 与获取结果
回到对应 Subscribe 条目，核对 URL 是否完整、是否混入说明文字，以及服务商提供的链接是否仍然有效。浏览器中用于查看账户的页面，不一定就是可直接导入的订阅地址。链接类型或有效性有疑问时，应从你的服务商处获取确认，不要通过随意删改查询参数来尝试修复。
如果之前可以更新、现在获取失败，先确认当前网络可访问订阅地址所需的服务，再重试一次更新。查看错误属于网络超时、认证失败还是内容无法解析，可以帮助区分网络问题与链接问题。不要在尚未确认新链接有效前删除原有可用条目。
列表存在但无法连接：核对服务器字段
先确认选中的不是空分组或错误条目，再逐项核对 Type、服务器地址、端口、认证信息和必要的传输参数。手动输入尤其容易在密码大小写、端口和 Server Name 上出错。若信息来自订阅，优先检查更新是否成功以及已有服务状态，避免手改后又被下一次更新覆盖。
Connectivity Test 超时时，可在条件允许时更换一次基础网络作对照，但保持服务器与测试目标不变。如果切换网络后结果不同，应记录这个差异；如果多个网络都失败，应进一步确认服务器状态。不要仅凭连接开关能打开，就排除服务端连接失败。
只有部分请求失败：检查路由、DNS 与日志
首先查看 Global Routing 是否意外停在直连(Direct)，再确认 Config 页面中启用的是预期文件。对于单个目标异常，在 Logs 中定位相应请求，检查是否命中了 REJECT、意外的 DIRECT 或不同策略组。不要通过把所有请求都长期改为 Proxy 来掩盖配置中的具体问题。
若记录提示域名解析失败，应把 DNS 作为独立环节检查：基础网络是否正常、当前配置是否改动过解析设置、同一域名是否能稳定解析。DNS 字段之间存在关联，不适合在首次连接教程中逐项试填。需要调整时，请转到配置字段与规则参考，先理解当前配置，再作单项修改。
连接状态反复变化：检查系统条件
检查是否刚从 Wi-Fi 切换到移动网络、是否尚未完成网络认证，以及 On Demand 是否触发了重新连接。若手动关闭后马上恢复，先暂停按需条件再观察。若设备显示授权或管理限制，回到系统提示确认原因，不要把它当作订阅失效处理。
仍无法定位时，整理当前 Global Routing、所选服务器的协议类型、失败目标、错误原文及发生阶段，再查看常见问题与故障排查。整理记录时应隐藏订阅 URL、密码、认证字段和二维码等私人资料；保留错误类别与必要上下文即可。