Shadowrocket 首次配置与连接

打开 Shadowrocket，进入 Home，找到 SERVER 分组和 Add Server 入口。若当前尚未添加条目，列表为空并不表示安装出错，只说明还没有保存连接信息。接下来根据已有资料选择一种方式：有协议、地址、端口等独立字段时手动添加；有完整订阅链接时通过 Subscribe 导入。首次操作只完成一种方式即可，不必重复录入。

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

点按 Add Server 后，先选择 Type，再填写该类型要求的字段。截图展示的是包含 Host、Port、Password、Method 的表单，其中 Host 填服务器域名或 IP，Port 填对应端口，Password 与 Method 按原始资料核对。切换 Type 后，字段可能改变；不要把某一种协议的字段套到另一种协议，也不要凭名称猜选项。

逐项复制时，检查首尾空格、换行和标点，尤其注意端口必须与服务器资料一致。地址字段通常只需要主机名，不应把完整网页路径一并填入。不同协议可能还要求 UUID、SNI 或传输相关参数，这些信息应来自你已有的服务器资料；缺少字段时先向原信息提供方确认，再继续。更详细的字段含义见协议技术参考。

已有订阅链接：通过 Subscribe 导入

在 Add Server 中选择 Subscribe 类型，填写便于自己识别的名称，并将完整订阅地址放入对应的 URL 字段。复制时保留原地址的查询部分，不要只截取域名，也不要把订阅地址当作 Host。完成保存后等待订阅内容获取，返回 Home 检查是否出现对应分组或服务器条目。保存订阅记录与成功取得条目是两件事，应以列表实际内容为准。

如果已有资料是二维码，可使用 Scan QR Code，并在需要时允许相机访问；扫码后仍要检查识别出的类型与字段再保存。Import from Cloud JSON 是另一种导入入口，不等同于 Subscribe，普通订阅链接不应填到该入口。只使用与现有资料格式对应的方式，避免“能够粘贴”就误以为“格式正确”。

订阅地址可能包含访问凭据，应像密码一样保存。排错时不要把完整地址贴入公开页面或截图。导入结束后，先选中一个明确要使用的服务器，再进入下一步选择 Global Routing；此时暂不修改高级选项，也不需要批量测试全部条目。

返回 Home，点按 Global Routing，确认当前采用的姿态。教程中的三种写法为配置(Config)、代理(Proxy)、直连(Direct)，对应界面中的 Config、Proxy、Direct。不要仅凭顶部开关是否开启判断请求一定经过所选服务器：模式与规则仍会影响实际处理路径。

日常需要按规则处理时，选择 Config，然后进入 Config 页面检查当前使用的配置文件。导入订阅主要解决服务器列表问题，并不等于已经替你选择或完成一套规则。若手中另有配置文件，应先确认来源与用途，再按应用入口导入并选择；没有现成文件时，先查看当前已有配置，不要随意覆盖原内容。

在 Config 中确认 Rule

官方截图展示的是配置文件编辑页，可看到 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等分段，以及 Add Rule。首次配置重点查看 Rule，确认规则是否符合自己的使用目标。General 等其他分段各有用途，不必为了完成首次连接逐项修改，更不需要同时开启所有高级功能。

规则自上而下匹配，第一条命中后停止。PROXY 表示交给相应代理策略处理，DIRECT 表示直接连接，REJECT 表示拒绝；FINAL 是前面规则均未命中时的兜底项。精确例外通常放在范围更广的规则之前。若只想完成初次验证，保持现有配置并记录原设置即可，暂不添加大量自定义规则。

需要区分服务器问题与规则问题时，可以临时选择 Proxy 作对照，然后访问同一个目标；测试结束后恢复原来计划使用的姿态。不要把这种对照方法当成长期配置建议，也不要在同一次对照中更换服务器、规则与网络，否则结果无法指向单一原因。规则排列的详细说明可继续阅读规则顺序与 FINAL 兜底。

完成前两步后返回 Home，在 SERVER 分组中点选本次准备使用的服务器，检查所选标识是否对应预期条目。订阅下有多个条目时，不要把分组名称当成正在使用的服务器名称；应确认实际选中的具体项。如果看不到任何可选条目，返回第一步检查导入结果，而不是反复打开连接开关。

随后再次查看 Global Routing。确认服务器和姿态后，打开 Home 顶部开关。官方截图中的 Not Connected 表示截图拍摄时尚未连接，并不是要求输入的内容。启动过程中应留意状态变化；如果开关立即回落或出现错误，先记下提示，不要连续快速切换开关，这样更容易辨认失败发生在哪个阶段。

首次连接时阅读系统授权

首次启动可能出现添加 VPN 配置的系统提示。这是系统允许应用建立相应网络连接所需的授权步骤，与已有服务器的账号验证不同。核对发起应用为 Shadowrocket 后，按系统提示确认；如系统要求设备身份验证，依照设备自己的验证流程完成。未确认授权时，应用通常无法完成连接建立。

若刚才取消了授权，可回到 Home 再次尝试打开连接，并检查系统提示。设备受管理策略限制时，应遵循设备管理要求处理，不要通过改动无关设置来绕过限制。与此同时，留意设备上是否有其他正在建立的 VPN 连接，以免把连接切换造成的变化误判为服务器故障。

授权完成后返回 Home，等待连接状态稳定，再进入验证步骤。系统显示连接已建立，只能说明本地连接流程走到了相应阶段，不保证远端认证、目标访问和规则行为均正确。此时先保持应用设置不变，用下一步的测试把这些环节分开确认。

订阅没有条目：先检查输入与获取条件

如果 Subscribe 已保存但 Home 没有出现预期条目，首先核对 URL 是否完整，是否夹入空格、换行或说明文字，再确认当前网络能否取得该订阅内容。订阅地址能在浏览器中打开，并不必然代表返回内容适合当前导入方式；若返回的是登录页面或错误说明，也无法按服务器列表解析。地址状态、有效期与内容问题，应向你已有服务的信息提供方核实。

服务器已添加但连不上：再检查参数与授权

手动添加时，回到条目编辑页逐项对照 Type、Host、Port 和认证字段。尤其留意协议类型选错、端口写错、密码复制不完整，以及 TLS 相关名称与原资料不一致。不要为“先连上”而随意关闭证书校验；证书提示应先从时间、服务器名称和配置一致性排查。若开关无法保持，再检查是否完成系统 VPN 配置授权。

测试与访问结果不同：确认 Test Method

进入 Settings 查看 Test Method，了解 Connectivity Test 当前依据什么方式判断结果。测试目标、端口可达与真实网页访问并非同一层面的验证，不应把测试结果当成速度承诺。官方截图中的 Settings 还包括 Diagnostics、Proxy、TCP、UDP 等入口；它们用于不同设置或诊断，本次排错只进入与现象相关的项目，不要逐项尝试陌生开关。

只有部分目标异常：检查规则与 DNS

若在 Proxy 下正常、Config 下异常，先检查 Rule 的匹配顺序、目标是否命中 REJECT，以及是否被较宽的 DIRECT 规则提前接住。若提示域名无法解析，则另外核对 DNS 配置；更换服务器不一定能修复解析问题。详细的规则与协议概念留到技术参考阅读，当前先恢复到能重现问题、又便于对照的最小设置。

设置持续变化：留意 On Demand

Settings 中的 On Demand 与连接触发条件有关，不等于 Global Routing 的规则策略。若连接在网络切换后出现预期之外的启动或状态变化，应查看是否启用了相关条件，并记下原设置后再作对照。首次上手尚未确认手动连接正常时，先不要叠加新的自动触发条件，避免无法判断变化来自服务器、规则还是触发设置。

需要使用 Diagnostics 时，保留出错当时的提示、时间顺序和复现步骤。分享诊断信息前，移除订阅地址、密码、认证字段及个人访问记录；保留错误类型与必要上下文即可。不要先清空所有配置，清空后往往也丢失了有用的对照依据。

如果以上检查仍未定位问题，请前往疑难解答，按“导入失败、连接失败、部分访问失败”的实际阶段继续查找。结束本次排错前，恢复临时修改的 Global Routing 或测试设置，并再次访问目标确认结果。后续每次调整都沿用“记录原值 → 修改一项 → 重复验证”的顺序。