官方手册 · 入门操作 已有配置的导入与使用

Shadowrocket
导入与连接教程

按导入、路由、连接、验证的顺序完成首次设置。先确认一个服务器可以访问，再检查规则是否符合预期。

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

本教程用于 iPhone 与 iPad。打开 Shadowrocket 后，先进入 Home，查看是否已有服务器条目。如果列表为空，先不要打开连接开关；需要先把已有的服务器信息保存进应用。订阅链接、单个服务器分享链接与 Config 配置文件用途不同，导入前先确认手中资料属于哪一类。

订阅链接通常由服务商提供，用于取得并更新一组服务器；单个服务器信息描述一台服务器的连接参数；Config 则主要组织规则及相关设置。把订阅链接填到服务器地址字段，或者把 Config 文件地址当成 Subscribe 使用，都可能导致导入失败。不能仅凭链接外观判断时，应查阅原始配置说明，而不是反复尝试不同入口。

已有订阅链接：选择 Subscribe

  1. 在 Home 点右上角加号，进入 Add Server，点 Type 并选择 Subscribe。
  2. 把用户已有的完整订阅链接粘贴到 URL 字段。需要备注时填写便于辨认的名称，不要把链接放进备注字段。
  3. 点页面上的完成按钮保存，返回 Home，等待订阅读取结束，再检查分组内是否出现服务器条目。
  4. 展开对应分组，点选其中一个服务器，确认它成为当前选择。订阅分组存在，不等于已经选中了可用于连接的具体条目。

粘贴后检查开头、结尾以及查询参数是否完整，尤其不要带入聊天文字、换行或末尾标点。订阅链接可能包含访问凭据，应只在需要的输入框内使用，不放进公开截图、网页或问题描述。若保存后显示读取失败，先保留原始链接，再按文末的订阅排查顺序处理；连续新建同一个订阅只会增加辨认成本。

订阅内容发生变化后，可在 Home 的对应订阅分组操作中执行更新，并留意更新提示。更新完成要重新检查当前选择，因为原先的条目可能已被替换或移除。更新订阅负责刷新服务器列表，并不自动证明新条目能够连通，也不能替代 Config 中的规则设置。

已有服务器信息：按 Type 填写参数

只有单台服务器参数时，同样从 Home 的加号进入 Add Server，先在 Type 选择与原始资料一致的协议类型，再填写地址、端口与认证字段。例如 VLESS、Trojan、WireGuard 的字段并不相同；不能因为地址与端口相同，就把一种协议的信息填进另一种类型。填写完成后保存，返回 Home 点选该服务器。

逐项对照原始资料中的字段值，留意字母大小写、空格和端口数字。若资料包含 TLS、SNI、传输方式或路径，也要按对应字段填写；不要为使表单更简短而删去这些参数。TLS 验证失败时，应检查名称与证书是否匹配，而不是通过降低验证要求绕过错误。字段含义不明确，可先查概念速查，再回到表单继续。

如果用户已有服务器二维码，可使用 Scan QR Code 扫描，并按系统提示授权相机。识别后仍要核对 Type、地址和端口，确认内容与原始资料一致。二维码只是承载配置的方式，不代表其中的信息已经过连接验证。完成以上任一导入路径后，下一步是决定流量如何使用这些服务器。

02 · Global Routing：选择流量处理姿态

回到 Home，点 Global Routing，查看当前选择。这里决定流量按什么方式处理，不负责提供服务器。三姿态分别为配置(Config)/代理(Proxy)/直连(Direct)。初次设置时先明确测试目的：是验证服务器本身，还是验证一份已有规则；目的不同，选择也不同。

配置(Config)：按当前配置规则处理

Config 适合按照规则决定哪些请求使用代理、哪些请求直连的日常使用方式。选择前先进入应用的 Config 页面，确认需要使用的配置文件已被选中。列表里保存了一份文件，并不表示它就是当前正在使用的配置；应检查选中标记，并确认文件内容来自用户已知的配置资料。

规则通常依照书写顺序匹配，匹配后的策略决定如何处理该请求。下面这段片段用于解释“指定域名走代理，其余直连”的含义，不是本教程要求新建的完整配置，也不会提供服务器：

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

DOMAIN-SUFFIX 匹配域名后缀，PROXY 与 DIRECT 表示处理策略，FINAL 用于兜底。示例域名 example.com 仅用于说明语法。已有 Config 能正常使用时，不要为了首次连接而整份覆盖；规则及配置的深入说明可在概念速查中继续阅读。

代理(Proxy)：检查当前服务器的访问能力

Proxy 适合暂时排除规则匹配因素，检查由代理处理的访问是否可用。先选择一个服务器，再切到 Proxy，使用同一个网页进行测试。若 Proxy 可以访问、Config 不可以，下一步应检查当前配置与规则策略，而不是立刻重新导入全部服务器。Proxy 不能修复错误的认证参数，也不能使不可达的服务器恢复响应。

直连(Direct)：检查当前网络的直连访问

Direct 用于通过当前网络直接访问，便于建立对照。它不是自动挑选服务器的模式，也不会因为 Home 已选中某个条目就将直连请求改走该服务器。使用 Direct 观察的目标应是当前网络原本就能访问的网页；这有助于分辨基础网络故障与代理连接故障。

完成测试后，应恢复符合日常需求的模式。需要分流时回到 Config，并确认活动配置；不要只记得连接开关已打开，却忘记 Global Routing 仍停留在临时测试姿态。模式确认后，再进入系统授权与连接步骤。

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

返回 Home，再核对两项内容：当前服务器是否正确、Global Routing 是否符合本次测试目的。首次操作建议保持当前网络稳定，不要一边切换无线网络与蜂窝数据，一边修改服务器参数，否则出现失败时难以判断是哪项变化造成。

  1. 打开 Home 顶部的连接开关。
  2. 首次建立连接时，系统可能提示添加 VPN 配置。阅读提示，确认发起应用为 Shadowrocket，再选择允许。
  3. 按系统要求完成设备密码或身份验证，等待返回应用。
  4. 检查连接开关是否保持开启，以及系统 VPN 状态是否已经建立。

这项授权用于让系统把相应网络流量交给客户端处理，不是导入订阅的确认框，也不是新的应用购买步骤。只保存服务器条目通常不会完成 VPN 配置授权；第一次真正打开连接时，才需要关注该系统流程。若主动取消提示，连接可能无法继续，应返回 Home 再次尝试并完成授权。

若开关刚打开就回到关闭状态，先确认授权流程是否完成，再到系统 Settings 的 VPN 配置区域查看相关状态。菜单位置会随系统界面变化，应以设备实际显示为准。正在使用其他 VPN 连接时，先停用后再测试；受管理设备的限制也可能影响 VPN 配置，需按设备管理要求处理，不要反复删除全部网络设置。

VPN 状态建立，只说明系统隧道已建立，不代表服务器认证、DNS 解析与目标网站访问都已成功。出现系统连接标识后，仍要继续下一步的访问验证。若此前设置了 On Demand，排查期间应先了解其触发条件，必要时暂时关闭，以免手动断开后又自动建立连接，干扰对照结果。

04 · Connectivity Test：验证连接与规则

先回到 Home 使用 Connectivity Test，观察当前服务器的测试结果。测试有响应，可以作为服务器在该测试方式下可达的线索；没有响应，则需要进一步检查网络与参数。测试结果受测试方式及目标影响，不能仅凭一个数字判断所有网页是否都能访问，也不宜把响应速度当作实际下载速度。

接着打开浏览器，先访问一个当前网络已知可用的网页，确认设备本身可以联网；再访问本次需要验证的目标网站。尽量使用新的页面请求并重新加载，避免把浏览器已经缓存的页面误认为新连接成功。若只有一个网站异常，先确认该网站本身是否可用，不要马上把问题归结为整个客户端。

  1. 验证基础网络：关闭客户端连接后，检查已知可用的网页能否正常打开。
  2. 验证服务器：恢复连接，使用 Proxy 对同一目标发起请求，检查当前服务器是否能完成访问。
  3. 验证规则：切回 Config，再访问同一目标，比较结果是否变化。
  4. 核对处理记录：在 Data 中查看当前界面提供的连接记录；若能看到目标与策略，确认其是否符合预期。

观察记录时，要让测试动作与记录时间对应。页面可能同时请求多个域名，一个主域名命中规则，不代表图片、接口或登录请求也采用相同策略。若页面能打开但部分内容缺失，应先辨认失败请求所使用的域名与策略，而不是仅扩大主域名规则。Data 中的流量变化只能说明有数据经过，不能单独证明某个网站命中了所需规则。

每次只调整一个变量：先固定网络、服务器和目标网站，再更换 Global Routing。这样才能把“服务器不可用”与“规则没有命中”区分开。完成验证后，恢复日常需要的模式，并记下可用服务器、活动 Config 与本次测试结论；以后出现变化时就有可比较的起点。

05 · 常见失败点：沿操作顺序排查

失败时先指出停在哪一步：是订阅读取不到条目、开关无法保持、Connectivity Test 没有响应，还是仅有网页访问异常。不同现象对应不同环节。建议先保留现有配置与原始资料，再按以下顺序检查，避免在尚未定位原因时同时清空列表、替换 Config 和修改 DNS。

Subscribe 保存了，但没有服务器

先确认 URL 是用于服务器订阅的完整链接，而不是服务商说明页面或账户页面。检查是否复制了多余空格、标点，是否遗漏查询参数，再查看更新时的错误提示。当前网络无法访问订阅地址、服务端返回错误、访问凭据失效或返回内容不符合预期，都可能导致列表为空。

“订阅更新成功”与“服务器可以连接”是两个检查点。若链接读取失败，应向原服务商确认链接状态与返回格式；若条目已出现，则转到服务器测试。提供问题描述时保留错误类型即可，订阅链接中的凭据不要公开。更完整的订阅错误分类见FAQ。

服务器已出现，但 Connectivity Test 失败

先关闭连接确认当前网络可用，再检查服务器地址、端口、Type 和认证信息。手动输入的条目尤其要核对 TLS、SNI 及传输参数；订阅导入的条目则先更新一次，确认当前选择仍在列表中。若有另一个用户已有且已知可用的服务器，可以保持同一网络与同一测试方式进行对照。

不同网络对服务器的可达性可能不同。如果无线网络下失败而蜂窝数据下成功，应分别记录结果；切换网络后先重新连接再测试。不要把一次超时直接解释为全部配置失效，也不要在没有证据时随意更改加密或认证字段。

开关已开启，但网页无法访问

首先查看 Global Routing。Direct 下的请求不会因为选中了服务器就自动改走代理；Config 下则需要检查活动配置及目标命中的策略。临时使用 Proxy 测试同一目标：若 Proxy 可用而 Config 不可用，优先检查规则顺序、策略指向及兜底处理；若两者都失败，再检查服务器与 DNS。

域名解析异常也可能表现为网页打不开。先保留现有 DNS 设置并记录错误，确认服务器信息正确后再做单项调整。不要为了排查一个域名而同时改动多个 DNS 选项。对配置文件、商店获取与使用边界仍有疑问，可分别查阅概念速查与App Store 指南，本页只保留首次连接所需的操作链路。

只有部分网页或应用异常

这通常需要把测试缩小到具体请求。先用浏览器访问相同目标，再比较 Proxy 与 Config；查看 Data 中可用的目标及策略信息，确认异常内容是否涉及其他域名。网页中的登录、图片和视频可能使用不同地址，因此“主页可以打开”与“全部功能正常”不能画等号。

最后恢复测试期间改动的 Global Routing、On Demand 和 Config 选择。若仍需进一步求助，整理设备所处网络、失败步骤、所选姿态、错误提示以及对照测试结果，并隐去订阅凭据、密码与个人信息。可复现的操作顺序比一张连接开关截图更有助于定位问题。