Shadowrocket
添加配置与首次连接

打开 Shadowrocket 后进入 Home。先判断手里的资料是哪一种：一组服务器参数、一个单服务器分享链接、一张二维码，还是一个订阅链接。这几类资料的导入方式不同。订阅链接用于获取和更新一组条目，服务器参数用于建立一个条目；不能仅凭链接以 HTTPS 开头，就认定它一定是订阅。

手动填写服务器参数

在 Home 的 SERVER 区域找到 Add Server，打开添加页面。先点 Type，选择与已有资料一致的协议类型，再填写 Host 和 Port。Host 是服务器域名或 IP 地址，Port 是服务端指定的端口。不要把整段分享链接填进 Host，也不要把地址中的路径或查询参数当成服务器名称。

后续字段随 Type 改变。截图展示了 Password、Method 等字段，但并非每种协议都使用同一组参数。Password、UUID、Method、TLS 相关参数及传输设置应逐项对应原始资料，不能用另一个协议的字段代替。端口和认证信息中的一个字符不同，也可能导致保存成功却无法连接。填写后保存，返回 Home，确认 SERVER 中出现刚添加的条目。

二维码与分享链接

如果已有二维码，在 Add Server 中选择 Scan QR Code，按系统提示允许使用相机，再将二维码完整置于取景区域。识别后先检查 Type、地址和端口，再保存。二维码只是资料的载体，并不自动证明内容正确。若相机未识别，先检查画面清晰度、二维码是否完整，以及它是否确实包含客户端可识别的配置。

已有单服务器分享链接时，可以复制完整内容，回到应用按出现的导入提示操作；未出现提示时，检查复制内容是否包含多余说明文字。Import from Cloud JSON 用于相应的 JSON 资料，不是通用订阅入口。遇到格式不明的内容，先向提供该资料的一方确认格式，不要反复更换 Type 试填。

使用 Subscribe 导入已有订阅

在 Add Server 的 Type 中选择 Subscribe，将自己的订阅链接完整填写到 URL 字段，保存并等待获取结果。回到 Home 后检查订阅分组和条目是否出现。订阅地址可能带有私人访问标识，应完整保留查询参数，但不要把它发布到截图、讨论区或公开文档。

如果只看到了订阅分组，却没有任何服务器条目，先检查本地网络能否获取该地址，以及订阅内容是否仍有效。不要把空分组当作导入完成。订阅更新可能增删条目，重命名或整理之前先保留原始资料。现在只需确认至少有一个与原资料一致的条目，下一步再决定流量处理方式。

回到 Home，在 SERVER 列表中点选准备使用的服务器，确认选中标记落在预期条目上。订阅分组里可能有多个名称相近的条目，应结合地址或已有备注辨认。列表中存在条目只表示资料已保存，不表示它已经被选中，更不表示客户端正在连接。

再次核对 Global Routing 显示的模式，然后打开顶部 Not Connected 对应的连接开关。首次使用时，系统可能询问是否允许添加 VPN 配置。这是允许 Shadowrocket 建立系统网络配置的授权步骤，并不是购买连接服务，也不会替用户填写服务器参数。确认是自己刚触发的操作后，按系统提示允许，并完成设备要求的身份验证。

如果刚才取消了授权，返回应用重新打开连接开关，按实际出现的系统提示处理。设备受管理策略限制时，权限可能无法自行更改，应先确认设备的管理要求。不要通过反复删除应用来尝试解决权限问题，这会增加丢失本地配置的风险。授权与服务器认证属于不同环节，允许添加 VPN 配置不会修复错误的 Host、Port 或 Password。

授权后回到 Home，观察顶部连接状态是否从 Not Connected 改变。若开关立即回落或状态迟迟未完成，先停止重复切换，记录当前模式、所选条目和提示文字。切换服务器或修改参数时，建议先关闭连接，完成修改后再重新连接，便于判断这次测试使用的是哪一组资料。

系统出现 VPN 标识，只能说明系统层面的 VPN 连接状态，不能单独证明目标网站可访问，也不能证明规则按预期命中。Home 的连接状态确认完成后，保留当前条目和模式，继续下一步做实际请求验证。此时先不要开启额外的自动连接条件，以免手动测试过程中连接被其他条件重新触发。

先按失败发生的阶段定位：没有导入内容，检查资料格式；有条目但不能连接，检查参数和权限；已连接但不能访问，检查 DNS、规则和目标。这样可以避免在订阅获取失败时反复修改 Rule，也避免在认证字段错误时调整与之无关的系统设置。

订阅未出现条目，或扫码后内容不完整

重新核对原始资料是否完整，尤其是订阅 URL 的查询参数、分享链接的前缀以及二维码边缘。检查订阅是否能在当前网络下获取，是否返回了登录页面或普通网页而非配置内容。不要把私人订阅地址交给不明的在线转换页面。确认格式后重新导入一次，再回 Home 检查条目；仍有问题时向资料提供方确认内容是否有效。

开关无法保持连接，或提示认证失败

先确认系统 VPN 配置权限，再核对所选条目的 Type、Host、Port 和认证字段。对要求 TLS 或特定传输参数的条目，还要核对服务器名称和对应设置，不能只检查 Password。若在另一个可信的本地网络下表现不同，记录这项差异，但不要据此承诺某种协议一定能解决。协议字段的具体含义可继续阅读协议参考。

测试有响应，但网页仍然打不开

进入 Settings 查看 Test Method，先了解 Connectivity Test 使用的测试方式，再将其与实际网页请求区分。随后检查当前配置的 DNS 设置和 Rule。使用域名访问失败，而其他测试有响应时，域名解析是需要检查的环节之一，但不能只凭这一现象确定原因。不要随意用 IP 地址替代 HTTPS 域名访问，因为证书和站点选择也依赖域名。

连接反复自动开启，或测试结果难以复现

在 Settings 中检查 On Demand。它用于按已设条件触发连接，不会自动修正错误的服务器参数。排查期间可暂时关闭 On Demand，以便观察手动开关的实际结果。确认手动连接和目标请求都正常后，再逐项恢复所需条件，并检查切换本地网络后的行为是否符合预期。

记录诊断信息，再做下一次修改

Settings 中的 Diagnostics 可用于查看可用的诊断信息。记录操作发生时的现象、当前 Global Routing、测试方式和错误提示，比只描述“不能用”更有助于缩小范围。分享记录前隐藏服务器私人地址、订阅 URL、认证字段和其他身份信息；不需要把完整配置公开出去。

每次只修改一项，并重复第四步的同一组验证。修改前保留原配置，能恢复时再继续尝试。若问题涉及订阅状态、服务端证书或认证资料，应由已有资料的提供方确认；若涉及购买、设备兼容性或已购恢复，回到已购恢复说明核对。更多分支情况见常见问题，不必为一个失败现象同时更改全部设置。