Shadowrocket 入门指南：
导入、连接与验证

步骤 01 / 输入连接资料

Add Server：添加服务器或导入订阅

打开 Shadowrocket，进入 Home，查看下方 SERVER 分组。首次使用还没有服务器时，先点 Add Server；如果入口以添加按钮显示，则进入后核对页面标题是否为 Add Server。接下来根据手中的资料选择一种方式：一组明确的服务器参数适合手动填写，一个由用户自己的服务商提供的订阅地址则适合通过 Subscribe 导入，不需要把两种方式重复做一遍。

手动填写：先选 Type，再核对字段

在 Add Server 中先选择 Type，让它与资料里的协议一致，例如 Shadowsocks、VMess、VLESS 或 Trojan。Type 会影响后面需要填写的字段，因此不要先填完再随意更换协议。右侧官方截图展示的是包含 Host、Port、Password、Method 的表单；其他 Type 的字段可能不同，应按对应协议资料填写，而不是照着截图补齐所有项目。

Host 填服务器主机名或 IP 地址，Port 填端口，Password 填服务资料指定的密码；出现 Method 时，选择与服务器一致的方法。主机名不要夹带空格、网页路径或说明文字，端口也不要把冒号一并粘贴进去。协议额外要求的身份、传输与 TLS 参数同样需要一致，不能因页面允许留空就假定服务器不需要。填写完保存，回到 Home 检查 SERVER 中是否出现刚才的条目。

已有订阅：通过 Subscribe 导入

如果拿到的是订阅链接，在 Add Server 的 Type 中选择 Subscribe，填写界面要求的订阅地址并保存。链接应完整复制，尤其注意末尾参数是否缺失、复制时是否附带换行。保存后回到 Home，等待内容获取完成，查看是否出现订阅分组及其中的服务器；若当前版本需要手动更新，则在该订阅的操作入口执行更新。看到订阅名称并不代表服务器内容已经成功取得，仍应检查分组里的实际条目。

订阅链接可能包含访问凭据，不要放进公开截图、聊天记录或排错文章。页面中的示例域名也不是可用服务，不能代替用户自己的资料。Add Server 底部的 Scan QR Code 可用于扫描用户已有的服务器二维码；Import from Cloud JSON 面向对应格式的数据，不应把普通订阅链接随意塞进该入口。资料形式不同，入口也应对应选择。

完成这一页后，先确认 Home 至少有一条可以选择的服务器，再继续设置 Global Routing。此时暂不急着调整多个高级选项；若导入失败，先检查地址与网络，详细问题可到疑难解答继续排查。

步骤 02 / 确定请求如何处理

Global Routing：选择分流姿态

有了服务器之后，回到 Home 打开 Global Routing。这里决定请求按哪一种整体方式处理，它与选中哪台服务器是两件事：服务器条目提供连接参数，Global Routing 决定请求是否以及如何使用代理。先理解配置(Config)/代理(Proxy)/直连(Direct)三个姿态，再开始连接，能避免把模式选择问题误认为服务器参数错误。

• 配置(Config)：按当前配置文件里的规则决定策略。不同请求可能分别使用 PROXY、DIRECT 或 REJECT，不能理解成所有请求都经过代理。
• 代理(Proxy)：以代理方式处理流量，适合在基本连接排查时与 Config 作对照。它不等于规则配置已经正确，也不能保证每个目标都能访问。
• 直连(Direct)：直接连接目标，不通过代理服务器。可以用来核对当前基础网络，但网页能打开并不能证明代理连接有效。

日常希望按规则分流时，选择 Config，然后打开 Config 查看当前使用的配置文件。注意“列表里有文件”与“该文件已经被选中使用”并不是同一件事；应确认当前生效项，再进入相应内容查看。官方截图展示配置编辑页的 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 分段，初次使用先关注 Rule 即可，不必同时改动全部段落。

进入 Rule 后，按从上到下的顺序阅读规则。具体条件应放在能被匹配到的位置，FINAL 通常放在末尾，为前面未命中的请求提供最终策略。下面只是语法阅读示例，不是要求覆盖现有配置：第一条让示例域名使用 PROXY，第二条让指定私有地址范围使用 DIRECT，最后一条提供兜底策略。

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY

如需通过 Add Rule 增加规则，先备份原配置，再核对类型、匹配内容与策略，保存后确认仍选中了要使用的文件。首次验证不建议直接导入大量来源不明的配置；规则变化会改变请求路径，让问题更难定位。关于匹配顺序的解释见规则顺序与 FINAL 说明。配置确认后，回到 Home 进行连接。

步骤 03 / 建立系统连接

在 Home 开启连接

回到 Home，在 SERVER 中选择准备使用的服务器，并确认选中标记落在预期条目上。订阅里可能有多个名称相近的条目，不要只记住列表位置；更新之后列表可能变化，应重新核对当前选择。接着检查 Global Routing 是否为刚才确定的姿态，避免上一轮排错留下的 Direct 设置影响这次判断。

点击 Home 顶部连接开关。首次建立连接时，系统可能请求允许添加 VPN 配置；阅读提示，确认操作由刚打开的 Shadowrocket 发起后，按设备要求完成授权或身份验证。这个系统权限用于建立网络隧道，并不会替用户生成服务器资料。如果拒绝了提示，应用可能无法进入正常连接状态，需要重新触发连接并完成授权。

授权完成后返回 Home，观察顶部是否从 Not Connected 进入已连接状态。开关短暂变化后又关闭、系统提示未完成、或状态持续不符合预期，都不应直接跳到修改 DNS。先确认授权确实完成、当前网络可用，并检查是否有另一项 VPN 连接正在影响本次连接。排查时先停用其他连接，再单独测试 Shadowrocket，不要同时改变多个网络条件。

连接开关打开只说明系统连接流程已经建立到相应阶段，不等于所有服务器、域名或应用都已经通过验证。下一步仍要运行 Connectivity Test，并在浏览器里检查实际请求。若希望停止使用，回到 Home 关闭顶部开关；首次验证阶段先用手动开关控制，等结果稳定后再考虑 On Demand。

步骤 05 / 每次只改一个条件

从失败现象回查 Settings

前四步没有得到稳定结果时，先按现象定位，再进入 Settings。这里可以看到 Language、Test Method、On Demand、Diagnostics 以及 Proxy、TCP、UDP 等项目。它们服务于不同功能，不存在适合所有连接的统一改法；不要因为某个开关可调整，就把它当作首次使用必须开启的项目。

没有导入内容：先查订阅获取过程

回到 Home 检查订阅地址是否完整、分组是否取得服务器内容。基础网络不能访问订阅地址时，保存订阅名称也无法取得列表。若用户自己的服务资料已变更，应重新核对地址与有效状态；导入成功后也要确认选中的不是旧条目。不要为了排查删除全部配置，先保留原记录，以便对比变化。

可以导入但连接失败：核对参数与网络

打开对应条目的编辑页面，将 Type、Host、Port 及身份信息逐项与原始资料对照。密码中的大小写、末尾空格以及协议专属参数都可能影响结果。先在当前网络测试，再在条件允许时切换另一种网络复测；若现象随网络变化，优先检查网络环境，不要同时改服务器字段和配置规则，否则无法知道哪项变化起了作用。

测试与浏览结果不同：检查测试方式和解析

在 Settings 查看 Test Method，确认本轮使用的测试方式，再回到 Home 重新执行 Connectivity Test。不同测试方式观察的环节不同，因此结果不能直接混在一起比较。测试正常但网页打不开时，分别检查域名解析、目标可达性与规则匹配；保留最少的修改范围，避免同时更换 DNS、规则和服务器。

连接自动恢复或反复变化：检查 On Demand

如果刚关闭连接又自动开启，先检查 On Demand 是否已启用，以及条件是否符合当前网络。首次排查可暂时关闭自动触发行为，用 Home 的开关手动重复测试。问题处理完成后，再按自己的网络使用习惯设置 On Demand；它控制连接触发条件，不会修正填错的服务器资料。

仍未解决：整理可复现信息

通过 Diagnostics 查看当前版本提供的诊断信息，记录失败发生在哪一步、当前姿态、测试方式，以及是否只影响一个目标。分享信息前遮住订阅链接、密码和个人访问记录。关于单项参数、系统授权及更多失败情形，转到疑难解答按分类继续检查；App Store 获取与已购恢复问题则阅读安装指南，不需要在网络排错中重新购买客户端。

排查完成后回到步骤四再做一轮验证，恢复预期的 Config、服务器选择和自动连接设置。保留一份已经验证可用的配置备份，后续调整时逐项记录修改内容；遇到新问题时，就能回到已知状态，而不是从头猜测。