节点的分享二维码,里面其实就是一条分享链接(比如 vless://…)。在 Terraka 手机版里扫一下,App 会认出协议、把服务器地址、端口、密码这些字段预先填进表单,你检查一遍再点「添加」就行,不用手抄。这篇讲 Android 和 iPhone 上的完整流程,以及电脑上的替代办法。
01 扫码能导入什么
扫码适合单个节点。能识别的分享链接:
- Shadowsocks(
ss://) - VMess(
vmess://) - VLESS(
vless://) - Trojan(
trojan://) - Hysteria2(
hysteria2://或hy2://) - SOCKS5(
socks5://或socks://) - HTTP(
http://用户名:密码@地址:端口这种带账号的形式)
扫到的如果是一条订阅地址(https:// 开头的订阅 URL),会按订阅处理,后面的步骤见导入 Clash 订阅与配置。不同协议的区别,见博客主流代理协议横向对比。
节点来自你自己
Terraka 是客户端,不提供节点。二维码来自你的订阅方、你自建的服务器,或者信任的人分享给你的节点。
02 扫码按钮在哪
- 打开「添加节点」
点首页左上角的 ☰ 打开侧边菜单,选「添加节点」。还没有任何配置时,首页中间也有一张「添加节点」卡片。
- 找到粘贴框右侧的扫码图标
页面最上方的粘贴框右边有两个小图标:「粘贴」和「扫码」。点「扫码」图标,进入扫码页。
添加订阅时,订阅表单「URL」那一行右侧也有一个扫码图标,扫到的内容会直接填进 URL 栏。
03 相机权限
第一次点扫码时,系统会询问是否允许 Terraka 使用相机,选允许。
如果之前点了拒绝,再进扫码页会弹出「需要相机权限」:「请授权相机权限以扫描二维码」。点「打开设置」会跳到系统里 Terraka 的设置页,把相机打开后回到 App 再点一次扫码;点「取消」只关闭这个提示,相机仍然不可用。
04 扫码并保存
- 对准二维码
扫码页标题是「扫描二维码」,屏幕中间有一个方框,底部提示「将二维码对准框内进行扫描」。光线暗时点右上角的闪光灯图标;不扫了就点左上角的 ✕。
- 自动返回并识别
扫到后自动回到「添加节点」页,链接已经填进粘贴框。下方显示「已识别」和协议,例如「VLESS 分享链接」,并提示「我们会为你预填 VLESS。」
- 点「使用此项」
打开这个协议的节点表单,服务器、端口、密码 / UUID 等字段已经按链接填好。
- 检查后点「添加」
核对一遍,尤其是节点名称。点「添加」,提示「添加成功」。
识别不出来时
如果粘贴框下面提示「无法识别的内容……」,说明二维码里不是上面列出的那几种链接,或者链接本身不完整。这种情况可以向分享方要一条文本链接,或者在「添加单个节点」里选协议手填。
05 节点保存在哪、怎么用上
扫码或手填的单个节点,都保存在这台设备上的本地配置里(默认名「本地节点」),和订阅分开存放,订阅更新不会覆盖它们。
- 如果这是你导入的第一份配置,它会自动成为当前配置,回到首页就能在节点列表里看到。
- 如果你正在用某个订阅,点首页「当前订阅」那一行右侧的「切换」,在列表里选这份本地配置。
再扫第二个、第三个节点,会继续加进同一份本地配置。节点名称不能重复,重名时会提示「节点名称已存在,请使用其他名称」,改个名字再保存。
本地配置只在这台手机上,不会同步到别的设备。
06 电脑上怎么加
扫码只在 Android 和 iPhone 上有,Windows 版没有扫码入口。在电脑上添加单个节点有两种办法,入口同样是「添加节点」页(Windows 在窗口顶部导航栏):
- 粘贴分享链接:向分享方要文本形式的链接(
ss://、vless://等),粘贴进顶部的粘贴框,流程和上面第 04 节第 2 步之后一样。 - 手填:在「添加单个节点」分区里选协议:Shadowsocks、Trojan、VMess、VLESS、Hysteria2、SOCKS5、HTTP,按服务器信息逐项填写后点「添加」。
在 Mac 上,同样建议直接粘贴分享链接。
07 常见问题
扫码页一片黑,什么都看不到
多半是相机权限没开。到系统设置里找到 Terraka,打开相机权限后重新进扫码页。
扫完表单里有字段是空的
分享链接里本来就没带这些参数时,表单会留空或用默认值。照分享方给的信息补齐再保存。
一次能扫一整个订阅吗?
可以扫订阅地址的二维码,但它会按订阅导入(批量拉取所有节点),不是加进本地配置。详见导入 Clash 订阅与配置。
加好的节点连上后流量怎么走?
取决于首页的「连接模式」,见理解代理模式:全局 / 规则 / 直连。
还没装 Terraka?到下载页获取 Android 版,或按下载页的说明在 iPhone 上安装。