Shadowrocket
导入与连接教程

服务器记录用于保存一条连接所需的参数，订阅则用于获取并更新一组服务器记录。先看手上的材料是哪一种：如果是一条完整的订阅 URL，走 Subscribe；如果是协议、地址、端口与认证信息，走 Add Server 手动填写。两种方式不必同时做，也不要把订阅 URL 直接填入 Host。

已有订阅链接：选择 Subscribe

打开 Shadowrocket 的 Home，在 SERVER 区域找到 Add Server 并进入。打开 Type，选择 Subscribe，在对应的 URL 字段粘贴自己的订阅链接，再填写便于辨认的备注并保存。这里的 Subscribe 是导入已有订阅的入口，不是应用购买页面。保存后返回 Home，等待订阅请求完成，再检查是否出现订阅分组及服务器记录；只有一个订阅名称、没有实际服务器时，还需要确认获取结果。

粘贴前检查链接是否完整，尤其是问号后的参数、大小写和末尾字符。聊天文字中的换行、前后空格或标点不应混入 URL。下面仅展示链接形态，不能用于连接；请使用自己已有的地址，不要将含有真实凭据的链接贴到公开页面或求助截图里。

https://example.com/sub?token=xxxx

订阅能否更新与链接有效性、当前网络及订阅地址的响应有关。若更新失败，先保留原记录，核对自己的订阅是否有效，再尝试刷新；反复添加同一个 URL 通常只会增加重复分组，并不能修复请求失败。若订阅同时涉及规则配置，需另行核对 Config；出现服务器列表并不等于当前规则已准备好。

已有单条服务器信息：填写 Add Server

在 Add Server 中先选 Type，再填写该协议对应的字段。以截图所示页面为例，Host 是服务器地址，Port 是端口，Password 与 Method 必须和已有信息一致。切换 Type 后字段可能改变，例如 VMess 或 VLESS 会涉及不同的认证与传输参数，不能把一种协议的字段照搬到另一种协议。遇到不认识的字段，先在名词解释核对含义，再回到这一页继续。

手动填写时逐项检查地址是否带入了多余路径、端口是否完整、认证内容是否误复制了空格。TLS、传输方式与相关主机名也要按已有信息填写，不要为了让表单看起来完整而随意猜值。资料不全时，应向原信息提供方核对缺失字段，单靠更换 Type 不能补齐参数。

若已有对应二维码，可以使用 Scan QR Code 导入，再打开记录复核字段。Import from Cloud JSON 只适用于已有且格式匹配的配置来源，不是普通订阅 URL 的通用替代入口。完成保存后返回 Home，确认 SERVER 中能看到该记录。至此只完成了“保存连接信息”，下一步仍要决定流量按什么方式处理。

回到 Home，在 SERVER 中选择刚保存或订阅导入的服务器，确认当前选中项是准备测试的那一条。订阅里有多条记录时，先固定一条进行验证，不要同时换服务器、改模式和改配置，否则后续很难判断是哪项变化影响了结果。若 Config 使用策略组，还需核对实际策略的选择；Home 中的选中项不一定就是每条规则最终使用的出口。

再次查看 Global Routing 的显示值，确保与上一阶段的选择一致，再打开 Home 顶部连接开关。首次建立连接时，系统可能提示允许 Shadowrocket 添加 VPN 配置。确认提示来自本次主动操作后，按系统提示允许，并使用设备要求的身份验证方式完成授权。这是建立系统网络连接所需的权限，不是导入服务器密码的步骤。

完成授权后回到 Shadowrocket，观察顶部是否从 Not Connected 转为连接状态。若开关马上回落，或仍然显示未连接，先检查系统授权是否完成，再检查当前记录与配置。不要把系统弹窗关闭后继续假设连接已建立，也不要只凭开关曾经亮起就结束验证。

iPhone 与 iPad 的操作顺序相同，界面布局可能随设备变化。系统中的 VPN 状态可作为辅助确认，但它只能说明系统连接状态，不能单独证明远端服务器可达、域名解析正常或规则匹配正确。后续仍须运行 Connectivity Test，并访问实际页面。若设备已有其他正在工作的 VPN 连接，应先确认系统实际启用的是哪一项，避免两个连接操作互相影响。

需要修改服务器参数时，可以先关闭连接再编辑，保存后重新打开并测试。首次上手也建议暂缓调整 On Demand：先完成一次手动连接与断开，确认基本行为，再设置自动触发条件。现在保持选中的服务器与模式不变，进入下一步，用测试和实际访问一起判断是否生效。

先定位失败发生在哪个阶段，再进入 Settings 调整相关选项。订阅没有获取到记录、开关无法保持连接、测试失败和只有个别页面异常，是不同的问题。把这些现象分开，通常比连续修改 Proxy、TCP、UDP 等设置更容易找到原因；不清楚作用的选项先保持原值。

导入失败：先核对 URL 与输入字段

如果 Subscribe 保存后没有服务器记录，先检查 URL 是否复制完整、订阅是否仍有效，以及当前网络能否访问该订阅地址。订阅更新需要先请求地址本身，不能假定列表中的服务器一定能帮助完成这次请求。确认后再尝试更新；已有可用记录时先保留，避免把“更新失败”变成“所有记录被删除”。

如果是手动记录，重新进入 Add Server 对照原始信息逐项检查 Type、Host、Port 与认证内容，再检查 TLS 和传输相关字段。密码、UUID、主机名与路径都不能凭印象补写。二维码导入也需要复核结果；能保存记录，只代表应用接受了表单，不代表远端参数一定正确。

测试失败：区分测试方式与实际连通性

在 Settings 查看 Test Method，确认当前测试方式后重新运行 Connectivity Test。某种测试失败时，仍需结合实际页面访问判断，而不是立刻认定所有连接都不可用。也可以在自己可用的 Wi-Fi 与蜂窝网络之间作对照，保持服务器和模式不变；若结果随网络改变，重点关注网络可达性与相关限制，而不是同时改动全部字段。

如果开关立即关闭，先完成系统授权与当前配置检查。如果开关保持连接但多条测试都失败，核对已有服务器是否有效，再查看 Diagnostics 中的相关信息。Diagnostics 用于辅助定位，不会自动补齐错误参数。记录准确错误内容与发生时间，再按现象继续检查。

Config 异常：检查规则顺序与策略引用

若代理(Proxy)可以访问而配置(Config)不行，回到 Config 检查当前使用的文件、Rule 顺序以及策略组。常见原因包括选中了另一份配置、请求先命中了不合适的规则，或规则引用的策略没有可用服务器。不要直接删除整段 Rule 来尝试恢复；先找出测试目标对应的匹配结果，再修改一项并复测。

若只有特定域名失败，结合连接记录检查其实际目标、解析结果与匹配策略。DNS 和规则问题有时表现相似，单凭页面错误难以区分。可先保留原配置作对照，逐项检查，而不是反复更换订阅。规则关键字与协议字段的深入解释放在名词解释，更细的现象分类可查看FAQ。

连接自动变化：查看 On Demand

手动断开后又出现连接，或切换网络时连接行为改变，可以在 Settings 查看 On Demand 是否启用及其触发条件。它用于按条件建立连接，不能替代服务器本身的可达性。首次排错时，先记录原条件，再暂时停用相关自动触发设置，使用手动开关重复验证；基本连接稳定后再恢复需要的条件。

需要分享排查材料时，遮挡订阅 URL 中的凭据、服务器认证信息和能识别个人的记录，只保留问题所需的界面词、错误内容与操作顺序。可按“导入方式 → 当前 Global Routing → 系统连接状态 → Test Method 与结果 → 实际访问现象”的顺序整理，避免在公开材料中展示完整连接信息。

完成这五步后，保留能正常工作的设置，再按需要学习其他功能。购买、商店地区与已购恢复属于另一条操作路径，可在正版指南系统查阅；本页的终点是确认自己的连接信息、模式与实际访问结果能够对应起来。