本文面向首次使用 Shadowrocket(小火箭)、且已有自己的服务商与订阅的用户。按获取客户端、添加订阅、启用连接、选择 Global Routing、检查规则与排查故障的顺序说明;具体操作路径以 iPhone / iPad 界面为例,其他平台的窗口位置可能不同。先分清连接参数与规则配置,再逐项验证,避免把订阅更新失败当成连接开关故障。
一、电脑与安卓能用吗?客户端在哪里获取?
Shadowrocket 提供 iPhone / iPad、Mac、Windows、安卓与 Linux 版本。iPhone / iPad 从 App Store 获取,开发者为 Shadow Launch Technology Limited,价格为 $2.99 一次性付费;Mac(Apple 芯片与 Intel)、Windows、安卓、Linux 版免费。iPhone / iPad 系统要求以 App Store 页面标注为准。
前往本站下载指南,先选平台,再按设备架构和系统选择对应入口。Mac 的 Apple 芯片与 Intel 安装包需要区分;Linux 则需要按发行版选择包格式。桌面与安卓安装包通过本站下载页的站内入口获取。
客户端买断 ≠ 线路套餐。本站不提供、不销售、不推荐节点或订阅。下文所有连接操作均以用户已有自己的服务商与订阅为前提。
二、Home、Config、Settings 分别管什么?
Home 用于查看连接条目、选择当前连接并操作连接开关;Config 用于管理规则配置文件;Settings 放置客户端设置,包括 On Demand 等功能。订阅中列出的连接条目与 Config 中的规则文件用途不同:前者回答“连到哪里”,后者回答“哪些请求使用哪种策略”。
- Home:先核对当前选择的条目,再检查连接状态。条目存在不代表远端服务一定可用。
- Config:核对当前选中的配置文件以及其中的
[Rule]段。仅把文件下载到列表,不等于已选中使用。 - Settings:调整客户端行为。排查前先记录改过的选项,避免同时改变多项设置后无法判断原因。
首次使用时,先完成一个可验证的流程:添加已有订阅、选中一个条目、启动连接、访问目标网站。此流程通过后,再修改分流与自动连接设置。
三、订阅链接到底添加在哪里?
订阅链接应填入 Subscribe 类型的记录,而不是粘贴到服务器地址、密码或规则编辑区。下面的地址仅用于说明格式:https://example.com/sub?token=xxxx。它不是可用服务地址;实际操作必须使用你已有服务商提供的完整链接。
-
复制完整链接
复制已有订阅地址,保留
?后的参数,检查开头、结尾没有空格或换行。不要把服务商网页的登录地址当作订阅地址。 -
选择类型
打开 Home → 右上角「+」→ Type → Subscribe。确认类型后,再填写订阅 URL 和便于识别的名称。
-
保存并更新
保存后返回 Home,执行订阅更新;在 Home 下拉刷新后,等待请求结束,再查看该订阅分组下是否出现连接条目。
-
核对条目
展开对应分组,核对名称和条目数量是否符合已有服务的说明,再选择一个条目进行连接测试。
订阅 URL 中的 token 通常具有访问凭据的作用。提交故障截图时,应遮住完整 URL、二维码、密码和密钥;不要把这些内容放进公开留言。
四、连接开关在哪里?第一次为什么要确认 VPN?
连接开关位于 Home 顶部。先选中一个连接条目,再打开开关。iPhone / iPad 首次建立连接时,系统可能要求允许添加 VPN 配置;该确认用于建立系统网络扩展的工作环境,与订阅是否有效是两件事。
- 在 Home 点选准备使用的条目,检查当前选中标记。
- 打开 Home 顶部连接开关,按系统提示完成 VPN 配置授权。
- 返回 Shadowrocket,确认连接状态,再用浏览器发起一个新的网页请求。
- 需要停止时关闭同一开关;如果随后自动重连,继续检查 Settings → On Demand。
系统显示 VPN 状态,只能说明系统隧道已经启用,不能证明远端鉴权、DNS 解析和目标网站均正常。不要仅凭状态标记判断连接成功,必须结合具体请求结果。
五、Global Routing 应该选 Config、Proxy 还是 Direct?
Global Routing 决定整体流量处理方式。日常需要按域名或 IP 分流时使用 Config;临时排查代理路径时可切换 Proxy;需要检查本地网络直连能力时可切换 Direct。Scene 用于按场景组织切换,不应把它理解为另一种代理协议。
- Config:使用当前配置中的规则决定请求策略。检查结果时,需要同时看配置文件、规则顺序和命中的策略。
- Proxy:将全局策略切换到代理方向,适合与 Config 做对照测试;不能据此保证所有请求都能访问成功。
- Direct:将全局策略切换到直连方向,不经过所选代理服务器。它不是“自动选择最快条目”。
- Scene:用于场景切换。新手尚未配置场景条件时,先用明确的 Config、Proxy、Direct 完成排查。
对照测试时保持同一个连接条目和目标网址,只改变 Global Routing。若 Proxy 下可访问、Config 下失败,应进一步检查规则与策略引用,而不是立即替换所有连接参数。测试结束后恢复原本需要的姿态。
六、规则放在哪里,为什么改完没有生效?
规则写在配置文件的 [Rule] 段,使用 Config 姿态时按顺序匹配。先检查 Config 中当前选中的文件,再检查规则是否写进该文件。编辑另一个未启用的文件,不会改变当前流量处理方式。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY
这段内容是规则语法示例,不是完整配置。DOMAIN-SUFFIX 匹配指定域名后缀及其子域名;IP-CIDR 匹配地址网段;GEOIP 按 IP 地理数据库分类;FINAL 为未命中前面规则的请求提供兜底策略。域名请求与 IP 请求的匹配条件不同,不能仅用地址栏中的文字推断最终命中项。
规则检查
- Global Routing
- Config
- 文件位置
- Config → 当前选中的文件
- 规则段
[Rule]- 匹配顺序
- 从上到下,FINAL 放在末尾
新增规则后保存,并用新的请求验证命中结果。
策略检查
- DIRECT
- 直连策略
- PROXY
- 代理策略,核对实际选择的连接
- 自定义名称
- 必须与配置中定义的策略名称一致
- no-resolve
- 用于 IP 规则,避免为该规则额外触发域名解析
已有连接可能继续复用;必要时重建连接后再测试。
七、订阅更新会改变什么?需要每次连接前更新吗?
订阅更新会重新请求 URL,并按返回内容刷新连接条目。它不等于打开连接开关,也不等于自动替换 Config 中当前使用的规则文件。没有服务变更时,不必把反复更新当作每次连接前的固定步骤。
- 适合更新:服务商通知条目调整、服务器地址变更,或订阅分组显示的内容与服务商说明不一致。
- 先查 URL:更新失败时核对完整链接和有效状态;网页能打开,不代表该订阅接口一定返回可解析的数据。
- 保留观察结果:记录超时、鉴权失败、解析失败或空列表,分别对应不同的检查方向。
- 检查更新路径:若订阅地址需要经已有代理访问,可在 Settings → Subscribe 检查 Update via Proxy;前提是已有连接本身可用。
订阅返回空内容时,反复删除并重新添加同一 URL 通常不能改变服务端返回值。先确认服务有效期、订阅权限以及服务商侧状态,再决定是否重新导入。远程规则配置更新还可能覆盖本地修改,编辑前应保留自己的配置副本。
八、On Demand 是自动连接吗?关闭开关后为什么又连上?
Settings → On Demand 用于配置按条件触发的连接行为。它与 Global Routing 的分工不同:On Demand 处理何时建立或断开隧道,Global Routing 处理隧道启用后的流量策略。手动关闭后又重连,需要先检查是否存在仍然满足的 On Demand 条件。
- 打开 Settings → On Demand,检查功能是否启用,以及是否存在针对当前网络的规则。
- 记录 Wi-Fi、蜂窝网络等条件对应的动作;不要把某个 Wi-Fi 的设置理解为所有网络的设置。
- 排查手动连接时,先暂时关闭 On Demand,再返回 Home 操作连接开关。
- 确认手动连接正常后,再恢复自动规则,分别在目标 Wi-Fi 和蜂窝网络下验证。
自动连接条件不负责修复远端服务器、账户或规则问题。如果手动连接尚未通过验证,先不要叠加自动连接设置;否则系统触发重连和远端失败可能交替出现,增加定位难度。
九、订阅有条目、开关也开了,为什么仍不能访问?
按“本地网络 → 所选连接 → Global Routing → 规则 → DNS 与目标网站”的顺序排查。每次只改变一项,并记录同一网址在改变前后的结果。单纯看到延迟数值,不代表目标网站的 HTTPS 请求已经完成。
关闭连接也打不开网页?
先关闭 Home 连接开关,并暂时停用 Settings → On Demand,再访问本来可以直连的网站。若仍失败,先完成 Wi-Fi 登录认证或检查本地网络,不要先改代理协议参数。
Proxy 能打开,Config 不行?
保持条目不变,回到 Config 核对当前配置文件;重点检查目标域名的 DOMAIN-SUFFIX 规则、前置规则和 FINAL,以及规则引用的策略是否存在。
更新成功,但所有条目都超时?
更新成功只说明订阅请求有结果。核对服务有效状态、服务器地址、端口和鉴权信息,再换一个已有条目做对照。若多个网络下结果一致,将脱敏后的错误信息交给已有服务商核查。
若只有某个网站异常,应同时考虑目标网站自身状态和访问限制。若表现为域名访问失败而地址连接测试可达,再检查 DNS 设置;不要把随意更换 DNS 当作所有故障的通用处理步骤。
十、需要手填协议参数吗?换设备能直接照抄吗?
已有可解析订阅时,优先使用订阅提供的连接参数。手动添加前必须确认协议类型;Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 的字段含义不同,不能因为都有“密码”或“密钥”就混填。
- 地址与端口:按已有服务的说明填写。端口必须是整数;HTTPS 订阅地址使用的 443 端口,不代表代理服务器端口也是 443。
- TLS 与传输:TLS、Server Name、Host、Path 分别有自己的作用,不要把订阅 URL 整段填入其中。是否启用必须与服务端配置一致。
- 协议身份:VMess / VLESS 的 UUID、Trojan 的密码、WireGuard 的 PrivateKey / PublicKey 不是同类凭据,不能互换。
- 换设备:在新设备导入自己的订阅后,重新核对 Global Routing、Config 和 On Demand。旧设备的本地设置不会因为使用同一订阅而自动全部复制。
迁移 WireGuard 等包含设备密钥的配置前,还应核对服务是否允许复用、地址是否需要单独分配。不要把多个设备同时使用失败简单归因于客户端;服务端的设备限制和密钥安排也会影响结果。更详细的首次连接流程可对照使用教程,协议字段说明可查阅协议详解。