本文速览

本文适合已经持有自己服务商订阅或服务器参数的用户。先区分服务器订阅与远程配置,再按 Subscribe、Add Server、扫码、剪贴板四种入口完成导入,最后检查更新结果、Global Routing 与 Connectivity Test。四种方式并不都会建立可更新的订阅组,导入成功也不等于已经完成连接。

先区分服务器订阅与 Config 配置

Shadowrocket(小火箭)的 Home 主要用于选择服务器、管理服务器订阅和连接;Config 用于管理规则配置文件;Settings 用于调整应用设置。服务器订阅提供连接条目,规则配置决定请求如何分流,两者不能仅凭一个 HTTPS 地址就视为同一种内容。

Config 页的 Subscribe 面向远程配置文件;如果手中是服务商提供的服务器订阅地址,应从 Home 右上角「+」进入 Add Server,将 Type 设为 Subscribe。把服务器订阅当成规则配置导入,可能出现解析失败,或者导入后仍找不到预期的服务器列表。

服务器订阅

入口
Home → + → Type → Subscribe
内容
一组服务器连接参数
示例地址
https://example.com/sub?token=xxxx
检查位置
Home 中的订阅组及其条目

地址仅为格式示例。实际导入使用自己已有的有效地址。

远程规则配置

入口
Config → Subscribe
内容
包含 [General]、[Rule] 等段落的配置文本
示例地址
https://example.com/profile.conf
检查位置
Config 中保存并选用的配置文件

配置可能改变 DNS、规则与策略引用,应用前应先检查内容。

判断格式时,先看提供方对链接用途的说明,再看返回内容;不要只看文件后缀。HTTPS 地址也可能返回登录页面、错误提示或已过期通知,这些内容不能作为服务器订阅解析。订阅中的 token 通常具有访问凭据的作用,排查时应遮盖完整地址、密码与 UUID。

方式一:用 Subscribe 建立可更新订阅

需要持续同步服务器条目时,使用 Type 为 Subscribe 的订阅记录。该记录保存订阅地址,后续更新重新获取服务器列表;它与逐个保存单条服务器参数的区别,在于是否保留了可重复请求的数据来源。

  1. 复制地址

    从自己的服务信息中复制完整订阅地址,保留 https://、路径与查询参数。不要将说明文字、换行或末尾标点一并复制。

  2. 选择类型

    进入 Home → 右上角「+」→ Add Server → Type → Subscribe,确认没有停留在某个单服务器协议类型。

  3. 填写地址

    在 URL 中粘贴订阅地址,在备注中写便于辨认的名称。核对 token 是否完整,再保存记录。

  4. 更新列表

    回到 Home,下拉触发订阅更新。等待请求结束,展开对应订阅组,检查是否生成服务器条目,而不是只看到一个空组。

  5. 检查条目

    打开一个条目的编辑信息,核对 Type、服务器地址与 Port 是否符合已有资料,然后在 Home 选择该服务器。先完成一次验证,再调整自动更新设置。

如果拿到的是远程规则配置地址,则进入 Config → Subscribe 添加并获取配置,在 Config 中检查内容后选用。更新远程配置与更新服务器订阅是两个动作;更新其中一个,不代表另一个也已经同步。

方式二:在 Add Server 手动填写参数

只有服务器地址、端口和认证信息,而没有可导入链接时,使用 Home →「+」→ Add Server。先选 Type,再按协议填写字段;Type 改变后,所需认证、传输与 TLS 参数也会改变。手动添加的是单个连接条目,不会自动成为可更新的订阅。

Add Server 中需要按原始资料核对的参数
Type核心参数常见遗漏
Shadowsocks服务器地址、Port、加密方法、Password加密方法与服务端不一致,或漏填服务端要求的插件参数。
VMess / VLESS服务器地址、Port、UUID、传输设置只填 UUID,遗漏 TLS、SNI、WebSocket Path 等实际启用的设置。
Trojan服务器地址、Port、Password、TLS 相关设置将连接地址与用于证书验证的服务器名称混为一谈。
Hysteria2服务器地址、Port、认证信息、TLS 设置漏填服务端启用的混淆参数,或当前网络限制 UDP。
WireGuard私钥、对端公钥、Endpoint、接口地址把密钥当作普通密码,或漏掉对端与接口参数。

例如,资料明确标注 Port 为 443 时才填写 443;不要因为启用了 TLS 就自行将端口改成这个值。连接 IP、SNI 和 HTTP Host 可能承担不同作用,应分别照原始配置填写。TLS 验证报错时,优先检查设备时间、服务器名称与证书信息,不要把关闭验证当作常规修复。

方式三与四:扫描二维码、从剪贴板导入

二维码和剪贴板是传递数据的入口,不是新的连接协议。二维码可以承载单服务器 URI,也可以承载订阅地址;剪贴板中的内容同样如此。最终是否建立订阅组,要看解析出的内容,而不是看采用了哪种导入动作。

扫描二维码

  1. 将自己已有的二维码显示在另一块屏幕或纸面上,进入 Home 的扫描入口;首次使用时允许相机访问。
  2. 保持二维码边缘完整、画面清晰,扫描后检查解析结果。单条服务器应核对 Type 与 Port,订阅地址应核对 URL。
  3. 确认后保存,再回到 Home 检查新增条目或订阅组。若二维码只是普通网页入口,应先取得真正的连接资料,而不是将网页地址强行作为订阅保存。

同一台设备上显示的二维码可优先改用对应文本链接,避免反复截取和转发含凭据的图片。二维码中也可能包含密码、UUID 或订阅 token,应按连接凭据保管。

从剪贴板导入

  1. 只复制完整链接文本,例如以 ss://、vmess://、vless:// 或 trojan:// 开头的单条分享链接;不要复制整段聊天记录。
  2. 返回 Shadowrocket,按剪贴板识别提示执行导入;系统询问粘贴权限时,仅在这次主动操作中允许。
  3. 如未出现识别提示,先检查剪贴板是否仍有原文。普通 HTTPS 订阅地址可直接进入 Home →「+」→ Type → Subscribe,粘贴到 URL,而不必依赖自动识别。
  4. 保存后检查条目数量与名称。多次复制导入可能产生重复单条记录,需要逐一辨认后保留所需项。
服务器订阅地址格式示例:
https://example.com/sub?token=xxxx

远程配置地址格式示例:
https://example.com/profile.conf

单服务器分享链接的常见前缀:
ss://
vmess://
vless://
trojan://

上面的域名与 token 是格式示例,不是可连接资料。分享链接中的编码内容不要手工拆改;特别是 +、/、=、% 等字符被聊天工具替换或截断后,可能无法还原原始参数。

导入后检查 Global Routing 与连接结果

导入只解决“资料进入应用”的问题。下一步在 Home 选中服务器,检查 Global Routing,打开连接开关,并在系统提示时允许添加 VPN 配置。然后运行 Connectivity Test,再测试实际需要访问的目标;单次测试成功只说明该次测试请求得到了结果。

Config

推荐

按当前选用的配置匹配规则。需先在 Config 检查规则顺序和策略引用,再判断某个请求应当直连还是经由代理。

适合:已经核对规则配置后的日常使用。

Proxy

将一般请求交给代理路径,可用于临时排查规则因素。仍需考虑系统流量、绕过设置及网络环境,不能据此断言设备的每个数据包都经过同一路径。

适合:确认服务器基本连接能力、暂时隔离规则问题。

Direct

使用直连路径。即使已导入并选中服务器,也不能用这一姿态下网页打开成功的现象证明代理服务器可用。

适合:检查本地网络的直连状态。

Scene

按已设置的场景条件应用相应路由行为。应先核对当前命中的场景及其设置,不把它作为含义固定的另一种全局代理模式。

适合:已经配置并验证场景条件的网络切换需求。

在 Config 姿态下,可用下面的规则片段理解首条命中逻辑。它不是完整配置;PROXY 所引用的策略必须在实际配置中可用,不能仅粘贴几行规则就认为所有设置已经完成。

[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 接住此前未命中的请求。规则从上到下匹配,因此具体规则应放在宽泛规则前。首次验证期间可先到 Settings → On Demand 检查是否启用了自动连接条件,避免手动断开后又被条件重新触发。

导入失败与更新异常怎么排查

先区分三种现象:没有产生条目,属于获取或解析阶段;产生条目但无法连接,属于服务器参数或链路阶段;连接后部分目标异常,才继续检查规则与 DNS。按阶段处理,可以避免把所有问题都归结为“订阅失效”。

链接复制进去了,为什么还是空的?

先检查是否误把服务器订阅放到了 Config → Subscribe。服务器订阅应在 Home →「+」→ Type → Subscribe 添加。再核对 URL 是否缺少 token、混入空格,或返回了登录与到期提示;有 HTTP 状态信息时,401、403 应检查授权与访问条件,404 应检查路径。

订阅更新超时,要先开连接吗?

先确认当前网络能访问订阅地址。如果已有可用服务器,可连接后重试;需要通过现有代理获取订阅时,在 Settings → Subscribe 检查 Update via Proxy。没有可用连接时,打开此项不会自动解决首次获取问题,应先核对自己的地址与网络。

扫码有结果,为什么不能连接?

识别成功只证明二维码内容可解析。打开导入条目,逐项核对 Type、Port、认证信息与 TLS 参数;回到 Home 选中该条目,再运行 Connectivity Test。若每个条目都失败,继续检查本地网络;若只有一个失败,优先核对该服务器参数与服务状态。

更新后手动改的名称和参数变了?

订阅更新会重新采用远程返回的数据,组内手动修改可能被覆盖。回到订阅组确认来源;确实需要独立维护的条目,应通过 Add Server 单独保存完整参数,并自行维护,不再把订阅同步当作该条目的更新方式。

测试通过,但某个网页仍打不开?

先确认 Global Routing 当前是 Config、Proxy、Direct 还是 Scene,再检查该请求的实际规则匹配与 DNS 结果。Config 下重点查 DOMAIN-SUFFIX、IP-CIDR、GEOIP 与 FINAL 的顺序;不要为了一个目标反复删除并重新导入整个订阅。