代理客户端 · Karing

Karing 使用教程:配置导入、分流与备份

Karing 能管理多种格式的配置,并用应用自己的设置组织分流。已有复杂 Clash YAML 时,导入后除了看节点列表,还要检查原来的策略组、DNS 和规则是否保留。

Android / 桌面正式版 ↗iPhone / iPad App Store ↗官方资料验证连接是否生效
WindowsmacOSAndroidiOSLinux

先看现有配置是否适合 Karing

多个设备需要管理不同来源的配置时,可以考虑 Karing。它能读取多种输入,但复杂 Clash 配置中的规则和 DNS,迁移后要按官方兼容表核对。

需要提前区分“读得懂配置”与“完全复现行为”。官方兼容说明专门列出了 Clash 功能差异,例如部分策略组、DNS 和规则能力由 Karing 自身设置管理。迁移复杂配置时,应逐项验证域名分流、局域网访问和策略组,不要因为节点全部出现就认定迁移完成。

如果重点是保留 mihomo 的完整 YAML 配置和面板操作,可比较 Clash Mi;如果想维护原生内核配置,则阅读 sing-box 入门指南。Karing 应用不提供现成的远端服务,仍需准备自己的可用配置。

官方下载与系统要求

桌面和安卓设备从 Karing 官方稳定发布 选择安装资产;苹果移动设备使用 官方 App Store 页面。官方入门教程说明苹果商店下载需要非中国大陆地区账号,实际能否安装还取决于商店地区、系统版本及当前上架状态。

Karing 官方列出的系统要求与安装包方向
平台选择与要求
WindowsWindows 10 或更新,64 位;通常选择 windows_x64.exe 安装包。
macOSmacOS 12 或更新,支持 Intel 与 Apple Silicon;当前发布提供 universal DMG/PKG。
AndroidAndroid 8 或更新;按 arm64-v8a、armeabi-v7a 或本次发布的 ARM 通用包选择。
iOSiOS 15 或更新;稳定使用优先选择 App Store。
Linux64 位;官方特别注明当前 deb 包要求 glibc 2.38 或更新。

包名和系统门槛会随发布调整,下载前再查看发布说明。不要将 Linux 的 deb 要求机械套用到其他发行格式。

本文核对的 GitHub 正式发行是 1.2.26.2930(2026 年 11 月 13 日发布),并非最新正式版。美区 App Store 本轮核对仍为 1.2.25.2802,不要混用渠道版本。2930 的 GitHub 资产包括 Windows x64 EXE/ZIP、macOS universal DMG/PKG、Linux amd64 DEB/RPM/AppImage 和 Android ARM 系列 APK;以设备架构选包,不把客户端版本当成捆绑内核版本。

安装和首次连接授权

  1. Windows 运行对应的官方安装包;macOS 打开对应 DMG 或 PKG 完成安装;Android 打开 APK,按系统提示确认安装来源。
  2. Linux 先核对 CPU 架构和发行版,再选择 deb、rpm 或 AppImage。若提示 GLIBC_2.38 缺失,应处理系统兼容性,不要覆盖系统的 libc 文件。
  3. 启动 Karing,确认配置列表与连接状态正常显示。首次排查阶段保留默认分流,先不叠加其他客户端和复杂规则。
  4. 手机点击连接时,按系统提示允许建立 VPN 配置。桌面涉及虚拟网卡时,按应用和系统说明提供所需权限。

App Store 与测试渠道的版本可能不同,初次使用优先稳定版本。遇到系统拦截时先重新确认下载来源及发布说明;无需为了完成安装而长期关闭设备的安全设置。

添加配置并选择服务器

  1. 按官方快速教程进入设置中的“添加配置”,选择“添加配置链接”,粘贴自己的完整配置链接。也可使用应用提供的导入或扫码功能。
  2. 给配置起一个能区分来源的名称,执行添加,并确认下载或解析成功。不要将配置请求失败误判为节点无法连接。
  3. 返回主屏,点击当前服务器名称打开选择列表,确认准备使用的节点。初次验证可手动选择一个明确的节点。
  4. 启动连接,观察状态和错误提示,再用浏览器发起一次真实访问。

配置链接一般包含私密令牌,不要在共享截图或在线转换工具中公开。应用支持多种订阅格式,但订阅服务器可能按 User-Agent 返回不同内容;格式不匹配时应核对来源说明,避免盲目修改链接参数。

1.2.26.2925:订阅中的 DNS 设置

1.2.26.2925 发行说明增加通过 HTTPS 订阅 URL 配置 DNS 的支持,列出 URL 的 outbound-dns 参数,以及 Clash YAML 的 dns → proxy-server-nameserver。这些是配置入口,不代表导入后所有域名都使用同一个 DNS,也不代表订阅传输使用 HTTPS 就自动启用了加密 DNS。

已有订阅不必为升级手工拼接参数。先备份原配置,向提供方核对它给出的 DNS 设置;如确需更改,保留原 URL 与参数编码,一次只改一处,再核对节点域名解析、直连和代理目标。出现异常时恢复原配置并记录脱敏错误,不将带凭据的订阅地址交给公开转换服务。商店版仍以对应渠道已发布功能为准。

1.2.26.2930:转换字段与 WireGuard 编辑

该版修复协议转换遗漏部分字段的问题,增加 hy2: obfs - gecko 转换支持;新建或手动编辑的 WireGuard 配置改用 endpoint 结构保存,并支持编辑 peers。它不是“全部旧配置已自动迁移”的承诺,也不能证明所有协议转换结果完全一致。

修改前保存原配置与 ZIP 备份;转换后核对传输、TLS 等字段。编辑 WireGuard 时,保存后重新打开条目,对照 endpoint 与 peers,再验证原来的连接场景。若字段缺失,用自己的备份恢复,不猜填密钥。以上为发行说明对应的核对步骤,本站未运行该版做设备实测。

检查迁移后的分流和 DNS

先访问一个 HTTPS 页面,再测试原来出问题的应用和需要直连的局域网资源。若结果不同,从对应连接记录里查看使用的规则和节点。

  1. 打开实际页面后,在连接或统计视图中寻找该域名请求,查看使用的节点与规则。
  2. 页面失败但有连接记录时,检查分流目的地和远端错误;没有相应请求时,检查应用是否进入客户端以及 DNS 是否工作。
  3. 分别比较 Wi-Fi、移动数据和后台运行,保存一次正常与异常请求的日志,帮助缩小问题范围。

系统代理与 TUN 是接入流量的方式,规则模式与全局模式决定如何选择出站,它们不是同一组开关。Karing 的苹果平台实现有特殊限制,关闭 TUN 后不要直接假定仍可接管全设备流量,需按官方 FAQ 检查接入方法。

请求进入客户端后匹配规则,规则引用策略组,策略组决定直连或远端节点。修改其他组不会改变这条请求。
迁移后沿连接记录核对规则、策略和出站,不能只看节点列表是否齐全。

配置下载与应用连接报错

  • Failed host lookup:配置链接域名解析失败,先检查当前网络与 DNS,确认同一域名在浏览器是否能访问。
  • HTTP 403、404 或空响应:分别检查下载权限、链接有效性和服务器返回内容。这些错误发生在配置获取阶段,反复切换节点协议通常无法解决。
  • No server available:确认实际获取到了受支持的配置,并按配置来源文档核对 User-Agent,而不是只看链接能否在网页中打开。
  • 仅一个应用失败:先查看该域名的连接记录与分流结果;没有记录时再检查 DNS、应用接入方式和系统限制。
  • 安卓后台断开:检查 Karing 的电池策略与后台权限,通过同一请求在前台、锁屏后的结果对比确认。

每次只改一个设置,并记下改动前的值。需要更广泛的检查时,可以接着使用 本站故障排查,避免同时更改 DNS、节点和全部分流规则导致无法追踪原因。

文件备份与跨设备同步

Karing 支持文件、WebDAV、iCloud 和局域网同步,平台范围各有不同。先保存本地 ZIP,再选择适合迁移设备的方式,具体入口见官方备份文档。

文件导入导出位于设置中的备份与同步功能;局域网扫码同步的导入端有平台限制,官方文档标明仅支持 iOS、Android 手机端。电脑之间迁移可优先采用文件或 WebDAV,不应假定每台设备都有同样的扫码入口。

同步的是配置,不是所有设备上的网络条件。新设备恢复后仍要检查系统 VPN 权限、监听端口、DNS 和局域网访问。更新应用前阅读发布说明,更新后重新验证实际访问;iOS 使用系统商店更新,其他平台维持原来的官方渠道。备份中可能含订阅和连接凭据,不要把 ZIP 留在公开共享目录。

1.2.26.2923 升级检查:发行说明修复了排除路由等位置可添加无效 IP/CIDR、Mieru/Naive/Tailscale/Tor 组件启动错误导致 VPN 连接失败,以及若干内核 panic。先保存 ZIP 备份,升级后核对原有排除路由的地址格式,再验证直连目标和代理目标;已有错误条目不应假定会被自动纠正。

1.2.26.2923 的发行说明还注明默认关闭“TLS:跳过证书验证”。如果升级后某个节点出现证书错误,先核设备时间、服务器名称和证书配置,并联系提供方确认;不要把开启跳过验证当作通用恢复步骤。排查期间保持证书验证,保存脱敏错误,必要时使用自己已验证可用的配置。上述是发行说明和操作建议,不是本站对全部协议的实测结论。

1.2.26.2927:XHTTP 保存后要重新核对

2927 发行说明修复核心依赖错误、XHTTP 的 uTLS 转换错误,以及保存 XHTTP 配置时部分数据丢失的问题。使用相关配置时,先保存可读的 ZIP 备份和原配置,升级后重新打开已保存条目,逐项对照原来的传输及 TLS 设置,再测试实际连接;不要把一次保存成功当作字段完整或网络可用的证明。

此次修复不代表能自动找回此前已经丢失的字段。发现内容缺失时,用自己的备份或提供方原配置恢复,再核对保存后的内容;不要猜测凭据或为排错关闭证书验证。以上是基于发行说明的验证建议,不是本站的设备实测。

后续版本提示

本轮已核到后续正式版 1.2.26.2931,其说明修复配置“自动更新”或“更新全部”可能重置部分配置设置的问题,并包含 WireGuard 资源使用等调整。因此不要把本文的 2930 核对版当成最新下载建议;安装前应比较官方后续修复,操作前保存备份、更新后复核设置。该说明未界定所有受影响旧版,不能据此断言原 2927 必然受影响。

常见问题

为什么中国大陆 App Store 找不到 Karing?

官方入门教程说明苹果商店安装需要非中国大陆地区账号。应使用官方 App Store 链接核对当前地区的可用性,不能只凭网页能打开判断可下载。

Linux 安装报 GLIBC_2.38 是什么意思?

官方 README 注明当前 deb 包需要 glibc 2.38 或更新。这个错误通常表示系统运行库太旧,应核对发行版与安装格式,不要手工替换系统 libc。

配置同步成功后,新设备就能直接用吗?

还需要核对该设备的系统授权、网络环境和客户端设置。同步配置不等同于同步 VPN 权限或系统代理状态,恢复后应重新做实际请求验证。

参考资料

下载、系统要求和配置字段以对应版本的官方说明为准。文中的流程图由 AFQKit 绘制。

Karing 1.2.26.2923 官方修复与默认值变化

Clash Mi →多平台 mihomo 图形客户端sing-box →可自定义的代理核心Hiddify →多平台与多种配置格式

先弄清这些概念

返回工具目录 · 按症状排查问题