Shadowrocket
导入与连接教程

Add Server / Subscribe：添加与导入

打开 Shadowrocket 后先停留在 Home，暂时保持连接开关关闭。接下来只需选择一种录入方式：手上是订阅链接，就使用 Subscribe；手上是服务器地址、端口和认证参数，就在 Add Server 中手动填写。两种方式的目标相同，都是让 Home 中出现能够选用的服务器，不需要为了首次连接同时完成两套操作。

已有订阅链接：在 Subscribe 中保存 URL

在 Home 点右上角加号进入 Add Server，打开 Type 的选项并选择 Subscribe。回到填写页面后，将自己的订阅链接完整粘贴到 URL 一栏；如需填写备注，使用便于辨认的名称即可。保存前检查链接开头、末尾和查询参数有没有被聊天软件或复制操作截断，尤其不要把链接说明文字、空格或换行一并带入。

保存后返回 Home，等待订阅内容读取完成。出现订阅分组和其中的服务器条目，才说明已经取得可供选择的内容；只有一个分组名称却没有服务器时，不要立即打开连接开关。先检查网络能否访问订阅地址，再核对链接是否仍有效。订阅 URL 可能含有个人访问凭据，不要将完整地址放进公开截图或排查记录。

订阅负责批量提供服务器信息，并不等于完整的规则配置。导入成功后仍需在下一步确认 Global Routing。后续更新订阅可能改变列表内容，因此首次测试时先记住所选条目的名称，更新后再核对它是否仍然存在，避免把列表变化误认为连接开关失效。

已有服务器参数：按协议填写 Add Server

若没有订阅而是已有单台服务器信息，同样从 Home 的加号进入 Add Server，在 Type 中选择信息提供方注明的协议，例如 Shadowsocks、VMess、VLESS 或 Trojan。随后逐项填写地址、端口及该协议要求的认证信息。界面中出现的密码、标识、加密方式和传输选项并不是可以互换的字段，不能照着另一种协议的说明猜填。

地址栏填写提供的主机名或 IP，不要自行增加网页路径；端口也必须使用对应服务的数值。涉及 TLS、SNI 或传输参数时，按已有资料逐字核对，留空与填写某个值可能产生不同结果。资料缺失时应先向自己的服务商确认，不要把多个来源的参数拼成一条记录。

保存并回到 Home 后，检查条目名称和协议是否符合预期。此时先不要批量修改服务器参数：列表中能看到条目，只说明信息已经保存，还没有证明服务器可达。接着进入 Global Routing，确定本次连接采用哪条路径，再进行连通性验证。导入格式方面的更多问题见FAQ。

Global Routing：选择路由姿态

服务器已经出现在 Home 后，找到 Global Routing 并点开。这里决定请求如何被处理，不负责修正服务器地址或认证参数。首次操作要先认清三种姿态：配置(Config)、代理(Proxy)、直连(Direct)。它们适合不同的验证目的，选择其中一项后返回 Home，再继续连接，不要在尚未测试时来回切换。

配置(Config)：按当前配置中的规则分流

日常需要规则分流时选择配置(Config)。随后到 Config 页面检查当前选中的配置，确认它确实是自己准备使用的文件，而不只是出现在文件列表里。配置可以为不同请求指定不同策略；因此，在 Config 下打开某个网页，并不能单凭网页是否成功就判断默认服务器有没有被使用。

如果还没有准备规则配置，不必为了首次验证临时抄入一大段规则。先使用下一项代理(Proxy)确认服务器与连接流程，成功后再回到 Config 学习分流。配置文件的导入、选中以及规则顺序属于另一层问题，详细内容可继续阅读疑难手册，本页不要求先完成复杂配置。

代理(Proxy)：先验证代理路径

首次检查已有服务器能否工作时，可以选择代理(Proxy)，减少规则分流对判断的影响。这里的“代理”指 Global Routing 的路由姿态，不是重新添加服务器的入口；仍然需要在 Home 选择一台已有服务器，再打开开关。Proxy 也不代表能够自动修复失效的线路，更不表示设备上的每一种流量都必然采用完全相同的处理方式。

直连(Direct)：建立本地网络对照

直连(Direct)用于观察不经代理服务器时的访问结果。若 Direct 能访问某个常用网页，而 Proxy 不能，说明应重点检查服务器及代理路径；若两者都失败，则先检查设备本身的 Wi-Fi、蜂窝网络或网页服务状态。Direct 下能上网不等于代理服务器已经可用，测试结束后需要主动切回本来要使用的姿态。

完成选择后记住当前模式。后面的每次验证，都应把“使用哪个服务器”和“处于哪个 Global Routing 姿态”一起记录下来，这样才有可比较的结果。只记住开关已打开，往往无法区分服务器问题与分流问题。

Home：选择服务器并打开开关

返回 Home，在服务器列表中选择刚才核对过的条目。点服务器左侧的圆形选择区域，确认选中标记落在目标条目上；不要把进入编辑页面误认为已切换默认服务器。若订阅内有多个名称相似的条目，首次只选定一台进行测试，避免每次操作都换一台，最后无法判断究竟是哪项更改生效。

确认服务器和 Global Routing 后，打开 Home 顶部的连接开关。首次使用时，系统可能弹出添加 VPN 配置的确认窗口，按提示允许，并使用设备要求的验证方式确认。这个授权用于建立系统网络连接，不是订阅导入成功的提示；若取消，返回客户端时开关可能无法保持开启，需要重新发起连接并完成系统确认。

完成授权后回到 Shadowrocket，观察开关和连接状态是否保持。系统状态栏或控制中心中的 VPN 状态可以作为辅助信息，但它只说明系统连接状态，不能单独证明选中的服务器能够完成网页访问。此时先保留当前设置，进入下一步运行 Connectivity Test，不要因为看到 VPN 标识就跳过验证。

如果开关刚打开就回落，先检查系统授权是否已经完成，以及设备上是否有另一项正在工作的 VPN 连接。由学校或单位管理的设备还可能存在网络配置限制，应按设备管理要求处理，不要反复删除管理配置。若需要修改当前服务器参数，建议先关闭连接，保存更改后再重新开启，以免把更改前后的状态混在一起。

iPad 上的可用空间更大，部分页面可能以分栏方式展示。操作仍然按 Home 选服务器、Global Routing 选姿态、顶部开关连接的顺序进行；不要因为左侧仍保留列表就重复添加同一条服务器。确认本次使用的条目后，再继续检查实际通信。

Connectivity Test：验证是否生效

连接开启后，在 Home 找到 Connectivity Test，运行测试并查看当前服务器对应的结果。测试需要等待返回，刚点下去时的空白或进行中状态不应直接当作失败。若结果为超时，先保留服务器和模式不变，再测试一次；持续超时才进入下一步排查，不要依赖一瞬间的状态下结论。

Connectivity Test 的作用是检查测试目标对应的连通性。成功说明这一测试有响应，不代表所有网站、所有协议或持续传输都已经正常；显示的时间也不等同于实际下载速度。首次使用无需在数字之间反复挑选，先完成一条路径的稳定验证，比只看某个测试结果更有意义。

再用浏览器验证真实请求

保持 Shadowrocket 的连接开启，切换到浏览器，打开一个平时使用且能确认服务正常的网页。尽量新建页面并刷新，不要只看已经加载过的内容，因为缓存页面可能在网络已经变化时仍能显示。随后再访问另一个不同的网页，判断问题是只出在单个站点，还是所有新请求都失败。

如果正在使用配置(Config)，还应检查目标请求是否按预期分流。可以结合客户端的请求记录核对目标域名和处理策略；不同规则可能让两个网页走不同路径，所以其中一个访问成功并不能替代对另一个路径的验证。暂时不熟悉记录时，先用代理(Proxy)复测同一网页，再返回 Config 对照，缩小到规则层面。

留下能够复现的最小记录

一次有效的验证应能回答四件事：选中的服务器是哪一台、Global Routing 是哪一项、Connectivity Test 返回什么、实际网页能否加载。可以在本地记下条目备注和结果，但不要记录完整订阅链接、密码或认证内容。若稍后进入排查，继续使用同一个网页作为对照，避免测试目标变化影响判断。

测试正常且网页表现符合预期，就可以结束首次连接流程。之后若要切换到配置(Config)进行日常分流，切换后再做一次同样的验证即可。不要把一次成功测试当作以后无需检查的保证；网络环境、订阅内容和配置发生变化时，仍然按相同顺序复测。

常见失败点：一次检查一项

遇到问题时，从最早没有完成的步骤回查，而不是把全部设置恢复一遍。列表没有内容属于导入问题，开关无法保持属于连接建立问题，测试超时属于可达性问题，测试有响应但网页失败则需要继续区分模式、DNS 和目标服务。下面按这个顺序处理，每次更改后都回到同一测试目标验证。

导入后没有服务器：先检查输入与订阅响应

返回 Add Server 中保存的订阅记录，检查 Type 是否为 Subscribe，URL 是否完整，参数之间的符号是否原样保留。如果误把服务说明页面地址当成订阅地址，保存成功也不会得到有效服务器列表。设备需要先有可用的基础网络来获取订阅；先确认普通网页能打开，再尝试更新订阅内容。

若链接已过期、权限变化或返回内容不符合预期，应向自己的服务商确认已有链接状态。不要为了排查将完整 URL 粘贴到公开页面，也不要反复创建多个相同分组。保存一条已确认的记录并观察它的更新结果，通常更便于定位错误。

Connectivity Test 持续超时：回查服务器参数

手动录入的条目先检查地址、端口和认证字段，再检查协议对应的传输设置。对照原始资料时逐项核对，不要仅看备注名称；备注相同也可能指向不同端口。已有订阅中的条目可以先更新一次，再选择自己列表中的另一台服务器作对照。如果只有某一台持续失败，优先排查该条目的服务状态。

同时留意当前网络环境。由 Wi-Fi 切到蜂窝网络后结果不同，说明网络路径可能参与了问题，但仍需保留相同服务器、相同模式和相同测试目标才能作比较。没有依据时不要同时更换协议、服务器和 DNS，否则成功或失败都很难解释。

测试有响应但网页失败：核对模式与 DNS

先回 Home 查看 Global Routing，排除误停留在直连(Direct)的情况。若代理(Proxy)可用而配置(Config)失败，转到 Config 确认当前文件，再检查目标请求的规则命中与策略；这时不应首先改动服务器密码。如果仅一个网页失败，也应先确认网页自身是否正常，而不是据此判定整个连接不可用。

DNS 排查要放在已有对照结果之后。先保存原配置，查看当前 Config 的 DNS 设置，核对解析路径是否与预期一致。不要从不明来源复制一组地址来替换全部设置，也不要同时修改系统网络与客户端配置。更细的域名解析、规则顺序和网络切换问题见DNS 问题排查。

如果本页步骤仍未恢复连接，可到FAQ按症状继续查找，或阅读疑难手册中的系统化流程。描述问题时只提供必要信息：设备类型、失败发生的步骤、Global Routing 选项和去除敏感内容后的错误文字。保留原有配置副本，能让后续检查和恢复更容易。