Shadowrocket 使用教程：导入与首次连接

STEP 01 / INPUT

Add Server：添加服务器与导入 Subscribe

打开 Shadowrocket，进入 Home，在 SERVER 分组附近找到 Add Server。先分清手中的信息属于哪一种：订阅链接用于获取并维护一组服务器；单个服务器信息则需要选择相应协议并填写字段。两者不是同一种输入，不能把完整订阅地址直接填进 Host，也不能把服务器地址当作 Subscribe 地址。

已有订阅链接：选择 Subscribe

1. 点开 Add Server，进入 Type 选择列表，选择 Subscribe。在订阅地址字段中粘贴自己的完整链接，并填写便于识别的名称。
2. 检查粘贴结果是否完整，尤其注意开头、结尾、查询参数以及误带的空格或换行。订阅地址可能包含身份凭据，不应为了排查而公开展示。
3. 保存后返回 Home，等待订阅获取完成，或使用订阅项目提供的更新操作。确认 SERVER 中出现实际服务器条目，而不仅仅是一个订阅名称。

订阅更新成功只说明客户端获得了可解析的数据，不代表每个条目都能连接。先选取其中一个自己有权使用的条目，查看它的协议与地址是否符合预期，再继续下一步。如果列表为空，先核对订阅状态和地址有效性，不要连续重复添加同一条订阅；重复项目会使后续选择和排查更难分辨。

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

若手中是地址、端口和认证参数，在 Add Server 的 Type 中选择信息所对应的协议。选择后可填写的字段会随协议改变。截图中的 Host、Port、Password、Method 是对应界面的字段示例，并不是所有协议都必须出现的统一清单。Host 通常填写服务器域名或 IP 地址，Port 填写端口；Password、Method 以及其他认证或传输参数，必须与已有信息一致。

对于 VLESS、Trojan、WireGuard 等协议，继续核对各自需要的身份、加密或 Peer 参数；不要根据其他协议的字段猜测填法。若原始信息包含 TLS、SNI、传输路径等设置，也应逐项对应。暂时不能确认的参数应回到原始配置说明中查证，而不是随意关闭相关选项。

Scan QR Code 可用于扫描自己已有配置的二维码，使用时按系统提示处理相机权限，并在识别后复核内容。Import from Cloud JSON 用于对应格式的数据导入，不等同于通用订阅入口。保存后返回 Home，确认服务器条目存在且信息能够重新打开查看，再进入 Global Routing。

STEP 02 / ROUTING

Global Routing：选择连接姿态

服务器已添加后，回到 Home，点开 Global Routing。这里决定请求以什么方式交给当前配置或连接策略处理，与“是否已经打开连接”是两个问题。首次操作先明确目的：需要按规则分流，还是临时检查已选服务器是否可用。不要仅凭某个选项的名称判断它适合所有场景。

使用 Config 前，先确认活动配置

进入底部 Config 页面，确认当前选用的配置文件。服务器订阅与配置文件负责的内容不同：前者主要提供连接条目，后者决定规则和相关设置。导入了服务器订阅，不等于已经替换或启用了预期的规则配置。需要编辑时，先保留原文件副本，再打开配置查看；不要为了完成首次连接而一次性加入大量不熟悉的规则。

官方截图展示配置编辑中的 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等分段，以及 Add Rule 入口。本教程只需要核对与分流有关的 Rule 和策略目标；首次连接不要求改动其他分段，也不要求启用 HTTPS Decryption。

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

上面是规则语法阅读示例，不是要求直接覆盖现有配置。第一行按域名后缀匹配并交给 PROXY，第二行按 GEOIP 条件交给 DIRECT，最后一行作为未命中前面规则时的兜底。规则通常按顺序判定，且策略名称必须在当前配置环境中有效。不要只复制单行而忽略其依赖的策略定义。

若目前只想确认服务器能否正常建立连接，可先用代理(Proxy)缩小测试范围，基础连接确认后再切回配置(Config)检查分流。修改姿态后返回 Home，重新看一遍 Global Routing 的显示值。规则优先级和更细的匹配边界可阅读常见问题，避免在这一步同时改变服务器、规则和 DNS。

STEP 03 / CONNECT

Home：选择服务器并打开连接

回到 Home，检查 SERVER 分组，点选准备使用的服务器，确认选中标记落在预期条目上。若订阅中存在相近名称，应打开详情核对地址或备注，避免误选。然后再次确认 Global Routing：选择 Config 时，确保活动配置就是上一步核对的文件；选择 Proxy 时，确保当前选中服务器的信息已保存。

1. 找到 Home 顶部连接开关。未连接时可看到 Not Connected 状态，点击开关发起连接。
2. 首次使用若出现添加 VPN 配置的系统请求，核对请求来自刚打开的 Shadowrocket，再按系统提示确认。系统可能要求设备密码或身份验证，应在系统界面内完成。
3. 返回 Home，等待状态变化。若开关立即退回或系统请求未完成，先解决授权问题，不要连续快速切换。

VPN 配置授权的作用，是允许应用通过系统提供的网络机制处理流量；它不表示服务器密码已经验证，也不表示订阅仍然有效。开关保持开启，同样不能替代实际请求测试。应把“系统连接已建立”和“目标访问已成功”分开检查，下一步才验证网络结果。

已有其他 VPN 连接或设备管理策略时，系统可能存在配置冲突或权限限制。先核对设备当前使用的连接与管理状态；工作或学校管理的设备应遵循管理要求，不要删除不明配置。若之前拒绝了系统请求，可回到应用重试并查看系统中对应的 VPN 设置，具体位置随系统界面而异。

在 iPad 上使用时，页面可能因横屏或分栏而呈现不同布局，但仍按 Home、SERVER、Global Routing 和顶部开关寻找操作位置。首次连接建议保持在同一个 Wi-Fi 或蜂窝网络中完成测试，暂时不要同时切换网络环境，以便区分连接问题与网络变化。

STEP 05 / DIAGNOSE

Settings：按失败位置逐项排查

如果前四步没有得到预期结果，先确定失败发生在哪一层，再进入 Settings 查看有关设置。这里可看到 Test Method、On Demand、Diagnostics、Proxy、TCP、UDP 等项目。它们并不是首次连接必须全部调整的清单；已有默认值或现有配置时，应先保留，避免用大量改动掩盖最初的原因。

订阅没有生成服务器条目

回到订阅项目，核对地址是否完整、当前网络是否能访问该地址，以及订阅本身是否仍有效。若地址返回网页、登录提示或错误内容，客户端不一定能将它解析成服务器列表。向原信息提供方核实地址用途时，应描述报错与发生时间，不公开完整链接。订阅更新可能替换其管理的条目，手动编辑前先分清条目来源。

开关打不开，或打开后立即关闭

先看系统 VPN 配置请求是否完成，再核对当前是否已有冲突连接、是否受设备管理策略限制。服务器超时与系统授权失败属于不同问题：授权尚未完成时，反复修改 Host、Port 不会解决开关问题。若在系统更新或设置调整后出现异常，先重新打开应用并记录具体提示，再按排查手册的授权流程处理。

开关已开，但 Connectivity Test 超时

依次核对 Host、Port、认证参数、协议 Type 和传输设置，尤其注意字母大小写、复制时的空格以及 TLS 相关字段。检查设备日期与时间是否准确，因为证书校验可能受时间影响。随后在条件允许时换用另一个自己有权使用的网络进行对照，每次保持同一个条目和同一种测试方法。若只有某个条目失败，应优先检查该条目的原始参数和服务状态。

仅 Config 下失败，或部分域名异常

先查规则，再查名称解析。确认活动配置没有选错、策略名称能够对应到有效目标、REJECT 没有误拦所需请求。域名请求与直接使用 IP 的测试结果不同，可能涉及 DNS，也可能涉及目标对域名或 TLS 的要求，不能只凭一次现象作结论。检查当前配置中的 DNS 设置是否与网络和连接方式匹配；不应随意填入陌生地址来尝试修复。

测试方式与自动连接影响观察

Test Method 决定相关测试采用的方法，不同方法可能受服务器与网络条件影响。比较前先统一方法，勿将某一种测试失败等同于所有通信失败。On Demand 负责系统条件触发的按需连接，不负责定义每个请求的规则策略；如果手动断开后连接再次触发，应检查已有 On Demand 条件，而不是把它当作 Global Routing 的替代选项。

需要更详细证据时，使用 Diagnostics 中适合当前问题的诊断功能，并记录失败步骤、测试方法、网络类型和错误文字。分享记录前遮盖订阅凭据、服务器认证信息和可识别个人的数据。本站教程只说明操作与诊断路径，不接收连接凭据。

到这里仍不能定位时，不必继续反复导入或重建所有项目。保留最近一次可复现的现象，前往故障排查手册按症状继续；购买、已购恢复与常见界面概念可查阅常见问题。日常使用则保持已验证的配置，再按实际需求逐项调整。