有订阅地址就使用 Subscribe,需要逐项核对连接参数就使用 Add Server,已有二维码或分享文本则用扫码、剪贴板导入。本文以用户已有自己的服务商与订阅为前提,说明四种入口的资料要求、保存后的检查方法以及更新失败的排查顺序。操作以 iPhone / iPad 界面为参照,其他平台按对应字段核对,不把导入成功等同于连接成功。
一、先区分订阅地址、单条连接与配置文件
Shadowrocket(小火箭)的导入入口处理的是不同类型的资料。Subscribe 指订阅:客户端从一个地址读取服务器列表,以后再从同一地址获取变化。Add Server 指添加服务器:直接保存一条连接所需的协议与参数。扫码和剪贴板只是读取资料的方式,读取到的内容仍要先判断属于哪一种类型。
Config 是配置文件管理页,不能把其中的远程配置地址与服务器订阅混为一谈。配置文件可以包含规则、DNS 等设置;服务器订阅主要提供连接条目。查看 Config 页的 Subscribe 相关内容时,先确认操作对象是服务器订阅,还是配置文件中的订阅引用。常用的直接添加路径是 Home → 右上角“+”→ Add Server → Type → Subscribe。
| 已有资料 | 辨认方法 | 处理方式 |
|---|---|---|
| 服务器订阅地址 | 通常是带访问凭据的 HTTPS 地址,打开后返回列表内容 | 在 Type 中选择 Subscribe,填写 URL |
| 单条分享链接 | 常见前缀为 ss://、vmess://、vless://、trojan:// | 扫码或从剪贴板读取,再核对导入字段 |
| 分项连接参数 | 分别提供服务器地址、端口、密码或 UUID 等 | 在 Add Server 选择相应 Type 后手填 |
| 远程配置文件 | 正文包含配置段、规则等内容,不只是服务器列表 | 在 Config 管理,不把它当作服务器订阅地址 |
一个以 https:// 开头的地址也可能只是账户登录页,不能仅凭前缀判断为订阅。先在自己的服务资料中确认用途,再导入。下面是不可用于连接的格式示例,其中 example.com 是说明用域名,token=xxxx 是假值:
https://example.com/sub?token=xxxx
二、Subscribe:添加订阅并保留更新来源
已有订阅地址时,优先保存为 Subscribe,而不是把其中的服务器逐条复制出来。这样后续更新仍能找到原始来源。导入前复制完整地址,不附带“订阅地址:”等说明文字,也不要把消息中的换行、空格一起复制。
-
准备地址
从自己的服务资料中复制订阅 URL。核对开头、查询参数与末尾字符,保留原有的大小写和编码,不自行删掉问号后的内容。
-
进入添加页
打开 Home,点右上角“+”进入 Add Server;在 Type 中选择 Subscribe。不要为了粘贴订阅地址而选择 Shadowsocks 等单服务器类型。
-
填写订阅
将完整地址放入 URL,给备注填写便于辨认的名称,例如“个人订阅”。备注用于识别来源,不会改变订阅返回的服务器参数。
-
保存并更新
保存后回到 Home,检查订阅分组是否出现;下拉刷新订阅列表,等待本次请求完成。首次读取失败时先保留错误信息,不要连续重复添加。
-
核对条目
展开对应分组,确认有服务器条目,检查名称与协议是否符合自己的资料。随后选择其中一条进行连接测试,不能只凭分组名称出现就判断完成。
订阅更新与连接测试是两件事。前者验证客户端能否下载并解析列表,后者验证列表中的某个服务器是否可用。订阅更新成功但全部连接失败时,应检查服务器参数与服务状态;订阅更新本身失败时,应先检查 URL、网络与响应内容。
同一地址通常只需保存一份。反复添加会生成难以辨认的重复来源,之后更新和删除容易选错。需要替换地址时,先确认旧分组与当前选中服务器的关系,再编辑对应订阅;手工改过的订阅条目也可能在后续更新中被来源数据覆盖。
三、Add Server:按协议手填连接参数
只有服务器地址、端口和认证资料,没有可用订阅时,使用 Home → “+”→ Add Server。第一步先选 Type,再填字段。协议类型决定认证结构,不能把 VMess 的 UUID 填进 Shadowsocks 的密码栏,也不能把普通 TLS 设置当成全部协议共用的开关。
Shadowsocks 字段
- Type
- Shadowsocks
- Address
- 填写自己的服务器域名或 IP
- Port
- 填写资料指定端口,例如 443
- Method
- 与服务端加密方法完全一致
- Password
- 填写对应密码,保留大小写
443 只是端口格式示例,不代表默认端口,也不表示该连接一定使用 TLS。
VMess 字段
- Type
- VMess
- Address / Port
- 分别填写服务器地址与端口
- UUID
- 使用资料中的完整标识
- Transport
- 按服务端要求选择传输方式
- TLS
- 按资料核对开关与服务器名称
启用 WebSocket 等传输时,还需核对 Host、Path 等相应字段,不能仅填写 UUID。
VLESS、Trojan、Hysteria2、WireGuard 也应选择各自对应的 Type。VLESS 通常需要核对 UUID 及传输设置,Trojan 需要核对密码和 TLS 相关参数;Hysteria2 与 WireGuard 的字段结构不同,不能套用前面两张卡片。以自己的连接资料与应用显示的对应字段为准,缺失参数时不要凭名称猜填。
- Address 中填写主机名或 IP,不把整条 https:// 订阅 URL 填进去。
- Port 只填写端口数字,合法范围为 1–65535,不把“域名:端口”整段放入端口栏。
- 需要 TLS 时,服务器名称与证书验证有关;连接失败不能直接通过跳过证书验证来代替参数核对。
- 保存前再次检查空格、全角冒号与换行。密码和 UUID 的末尾多一个字符也会造成认证失败。
四、扫码与剪贴板:先读取,再检查识别结果
二维码并不天然等于订阅,它只是文本的图形编码。二维码里可能是一条 ss:// 分享链接,也可能是订阅 URL 或普通网页。打开 Home 的扫描入口,按提示允许相机访问,将完整二维码置于取景区域内;识别后核对目标类型和字段,再确认保存。
- 先看二维码是否完整、清晰且没有遮挡。二维码边缘被裁切时,应重新取得完整图片,不靠反复扫描补救。
- 如果识别结果是一条服务器连接,检查协议、地址、端口与备注;不要期待它自动生成可更新的订阅分组。
- 如果识别结果是订阅地址,按 Subscribe 的流程保存来源;若只是账户网页,返回自己的资料页寻找真正的订阅入口。
- 二维码位于同一台设备时,可使用扫描页提供的图片读取功能;没有相应选项时,改用原始文本复制,避免把二维码转发到不可信渠道。
剪贴板导入适合已经拿到分享文本的情况。先复制完整的一条链接,回到 Home 后按剪贴板导入提示操作;需要系统授权读取剪贴板时,只在本次明确导入的情况下允许。若没有出现提示,可以重新复制一次,并检查 Home 添加入口中是否提供从剪贴板读取的操作。
常见的单条分享形式包括 ss://、vmess://、vless://、trojan://,但有这些前缀不代表内容一定完整或与当前协议设置兼容。复制时不要带上引号、聊天编号、Markdown 标记或末尾句号。批量文本导入后应核对条目数量,避免把同一条连接重复保存。
五、按更新需求选择导入方式
四个入口不必全部使用。同一份资料若既有订阅又有单条分享链接,选择一种能保留所需管理方式的入口即可。下面只比较 Shadowrocket 内部的导入与更新方式;“推荐”针对需要持续同步列表的使用情形,不代表服务器质量。
Subscribe:保留来源
推荐保存订阅 URL,后续从同一来源刷新服务器列表。来源中的条目新增、移除或参数变化,需要完成更新后才会反映到本地。
适合:已有订阅地址、需要持续同步服务器列表
Add Server:逐项填写
按协议手动保存连接参数,便于逐字段核对。它不会因为某个外部订阅发生变化,就自动改成新的地址或密码。
适合:只有分项参数、需要单独保存一条连接
扫码或剪贴板:读取文本
减少输入错误,最终保存成什么对象取决于文本内容。单条分享链接通常只形成单条服务器记录,不会自动获得订阅更新能力。
适合:已有二维码或完整分享链接、希望减少手填
更新前若做过本地修改,先记下修改对象与用途。订阅来源负责维护的条目可能在更新时重建,而独立手填的条目不应被误当作订阅备份。订阅凭据更换后,编辑原订阅 URL,再进行一次更新,比不断新建分组更容易核对结果。
六、导入后的连接检查与常见问题
返回 Home,选中刚导入的服务器,再打开连接开关。首次建立 VPN 配置时按系统提示确认授权。随后检查 Home → Global Routing:Proxy 表示使用代理姿态,Direct 表示直连姿态,Config 表示根据当前配置规则处理;导入订阅本身不会替你决定规则如何分流。
- 先确认选中了具体服务器,而不只是展开了订阅分组。
- 使用 Home 中的 Connectivity Test 查看测试结果,再打开实际需要访问的页面验证;一次测试有响应不代表所有目标都能访问。
- 如果 Config 姿态下某个请求直连,应核对当前配置与命中规则,而不是立即删除订阅重导。
- Settings → On Demand 管理按条件触发连接的行为,不负责下载订阅;初次排查时先手动连接,把自动触发与导入问题分开检查。
粘贴后提示不是有效链接,怎么办?
重新复制原始文本,删除前面的说明文字与末尾标点。单条分享链接用扫码或剪贴板读取;HTTPS 订阅 URL 放入 Type → Subscribe 的 URL 字段,不要放进服务器 Address。
订阅更新一直超时,要重新添加吗?
先确认当前网络能访问订阅地址。若已有可用连接,可连接后重试;需要通过代理更新时,在 Settings → Subscribe 中检查 Update via Proxy。没有可用连接时,仅启用此项并不能建立可用通道,不必反复新建同一订阅。
显示更新完成,为什么列表还是空的?
先展开对应分组,再核对 URL 是否误填成登录页或说明页。若响应是网页、空内容或客户端无法解析的格式,向自己的服务方确认订阅返回内容与账户状态;不要把网页地址改几个字符后反复试填。
列表有服务器,但连接后打不开网页?
检查 Home 当前选中的条目,再查看 Global Routing 是否为 Direct。用 Connectivity Test 区分连接故障与规则问题;手填条目优先核对端口、认证、TLS 和传输参数,订阅条目则先完成一次来源更新。
把订阅链接发给别人排查过,还能继续用吗?
在自己的服务管理页面重置订阅凭据,然后编辑 Shadowrocket 中对应 Subscribe 的 URL 并更新。旧地址是否立即失效由服务端决定。后续截图遮住完整 URL 与二维码,错误信息可单独记录。
判断完成的标准应分三层:来源保存成功、条目解析正确、实际连接可用。逐层检查能减少重复导入,也能避免把服务器故障、订阅地址失效和规则分流问题混成同一个问题。