教程 / 快速入门 / 扫码添加单个节点(Android / iPhone)
入门 iOSAndroid 二维码单节点入门

扫码添加单个节点(Android / iPhone)

在 Terraka 手机版扫描节点分享二维码,表单自动填好后保存;Windows 版没有扫码,可改用粘贴或手填。

2026.10.22 5 min read 7 sections

节点的分享二维码,里面其实就是一条分享链接(比如 vless://…)。在 Terraka 手机版里扫一下,App 会认出协议、把服务器地址、端口、密码这些字段预先填进表单,你检查一遍再点「添加」就行,不用手抄。这篇讲 Android 和 iPhone 上的完整流程,以及电脑上的替代办法。

01 扫码能导入什么

扫码适合单个节点。能识别的分享链接:

扫到的如果是一条订阅地址(https:// 开头的订阅 URL),会按订阅处理,后面的步骤见导入 Clash 订阅与配置。不同协议的区别,见博客主流代理协议横向对比。

节点来自你自己

Terraka 是客户端,不提供节点。二维码来自你的订阅方、你自建的服务器,或者信任的人分享给你的节点。

02 扫码按钮在哪

  1. 打开「添加节点」

    点首页左上角的 ☰ 打开侧边菜单,选「添加节点」。还没有任何配置时,首页中间也有一张「添加节点」卡片。

  2. 找到粘贴框右侧的扫码图标

    页面最上方的粘贴框右边有两个小图标:「粘贴」和「扫码」。点「扫码」图标,进入扫码页。

添加订阅时,订阅表单「URL」那一行右侧也有一个扫码图标,扫到的内容会直接填进 URL 栏。

03 相机权限

第一次点扫码时,系统会询问是否允许 Terraka 使用相机,选允许。

如果之前点了拒绝,再进扫码页会弹出「需要相机权限」:「请授权相机权限以扫描二维码」。点「打开设置」会跳到系统里 Terraka 的设置页,把相机打开后回到 App 再点一次扫码;点「取消」只关闭这个提示,相机仍然不可用。

04 扫码并保存

  1. 对准二维码

    扫码页标题是「扫描二维码」,屏幕中间有一个方框,底部提示「将二维码对准框内进行扫描」。光线暗时点右上角的闪光灯图标;不扫了就点左上角的 ✕。

  2. 自动返回并识别

    扫到后自动回到「添加节点」页,链接已经填进粘贴框。下方显示「已识别」和协议,例如「VLESS 分享链接」,并提示「我们会为你预填 VLESS。」

  3. 点「使用此项」

    打开这个协议的节点表单,服务器、端口、密码 / UUID 等字段已经按链接填好。

  4. 检查后点「添加」

    核对一遍,尤其是节点名称。点「添加」,提示「添加成功」。

识别不出来时

如果粘贴框下面提示「无法识别的内容……」,说明二维码里不是上面列出的那几种链接,或者链接本身不完整。这种情况可以向分享方要一条文本链接,或者在「添加单个节点」里选协议手填。

05 节点保存在哪、怎么用上

扫码或手填的单个节点,都保存在这台设备上的本地配置里(默认名「本地节点」),和订阅分开存放,订阅更新不会覆盖它们。

再扫第二个、第三个节点,会继续加进同一份本地配置。节点名称不能重复,重名时会提示「节点名称已存在,请使用其他名称」,改个名字再保存。

本地配置只在这台手机上,不会同步到别的设备。

06 电脑上怎么加

扫码只在 Android 和 iPhone 上有,Windows 版没有扫码入口。在电脑上添加单个节点有两种办法,入口同样是「添加节点」页(Windows 在窗口顶部导航栏):

在 Mac 上,同样建议直接粘贴分享链接。

07 常见问题

扫码页一片黑,什么都看不到

多半是相机权限没开。到系统设置里找到 Terraka,打开相机权限后重新进扫码页。

扫完表单里有字段是空的

分享链接里本来就没带这些参数时,表单会留空或用默认值。照分享方给的信息补齐再保存。

一次能扫一整个订阅吗?

可以扫订阅地址的二维码,但它会按订阅导入(批量拉取所有节点),不是加进本地配置。详见导入 Clash 订阅与配置。

加好的节点连上后流量怎么走?

取决于首页的「连接模式」,见理解代理模式:全局 / 规则 / 直连。

还没装 Terraka?到下载页获取 Android 版,或按下载页的说明在 iPhone 上安装。

这篇有帮助吗? 反馈会直接发到开发者邮箱——一句话也行。