已有订阅 URL 时,从 Home → + → Type → Subscribe 添加;只有单台服务器参数时,使用 Add Server 手填;二维码与剪贴板只是不同的输入方式,导入结果取决于里面的内容。本文以用户已有自己的服务商与订阅为前提,说明入口、字段、更新与验证方法,并区分 Config 配置文件和 Subscribe 服务器列表。
一、先识别链接:Subscribe 与 Config 不是同一类内容
Shadowrocket(小火箭)的订阅导入,应先判断拿到的是服务器列表、单条服务器分享链接,还是配置文件。不要仅凭链接以 https:// 开头就选择入口:同样使用 HTTPS 的地址,返回内容可能完全不同。
Subscribe 用于获取、更新一组服务器;Config 用于管理包含规则、DNS 等设置的配置文件。搜索“Config 页 Subscribe”时尤其要区分这两个概念:常规服务器订阅的添加路径是 Home → + → Type → Subscribe,不是把服务器订阅当作 Config 配置文件下载。
服务器订阅
- 内容
- 一组服务器连接信息
- 入口
- Home → + → Type → Subscribe
- 示例
https://example.com/sub?token=xxxx- 更新结果
- 服务器列表随订阅响应变化
示例为假值,不能用于连接;应填写用户已有订阅的完整 URL。
Config 配置文件
- 内容
- 规则、DNS 等配置项
- 入口
- Config → +,添加远程配置地址
- 常见结构
[General]、[Rule]- 生效条件
- 选中配置,并使用适用的 Global Routing 姿态
文件名与扩展名不能单独证明内容类型,应核对提供方给出的用途说明。
单条分享链接则通常带有协议前缀,例如 ss://、vmess://、vless:// 或 trojan://。这类内容通常只描述一个服务器,不等于可以持续更新的订阅。扫码与剪贴板都可能读到这类链接,保存后应检查实际新增的是一个条目还是一个订阅分组。
二、Subscribe 链接导入:添加后检查首次更新结果
先从已有服务商的管理页面复制专用于客户端的订阅 URL,而不是登录页面地址。链接中的 token 属于访问凭据,应完整保留大小写、问号与连接符,不要把它发到公开评论区,也不要为便于记录而自行删掉参数。
-
复制链接
复制已有订阅的完整 URL。检查开头和末尾是否混入空格、引号或中文标点;不要复制页面标题或浏览器分享说明。
-
进入添加页
打开 Home → 右上角 +,进入 Add Server。点开 Type,将类型改为 Subscribe,而不是沿用上一次手填时选择的协议。
-
填写字段
在 URL 中粘贴订阅地址,在 Remarks 中填写便于辨认的名称。URL 是获取列表的地址,不应拆成 Address 与 Port 两项。
-
保存并更新
完成保存后回到 Home,检查是否已出现订阅分组与服务器条目;若尚未载入列表,下拉执行更新,并观察是否返回错误。
-
核对内容
展开分组,核对服务器数量、名称及协议是否与已有服务商的说明一致。只有分组标题而没有服务器时,应先排查更新响应,不要连续重复添加。
首次保存成功,只能说明订阅记录已经写入,不能证明远程内容已成功获取。更新时还会涉及网络访问、身份凭据与响应解析;若返回的是登录网页,即使网页本身可以打开,也不能作为服务器列表导入。
三、Add Server 手填:按协议填写,不套用默认参数
只有 Address、Port、密码或密钥等连接参数时,使用 Home → + → Add Server,在 Type 中选择实际协议。Shadowsocks、VMess、VLESS、Trojan、Hysteria2 与 WireGuard 的认证及传输字段不同,不能只改类型名称就沿用上一条记录。
端口没有通用正确值。例如提供方明确给出 Port 为 443 时才填写 443;这个数字本身既不能证明启用了 TLS,也不能替代密码、UUID、公钥或其他认证信息。
- Address:填写提供方给出的主机名或 IP 地址。字段要求主机名时,不附加
https://或网页路径。 - Port:填写实际服务端口,范围为 1–65535;不要把订阅 URL 中的查询参数误当作端口。
- 认证:Shadowsocks 需对应的加密方式与密码;VMess、VLESS 等应核对各自要求的标识与选项,不能相互替换。
- 传输与 TLS:按已有参数填写 SNI、Host、Path 等项目。Address 与 TLS 校验使用的域名不一定相同,不能凭名称相似推断。
- WireGuard:核对本地私钥、对端公钥、地址与 Allowed IPs 等信息,不把它当作仅需密码的连接类型。
保存后先核对详情,再进行连通性检查。手填记录没有订阅更新来源;提供方调整端口、密码或传输参数后,需要自行修改。若能够使用已有订阅,订阅通常更便于同步列表变化,但仍应核对更新结果。
四、二维码与剪贴板:先确认载荷,再确认保存位置
二维码不是一种独立协议。它可能装着单条服务器分享链接,也可能装着订阅 URL;二维码大小、图片名称或旁边的说明不能替代内容检查。仅扫描用户已有服务商提供或自己保存的二维码,避免导入来源不明的配置。
扫描二维码
- 从 Home 顶部的扫描入口打开相机,按系统提示授予相机权限,并将完整二维码置于取景范围内。
- 若二维码保存在当前设备,可使用扫描界面提供的照片读取入口;照片访问权限以系统提示为准。
- 识别后检查待导入内容。单条协议链接应对应服务器条目;订阅 URL 应作为 Subscribe 处理,不能仅因识别成功就跳过核对。
- 完成保存后返回 Home,查看新增条目或分组。订阅仍需成功更新列表,扫码本身不代表服务器已可用。
从剪贴板导入
- 先复制完整的分享链接,不要连同聊天记录里的说明、序号或代码围栏一起复制。
- 返回 Shadowrocket,允许此次必要的粘贴读取;出现剪贴板导入提示时,核对内容后确认。
- 若没有出现自动识别提示,先检查文本是否为受支持的完整分享链接。对于普通 HTTPS 订阅 URL,可直接使用 Home → + → Type → Subscribe,在 URL 中粘贴,不必依赖自动识别。
- 检查新增记录的 Type、Address 与 Port。完成后可将剪贴板换成不含凭据的普通文本,减少后续误粘贴。
五、导入后验证:服务器列表与 Global Routing 分开检查
先在 Home 选中一个已导入的服务器,再开启连接,并按系统提示允许添加 VPN 配置。系统出现 VPN 状态仅说明隧道已建立,不代表每个目标都经过所选服务器。是否转发某个连接,还取决于 Global Routing 与当前配置。
Config
推荐使用当前选中的配置处理连接。规则可以指定 PROXY、DIRECT 或其他已定义策略;未命中前面规则的连接如何处理,要看 FINAL 等配置内容,不能一概视为直连。
适合:已经核对 Config 文件、希望按既定规则分流的日常使用。
Proxy
将接管的连接交由代理处理,适合暂时排除规则选择的影响。它不能修复错误密码、不可达端口或已失效的服务器参数。
适合:临时检查所选服务器能否转发目标连接。
Direct
以直连姿态处理连接。切到 Direct 后网页能打开,不能证明刚导入的服务器可用,因为该测试没有验证代理链路。
适合:对照本地网络表现,排查是否为原有网络访问问题。
验证时一次只改变一个条件:先固定服务器与测试目标,再对比 Proxy 和 Config。若 Proxy 可访问而 Config 不符合预期,应检查 Config 中的匹配规则;若两者都失败,则先回查服务器参数与网络可达性。Global Routing 中的 Scene 属于场景化选择,初次排查时不要同时叠加场景切换。
- 检查 Home 中是否选中了预期服务器,而不是仅展开了订阅分组。
- 检查 Global Routing 当前值,并在 Config 姿态下确认 Config 中选中的文件。
- 若连接会自动恢复或断开,检查 Settings → On Demand 的触发设置;On Demand 不是订阅更新功能。
- 使用同一目标做前后对照,并观察实际连接记录;延迟测试有响应不等于所有业务请求都能成功。
六、导入与更新常见问题
订阅保存了,为什么还是空列表?
回到 Home 下拉更新,先记录返回的是超时、认证错误还是解析失败。核对 URL 是否为已有服务商提供的客户端订阅地址,而不是管理网页;再检查 token 是否完整。不要通过不断新建同一订阅来重试。
更新超时,要不要打开代理更新?
先确认当前网络可以访问订阅地址。如果已经有可用服务器,可连接后到 Settings → Subscribe 检查 Update via Proxy,再重试更新。没有可用连接时,仅打开该选项不能建立访问路径,需先解决订阅地址的网络可达性。
扫码成功,为什么没有订阅分组?
检查二维码内容是否是 ss:// 等单条分享链接。若导入的是单台服务器,没有订阅分组是正常结果;需要持续更新的列表时,应使用用户已有的 Subscribe URL,而不是反复扫描同一条记录。
复制了链接,为什么没有导入提示?
检查系统是否允许此次粘贴读取,并确认剪贴板没有混入说明文字。普通 HTTPS 地址不一定自动触发服务器导入;属于订阅 URL 时,手动进入 Home → + → Type → Subscribe,将完整地址粘贴到 URL 即可。
更新后服务器变少,需要重新添加吗?
先确认本次更新是否成功,再对照已有服务商提供的列表。远程列表移除条目后,本地分组随之变化可能是正常同步结果。不要先删除原订阅;核对地址、分组及错误提示后,再决定是否需要修正记录。
完成导入的判断标准是:内容类型正确、字段保存完整、订阅能够更新,并且选定服务器与路由姿态后实际请求符合预期。仅出现条目、扫码提示成功或 VPN 图标,都不能单独替代这些检查。