教程 / 快速入门 / 导入 Clash 订阅与配置
入门 iOSAndroidmacOSWindows Clash订阅入门

导入 Clash 订阅与配置

已有 Clash 订阅链接或 Clash 配置内容?在 Terraka 里粘贴即可导入,可保存多份配置随时切换。

2026.10.22 6 min read 6 sections

这篇写给已经有 Clash 订阅或 Clash 配置的人:怎么把它导进 Terraka,导入多份以后怎么切换。Terraka 的内核是 mihomo(Clash.Meta),Clash 格式的订阅和配置可以直接用,不需要先转格式。

01 导入前先确认手上是什么

Terraka 只是客户端,不提供节点。节点来自你自己的订阅提供方,常见的是下面两种:

目前不能从文件选择 .yaml

App 里没有「从本地文件导入」的入口。手上只有 .yaml 文件的话,用文本编辑器打开,全选、复制,再按下面的「方式二」粘贴进去。

订阅链接是怎么工作的、Clash 和 Shadowrocket 两种格式有什么区别,见博客订阅链接的工作原理。

02 打开「添加节点」页

导入都在 添加节点 页里完成,入口随设备不同:

页面最上方是一个粘贴框,提示「粘贴任何内容——我们会自动识别并打开对应表单」。下面是「添加订阅」(Clash、Shadowrocket 两种格式)和「添加单个节点」两个分区。窗口宽时这两个分区在左栏,粘贴框在右侧。

03 方式一:粘贴 Clash 订阅 URL

  1. 复制订阅链接

    从订阅方那里复制 Clash 订阅 URL,以 http:// 或 https:// 开头。

  2. 粘贴到顶部的粘贴框

    点输入框右侧的「粘贴」图标读取剪贴板,也可以长按或右键粘贴。

  3. 等它识别格式

    App 会先请求一次这个地址来判断格式,按钮显示「识别中…」。识别完成后出现「已识别 · 订阅链接」,下面一行是格式和节点数,例如 Clash · 36 个节点。

  4. 点「使用此项」

    打开订阅表单,URL 已经填好,「备注名称」会预填链接的域名。给它起一个好认的名字,「订阅格式」显示 Clash。

  5. 点「添加」

    App 拉取订阅,并把节点保存在本机。手机上提示「添加成功」;宽窗口里会显示「已添加到 Terraka」和节点数,可以点「继续添加」再导一份,或点「完成」回首页。

也可以不用粘贴框:直接点「添加订阅」下的 Clash 卡片,在表单里手动填「备注名称」和 URL。这种方式不会先识别格式,按 Clash 处理。

如果识别出的格式不对(例如订阅方对 Clash 请求返回了别的格式),点识别结果右侧的「切换格式」图标,在 Clash 和 Shadowrocket 之间切换,再点「使用此项」。Shadowrocket 格式的订阅也能导入,转换成 Clash 配置是在本机完成的。什么时候才需要转换格式,见订阅转换是什么。

04 方式二:直接粘贴配置内容

适合手上只有 YAML 文本或 .yaml 文件、没有订阅 URL 的情况。

  1. 复制整段配置

    打开 .yaml 文件,全选并复制。内容里至少要有 proxies、proxy-groups、rules 之一。

  2. 粘贴到顶部的粘贴框

    和方式一是同一个框。识别成功后显示「已识别 · 订阅内容」,下面一行是 Clash · 直接粘贴。

  3. 点「使用此项」

    App 直接导入这段内容,不需要联网拉取。手机上提示「粘贴 · xxxxxx 已导入」并回到上一页;宽窗口里显示「已添加到 Terraka」。

这样导入的配置自动命名为「粘贴 · 」加 6 位字符。同一段内容重复粘贴只保存一份。

粘贴的内容不会跟着订阅变

粘贴导入的是当时那一份内容,没有订阅地址,所以这份配置没有「更新」按钮。订阅方换了节点,要重新复制、重新粘贴;能拿到订阅 URL 的话,优先用方式一。

05 管理多份配置、切换和更新

可以导入多份配置,比如两个订阅加一段粘贴的配置。第一份导入的配置会自动成为当前配置;之后导入的不会自动切过去。

首页「当前订阅: 名称」这一行右侧有几个按钮(手机上只显示图标):

配置列表里每一份下面有三个图标:刷新(重新拉取该订阅,只有 URL 导入的才有)、编辑(改备注名称或订阅地址)、删除(会先确认「确认删除该配置项?」)。右上角的「+」可以接着添加。

同一个订阅地址再导入一次,会替换原来那份,而不是多出一份。

Windows 上还可以不打开窗口切换:点右下角托盘图标,菜单里「配置管理」一栏列出所有配置,勾选哪份就用哪份。

导入以后,连接时走不走节点、怎么分流,取决于首页的「连接模式」,见理解代理模式:全局 / 规则 / 直连。

06 常见问题

从 Clash for Windows 或别的 Clash 客户端搬过来,要重新配置吗?

不用重写。订阅 URL 直接按方式一粘贴;自己改过的配置文件,打开后复制全文,按方式二粘贴。旧客户端停更的背景见Clash for Windows 删库之后,现在用什么。

提示「URL 内容既不是 Clash 也不是 Shadowrocket 格式」

App 请求了这个地址,但返回的内容两种格式都对不上。先确认链接复制完整、没有多余空格;再确认订阅方给的是不是 Clash 或 Shadowrocket 订阅(有些后台给的是网页地址,不是订阅地址)。如果提示的是网络类错误,检查当前网络能不能打开这个地址。

提示「配置名称”…”已存在」

备注名称和已有配置重名了,换一个名字再点「添加」。

只想加一两个单独的节点

用「添加单个节点」分区手填,或者在手机上扫分享二维码,见扫码添加单个节点。

还没装 Terraka?到下载页获取最新版。

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