Shadowrocket 订阅导入
与首次连接

已有订阅链接：使用 Subscribe

先检查从你的服务商处获取的链接是否完整。复制时应保留地址中的路径、问号及后续参数，不要把网页标题、说明文字或聊天消息的标点一起复制。订阅地址可能带有个人访问凭据，应只保存在自己的设备中；排错时不要把完整地址公开到截图或求助信息里。

打开 Shadowrocket 的 Config，找到 Subscribe，进入后新增订阅并填写完整 URL，再保存并执行更新。完成后回到 Home，检查 SERVER 分组是否出现导入的服务器。导入成功的判断依据是实际出现可选择的条目，而不是只看到一条已保存的订阅名称。若服务商提供的是配置文件地址而非服务器订阅，应按对应配置入口导入，不能仅凭地址以相同后缀结尾就判断类型。

订阅更新的作用是重新读取服务商返回的内容，不代表客户端会自动获得新的服务权限。首次更新失败时，先确认当前网络能访问该地址，再检查链接是否失效或遗漏参数。重复点击更新无法修复错误地址，也不要用修改协议名称的方式尝试转换不兼容内容。

已有单个服务器：使用 Add Server

在 Home 的 SERVER 分组找到 Add Server，或使用页面上的新增入口打开 Add Server。先点 Type，选择与你的服务器资料一致的协议类型，再填写页面要求的字段。Type 决定后续需要哪些参数；不能因为某种协议的字段更少，就用它代替服务商给出的协议。

以官方截图中的字段为例，Host 是服务器地址，Port 是服务端口，Password 是认证信息，Method 是对应的加密方法。不同 Type 还可能要求其他认证、传输或 TLS 参数，应逐项对照服务商资料。不要把订阅 URL 填进 Host，也不要把网页访问端口当作服务端口。输入完成后使用页面的保存或完成操作，回到 Home 确认条目已经出现。

如果资料是二维码，可使用 Scan QR Code；如果资料明确为云端 JSON，可按其说明使用 Import from Cloud JSON。二维码导入并不改变内容格式，扫到普通网页地址时不会自然变成服务器配置。通过剪贴板导入前，也要先确认复制的是完整连接内容，而不是一段介绍文字。

这一步结束时，应能在 Home 看到至少一个自己认识的服务器条目。暂时不需要批量测试或反复导入同一份资料；先保留一个条目用于接下来的模式和连接验证。协议字段的进一步解释见协议参考，订阅与配置文件的区别见名词解释。

回到 Home，点 Global Routing 查看当前选项。首次使用时先记录当前选择，再按自己的配置目的调整。这里的三种姿态分别是配置(Config)、代理(Proxy)、直连(Direct)，并不是速度档位，也不表示服务器的好坏。

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

选择配置(Config)后，请求按照当前启用的配置文件处理。规则可以把不同目标交给 PROXY、DIRECT 或 REJECT，具体行为取决于文件内容。因此，“选择了 Config”并不等于“所有请求都使用服务器”；如果某个目标命中了 DIRECT，它仍会直接连接。

进入 Config，确认需要的配置文件已被选中。打开编辑页可看到 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等分段，Rule 中可检查具体规则，Add Rule 用于新增规则。导入服务器与启用规则文件是两个步骤：Home 中出现服务器条目，不代表某一份规则文件已经自动启用。初次上手不需要同时修改这些分段，先使用自己已确认来源和用途的配置。

代理(Proxy)：临时检查所选服务器

代理(Proxy)适合在排错时暂时减少分流规则带来的变量，检查所选服务器是否能够承载访问。它不是永久的推荐模式，也不保证所有系统流量都会经过同一路径。测试前确认 Home 当前选中的是要验证的条目；结束后，如日常需要按规则分流，应切回配置(Config)并再次检查结果。

直连(Direct)：直接连接目标

直连(Direct)不使用所选代理服务器作为普通请求的出站路径，适合与代理访问结果进行对照。若连接开关已经打开但某个目标仍显示本地网络出口，应先检查是否选择了 Direct，或是否在 Config 下命中 DIRECT，而不是立即认定服务器资料错误。

本次上手只需确定一种与目标一致的姿态，暂不添加复杂规则。选择后返回 Home，记住 Global Routing 行显示的值，下一步连接时将用它核对是否选对模式。若不理解规则顺序或 FINAL 的作用，可先阅读规则关键字解释，不要在未保存原文件时连续改动多个规则。

在 Home 的 SERVER 分组中点选本次要使用的服务器，核对名称与选中标记。一个订阅可能包含多个名称相近的条目，选中某个分组标题并不一定等于选中具体服务器。若列表为空，先返回第一步完成导入，不要用反复切换顶部开关代替添加资料。

确认 Global Routing 显示预期姿态后，打开 Home 顶部 Not Connected 旁的开关。首次操作时，系统会询问是否允许添加 VPN 配置。核对这是由 Shadowrocket 发起的操作，再允许并根据设备提示完成密码或生物识别验证。该授权用于在设备上建立连接配置，并不等同于订阅认证，也不会补全尚未填写的服务器参数。

完成系统提示后返回 Home，等待连接状态变化，观察开关是否保持开启。如果刚授权后仍未连接，可在确认配置已经添加的前提下重新打开一次。若设备受管理策略限制，或系统不允许添加 VPN 配置，应先处理设备权限问题；这类问题无法通过更换服务器密码解决。

连接时避免同时启用其他会接管系统网络连接的功能，以免状态被另一个连接覆盖。首次验证阶段也先不要启用 On Demand，让连接由手动开关控制，便于分清到底是哪一次操作建立了连接。需要停止时，回到 Home 关闭开关，并确认状态已回到未连接。

顶部状态改变只说明连接配置已运行，不足以证明远端服务器认证成功，更不能证明每条规则都符合预期。保持当前服务器和 Global Routing 不变，接着用下一步检查实际请求；这样发现问题时，可以沿着同一组设置复现，而不是在多个变量之间猜测。

导入后没有条目：先检查返回内容

若订阅名称已经保存但 SERVER 仍为空，检查更新是否实际完成，以及服务商返回的是否为客户端可识别的订阅内容。地址过期、参数遗漏、账号状态变化或返回登录网页，都可能造成导入失败。先从你的服务商处确认链接有效性，再重新执行更新；不要在还没有服务器条目时调整 Global Routing。

开关无法保持：检查授权与参数

若开关立即回落，先确认系统添加 VPN 配置的授权是否完成，再检查所选服务器的 Type、Host、Port 和认证信息。带 TLS 或特定传输要求的服务器，还应核对对应字段，不能只检查密码。若刚才更换了服务器条目，停止连接后重新开启，再观察同一个操作能否稳定复现问题。

测试有结果但页面打不开：区分规则与 DNS

先用同一个目标对照配置(Config)与代理(Proxy)的结果。只有 Config 异常时，优先检查当前配置文件、规则顺序和策略目标；两种方式都异常时，再检查服务器与目标本身的可达性。如果表现为域名解析失败，而其他连接仍能建立，再查看配置中的 DNS 相关设置。不要因为一个域名打不开就直接替换全部 DNS 参数。

进入 Settings，可查看 Test Method 和 Diagnostics。Test Method 用于理解 Connectivity Test 的测试方式；Diagnostics 可辅助收集故障线索。记录时保留错误类型和发生环节即可，分享前隐藏订阅地址中的凭据、服务器认证字段和其他个人资料。有关协议字段之间的区别，可继续查阅协议参考；常见导入和设置问题集中在常见问题。

连接自动恢复或反复变化：再看 On Demand

如果手动关闭连接后又自动开启，或切换网络时行为与预期不同，查看 Settings 中的 On Demand。按需连接会影响连接触发方式，适合在手动连接已经验证成功后配置。排错时可以先停用相关自动触发条件，确认手动连接稳定，再逐项恢复，避免把自动重连误认为开关失效。

Settings 中还可见 Proxy、TCP、UDP 等项目，这些项目并非首次连接必须逐一修改的清单。只有已经明确错误发生在哪一层，才根据对应说明调整。保留一份已成功工作的配置，比一次启用所有设置更便于定位问题。完成修改后，回到 Home 重新连接，并重复第四步验证，不要只看设置已保存就结束检查。