Shadowrocket
订阅导入与首次连接教程

准备资料：区分订阅、服务器与 Config

先确认手中的资料属于哪一种。订阅链接通常用于一次导入并更新一组服务器；单台服务器信息则包含协议类型、地址、端口和认证字段；Config 配置文件主要决定规则、DNS 与策略等行为。三者用途不同，把配置文件地址当作服务器订阅填写，可能出现导入失败或没有服务器条目的情况。

将服务商给出的原始说明保留在可核对的位置。订阅链接可能含有账户凭据，应完整复制，不要公开到评论、截图或聊天群。手动填写时，协议类型必须与资料一致；仅知道服务器地址和端口，通常不足以完成配置。资料不完整时，先向原服务商核实字段含义，不要用猜测补齐。

开始前还应确认设备本身能正常联网。如果当前 Wi-Fi 需要网页认证，先完成认证；若关闭 Shadowrocket 后也打不开普通网页，先处理基础网络。这样后续出现失败时，才能区分设备网络问题与服务器配置问题。下面从 Home 中建立第一个可选条目开始。

01 · Add Server：添加服务器或导入订阅

已有订阅链接：选择 Subscribe

打开 Shadowrocket，进入底部的 Home，点右上角加号进入 Add Server。在类型选择中找到 Subscribe，再将已有订阅链接完整粘贴到 URL 字段。若有备注字段，可填写一个自己能辨认的名称，方便日后区分来源；备注只是本地识别信息，不会修复链接本身的问题。

保存前检查链接首尾是否混入空格、换行或说明文字，尤其不要只复制了聊天界面中被截短的显示文本。确认后点页面上的保存按钮，返回 Home，等待订阅内容读取。正常导入的判断依据是列表中出现实际服务器条目，而不只是出现一个订阅名称。连接开关此时可以继续保持关闭。

如果只看见订阅分组却没有服务器，先使用该订阅条目提供的更新操作，并观察是否报告错误。链接已失效、认证信息不完整、基础网络无法访问订阅地址，都可能导致内容读不到。不要反复添加相同链接制造多个重复分组；保留一份，核对原始 URL 和原服务商的使用说明即可。

已有单台服务器信息：按协议填写

如果收到的是单台服务器参数，同样从 Home 的加号进入 Add Server，但类型应选择资料指定的 Shadowsocks、VMess、VLESS、Trojan 或其他对应协议，而不是 Subscribe。按原始资料填写地址、端口及认证信息，再逐项核对 TLS、传输方式等附加字段。字段是否需要填写取决于协议与服务端设置，不能因为界面允许留空就一律省略。

服务商提供的是可供客户端识别的二维码时，可以使用 Scan QR Code。首次扫描需按系统提示允许相机访问，扫描后仍要检查识别出的类型和字段，再保存。二维码也可能携带连接凭据，不宜向他人展示。如果扫码得到的只是普通网页地址，应回到原始说明确认用途，而不是强行当作服务器信息导入。

完成其中一种导入方式后，回到 Home，确认能找到要使用的服务器。此时只说明“资料已保存”，还不能说明服务器已经连通。下一步需要明确默认服务器和请求的路由姿态，这两项决定连接后流量如何处理。

02 · Global Routing：先选服务器，再选姿态

在 Home 的服务器列表中，点目标服务器左侧圆点，使其成为当前选中的服务器。点服务器名称或详情入口可能进入编辑页，并不一定完成选择；返回 Home 后，应再次检查圆点位置。订阅内有多个条目时，首次先选定一个，不要一边切换服务器一边修改其他设置。

接着打开 Home 中的 Global Routing。这里的三种常见姿态写作配置(Config) / 代理(Proxy) / 直连(Direct)。它们影响请求采用什么策略，不会改变服务器账户本身，也不会让一条失效的服务器信息重新可用。

配置(Config)：按当前配置分流

配置(Config)适合需要按目标分流的日常使用。选择后，应到 Config 页确认当前启用的是哪份配置，并理解它将哪些请求交给 PROXY、哪些交给 DIRECT。仅仅在 Config 页看见文件，不等于该文件已经启用；需要确认当前选中状态。若资料提供了配套配置，先阅读其用途，再决定是否导入并启用。

规则按匹配顺序处理，具体目标可能在遇到 FINAL 前已经命中其他规则。因此，在 Config 姿态下，某个网站可以打开，并不自动代表该网站经过代理。初次上手不必立即编写完整规则，只需知道当前配置是什么、它大致如何分流。配置修改与协议字段的深入说明可继续查看协议参考，相关操作也可在设置说明中核对。

代理(Proxy)与直连(Direct)：用于区分路径

代理(Proxy)主要用于让受客户端处理的请求采用代理路径，便于初次检查所选服务器能否工作。它不是“速度更快”的保证，服务器不可用时也无法正常访问。验证完成后，如果需要按规则区分目标，再返回配置(Config)，并重新验证实际访问。

直连(Direct)主要用于直接连接，不宜拿它作为“服务器已经可用”的证明。即使连接开关保持打开，Direct 下能够访问网页，也可能只说明基础网络可用。切换姿态后返回 Home，再确认当前显示值与预期一致，然后进入连接授权步骤。

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

回到 Home，最后检查两项：圆点选中的是准备测试的服务器，Global Routing 显示的是刚才选择的姿态。确认后打开顶部连接开关。首次使用时，iPhone / iPad 可能显示添加 VPN 配置的系统提示；核对发起应用为 Shadowrocket，再选择允许，并按系统要求完成设备身份验证。

这一授权用于在设备上建立网络处理配置，不是让用户提交订阅密码，也不需要把设备解锁密码告诉任何人。完成系统弹窗后返回 Shadowrocket，观察开关是否保持开启、连接状态是否稳定。不要在授权窗口尚未处理完时连续点开关，否则容易混淆当前操作是否生效。

如果此前拒绝过授权，再次打开开关时应按实际提示处理。也可以在系统 Settings 中搜索 VPN，检查是否存在 Shadowrocket 对应配置。设备受管理策略限制时，添加 VPN 配置可能不被允许，应按设备管理要求处理，而不是反复删除其他系统配置。

若同时存在其他正在连接的 VPN 配置，先断开其他连接，再回到 Shadowrocket 重试，避免系统切换配置造成状态反复。连接开关刚打开就关闭、返回应用发现未连接，与“连接保持但网页打不开”属于不同问题，后面的排查顺序也不同。开关保持开启后，继续执行 Connectivity Test，不要停留在状态图标这一步。

04 · Connectivity Test：验证连接与实际访问

在 Home 找到 Connectivity Test 并执行测试，等待本次操作结束。测试用于提供当前连接的诊断线索；如果出现失败或超时，先记下当时选择的服务器与 Global Routing，再进入下一步排查。教程不预设固定延迟或成功结果，实际表现取决于设备网络、服务器和当前策略。

随后打开浏览器，访问自己实际需要使用的目标，确认页面能否完整加载，而不是只看到缓存中的标题或旧内容。必要时刷新页面，再检查图片、后续请求或登录流程是否正常。一次测试通过仅说明当次测试目标可达，不能保证所有网站和应用都采用同一路径，也不能代替实际业务验证。

如果想区分服务器连接问题与规则问题，可以先记录当前设置，在代理(Proxy)姿态下测试同一个目标，再切回配置(Config)重复测试。两次结果不同时，应优先检查 Config 中针对该目标的规则、策略和 DNS，而不是立即更换整套服务器资料。对照时保持基础网络和测试目标不变，结果才有参考意义。

需要进一步确认请求如何处理时，可查看当前可用的连接或请求记录，按目标域名和测试时间寻找对应项，并核对实际策略。Data 中的流量变化可以辅助确认有活动，但流量增加本身不能证明某个指定目标走了 PROXY。记录中可能含有个人访问信息，对外求助前应删除订阅凭据、账户信息和不必要的目标记录。

当开关能够保持、Connectivity Test 有可用结果、实际目标也能按预期访问时，首次连接才算完成。之后若修改服务器、Global Routing 或 Config，应重复同一组验证，避免将上一次的成功结果当成新配置的结论。

05 · 常见失败点：一次只改一个变量

导入后列表为空

先回到订阅编辑信息，检查类型是否为 Subscribe、URL 是否完整，以及保存后有没有成功读取内容。确认设备在未连接时能正常联网，再尝试更新该订阅。如果原链接需要账户认证或已失效，应向原服务商核实。订阅名称存在与服务器内容存在是两件事，反复打开连接开关不能解决空列表。

开关不能保持开启

先检查添加 VPN 配置的系统授权是否完成，再查看系统 VPN 设置中是否有其他连接正在接管。若是受管理设备，确认相关限制。此类问题优先处理系统授权与连接状态，不要先修改 DNS 或大批量更换规则，因为请求可能尚未进入预期的网络处理流程。

开关已开，但 Connectivity Test 失败

回到 Home，确认圆点仍选中预期服务器，然后核对地址、端口和认证字段。手动添加的条目尤其要检查协议类型与 TLS、传输参数是否对应。若订阅提供多个已有条目，可只切换服务器并重复同一次测试，保留其他设置不变；如果只有一个条目，不必通过猜测端口或密码尝试修复。

还可以在 Wi-Fi 与蜂窝网络之间进行一次对照，但切换前后应保持服务器和姿态一致。若只有某一基础网络失败，先确认该网络是否需要认证、是否存在本地连接限制。每次对照都记录改变了什么，避免同时换网络、换服务器、改配置，最终无法判断哪个变化起作用。

测试有结果，但指定网站打不开

先查看 Global Routing。如果代理(Proxy)下可用、配置(Config)下失败，检查目标是否命中了预期规则，以及规则中的策略是否可用。若直连(Direct)下能打开，也不能据此证明服务器正常。对单个目标的排查应围绕该目标展开，不要把某一网站的故障直接归因于整个客户端。

DNS 也可能导致“连接已建立但域名无法访问”。先记录当前 DNS 设置，再根据现有配置说明核对解析行为；不要随意混入不明来源的地址。如果请求记录提示域名解析异常，应优先解决解析问题，而不是重复导入相同订阅。协议连接与域名解析是不同环节，需要分别验证。

原本可用，更新订阅后失效

订阅更新可能改变服务器列表，先检查当前圆点是否仍指向存在且有效的条目，再核对 Config 中引用的策略是否仍有可用目标。更新服务器资料不等同于更新整份配置；只完成其中一项时，另一项仍可能保留旧设置。确认原服务商是否调整过字段后，再按资料修正。

仍未解决时，整理基础网络类型、选中的协议、Global Routing 姿态、测试现象以及已经做过的单项修改，再查阅协议参考与字段说明。需要重新核对操作顺序时，可从Add Server 步骤回看。求助时描述具体失败环节，比只说“不能用”更容易定位问题。

完成后保留的三项检查

日常使用前，只需先确认 Home 选中的服务器、Global Routing 的当前姿态，以及 Config 中启用的配置。更新订阅或切换网络后，如果访问表现变化，就沿用本页的顺序重新测试。暂时不需要连接时，可以在 Home 关闭连接开关，再确认基础网络状态。

后续学习不必从大量规则开始。先熟悉一次完整的“导入 → 选择 → 连接 → 验证”流程，再到设置说明了解 On Demand 等选项，或到协议参考核对现有服务器的字段含义。保留原始连接资料，修改前记录现状，才能在出现问题时有明确的回退依据。