Shadowrocket
导入与连接教程

打开 Shadowrocket，先停留在 Home，暂时不要打开顶部连接开关。确认手里的资料属于哪一种：一个用于更新服务器列表的订阅链接，或一组包含协议、地址、端口与认证信息的单个服务器参数。两种资料的填写入口有关联，但用途不同；订阅地址不能直接当作服务器的 Host，单个服务器地址也不等于订阅链接。

已有订阅链接：选择 Subscribe

在 Home 点击 Add Server，也可通过页面上的添加入口进入。点击 Type，选择 Subscribe，然后在 URL 字段中粘贴你已有的完整订阅链接。链接中问号之后的参数也可能用于识别订阅，复制时不要只保留域名，不要在首尾加入空格或换行。若有名称或备注字段，可填写便于自己识别的名称，再使用页面的保存按钮返回。

保存后等待订阅读取完成，回到 Home 查看对应分组及其中的服务器条目。只有订阅名称出现、组内却没有服务器时，不能直接进入连接步骤；这通常表示还没有成功取得可识别的列表。先检查粘贴内容是否完整，再使用该订阅条目提供的更新操作重试。订阅链接含有个人识别信息，不应贴到公开页面或发在截图中；更新仍失败时，按文末的导入排查顺序检查。

已有单个服务器信息：逐项填写

仍从 Add Server 进入，先选 Type，使表单与资料中的协议一致。随后按资料填写 Host、Port 以及所需的认证字段。官方截图展示的表单含有 Password 和 Method；切换协议后，字段会不同，因此不要把这张图当成所有协议都适用的固定表单。Method、传输方式、TLS 与其他选项应以你已有的资料为依据，不要凭名称相似自行替换。

Host 填服务器域名或地址，Port 填资料给出的端口。若资料把地址与端口分开列出，就按字段分别填写，不要把完整网页地址粘进 Host。填写完后保存，返回 Home 的 SERVER 分组核对条目。若资料为二维码，可在 Add Server 使用 Scan QR Code；只有手中资料明确是适用的 Cloud JSON 时，才使用 Import from Cloud JSON。扫码后仍需检查识别出的 Type 与地址。

本步完成的标志是：Home 已能看到你导入的服务器，且可以打开其详情核对字段。此时只是资料已经保存，尚不代表该服务器能够连通。下一步先决定这些资料将如何参与连接，再选择具体服务器。

返回 Home，点击 Global Routing。这里决定流量按什么原则处理，不负责生成服务器，也不会修复错误的服务器参数。三种姿态分别是配置(Config)、代理(Proxy)、直连(Direct)。先明确当前要做规则使用还是连接对照，再作选择；不要因为某个名称看起来更完整就反复切换。

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

选择 Config 时，连接会依据当前配置中的规则与策略进行处理。切换到应用的 Config 页面，确认实际选中的是你准备使用的配置文件，再打开其内容查看。截图中的 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 是配置编辑的不同部分；初次连接只需核对当前配置与 Rule，不必逐项修改所有分段。

订阅主要用于维护服务器列表，配置文件主要用于描述处理方式，两者不是同一种资料。导入订阅后，不要直接假定所有访问都会按预期分流；应检查选中的配置是否包含所需规则，以及规则所引用的策略是否可用。已有可用配置时先保留原样，需要编辑前先保存副本。初次连通测试不需要为了“完整设置”而开启 HTTPS Decryption 或添加不明用途的规则。

代理(Proxy)与直连(Direct)：明确路径

选择 Proxy 时，相关连接按代理姿态处理，可用于检查选中的服务器是否能承担目标访问；这仍取决于服务器本身与目标的可达性。选择 Direct 时，相关连接走直连路径，不会用它来验证服务器是否有效。若目标是确认刚导入的服务器，停在 Direct 后看到网页打开，不能据此认定服务器已经正常工作。

配置中的规则通常按顺序匹配，具体条件应放在兜底规则之前。例如下面的示例表示匹配指定域名后缀，其余交给 FINAL；其中 example.com 只是示例域名，不是可用服务器。这里用于理解规则含义，不要求首次连接时复制覆盖现有配置。

DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

本步结束时，回 Home 再看一次 Global Routing 显示的姿态。想使用已有规则就确认 Config 与对应配置；需要单独测试服务器时可在记录原姿态后临时使用 Proxy，测试结束再恢复。规则顺序和策略组的深入说明请查阅功能与设置，本教程继续完成首次连接。

在 Home 的 SERVER 或订阅分组中，点选本次准备使用的服务器。核对条目左侧是否出现圆点标记，确认默认选择落在正确条目上。打开服务器详情检查资料与选中服务器是两件事；从详情返回后仍要看一眼选择标记。列表中存在多个条目时，先固定一个作为测试对象，不要一边切换服务器一边改规则，否则无法判断结果由哪项变化造成。

默认服务器的选择主要服务于需要使用该默认项的连接。若 Config 内的策略组有独立选择，具体访问仍可能按对应组执行；因此看到某条目被选中，不等于所有规则都必然使用它。首次操作先沿用已知配置，记住本次选中了哪个条目即可，复杂策略组的行为留到基础连接验证之后再检查。

确认 Global Routing 后，打开 Home 顶部开关。首次连接时，系统可能显示允许添加 VPN 配置的提示。核对提示中的应用为 Shadowrocket，再按系统要求确认，并完成设备要求的身份验证。此授权是为了在设备上建立相应的网络连接配置，不是导入订阅，也不是再次购买；如果取消，应用可能无法建立连接。

授权完成后回到 Home，观察顶部是否从 Not Connected 转为已连接状态，并确认开关没有立即退回。系统显示 VPN 状态只说明设备已建立相应连接，并不能单独证明远端服务器、DNS 和每条规则都正常。若开关立即关闭，先保留当前条目与姿态，记下系统提示，转到最后一步按连接失败处理，不要连续重复授权。

需要停止时可关闭同一个连接开关。初次测试期间，建议先理解手动开关的结果，再配置 On Demand 自动连接条件；如果发现手动关闭后又自动连接，要把 On Demand 与系统中的相关连接设置一起核对。现在保持一次稳定的连接，进入下一步做实际验证。

排错前先关闭连接，确认设备原有的 Wi-Fi 或蜂窝网络可以正常访问日常使用的目标。需要登录确认的网络，应先完成其网络接入流程。原有网络本身不可用时，继续改服务器密码或规则通常不能解决问题。恢复基础网络后，再重新打开连接，并在以下环节中选择与你现象相符的一项。

导入后没有服务器条目

先核对 Type 是否为 Subscribe、URL 是否完整，再确认该地址确实是用户已有的订阅链接，而不是账号管理页面或普通网页。返回内容若是登录提示、错误页面或空内容，客户端就无法按服务器列表处理。不要通过连续新增同一订阅制造多个重复分组；先检查现有条目的更新结果。涉及链接有效期或访问权限时，应向提供该资料的服务商核实，本教程不提供替代资料。

条目存在，但测试或连接失败

打开该服务器详情，按原始资料逐项核对 Type、Host、Port、Password 及该协议所需的其他参数。密码首尾空格、端口抄错、Method 不一致都可能使认证或连接失败。需要 TLS 或特定传输字段的资料，应保持这些字段一致，不要为了测试随意关闭认证相关设置。已有订阅提供的条目可先更新，再重新选择；确认该条目仍存在后再测试。

进入 Settings 查看 Test Method 时，先理解当前测试方式测量的对象。不同方式的结果不能直接混在一起比较，一种测试失败也不必然等于实际访问完全不可用。使用 Diagnostics 时围绕同一次失败收集信息，保留错误类型与发生环节即可。对外提供记录前，遮盖订阅链接、密码、认证信息及个人连接记录中的敏感内容。

开关已开，只有部分目标失败

先看 Global Routing。若处于 Direct，实际请求不会因为列表中有服务器就自动改走代理；若处于 Config，检查目标是否命中了与你预期不同的规则。确认是否选错配置文件、较早的规则是否已经匹配、策略组是否使用了另一服务器。只有部分域名异常时，再检查 DNS 与 Hosts 的相关配置，不要一开始就同时修改 DNS、TCP、UDP 和 Proxy 端口。

Settings 中的 On Demand 用于自动连接条件；Today Widget 与显示和快捷操作有关，不能替代服务器参数；Proxy、TCP、UDP 则涉及不同的连接设置。首次连接不要求把这些项目全部调整一遍。确有证据指向某项时再修改，并记录原值，以便恢复；详细含义与适用范围请阅读Settings 设置项参考。

每次只修改一个变量，然后对同一目标重复验证。如果修改无效，先恢复原值再继续。这样可以区分问题来自基础网络、导入资料、服务器连接还是规则选择，也能避免一次排查引入多个新问题。更多订阅更新、系统授权与连接现象的说明见问答页；基础连接已通过的用户，可继续阅读规则语法与匹配顺序。