Karing 配置文件怎么导入和排查？
简答：有 https 订阅链接，就在 Karing 的“添加配置”中粘贴；有 .yaml 或 .json 文件，就选择本地配置文件导入，但本地文件无法自动更新；看到 config.json 时，先确认它是否属于服务商的 Karing 应用配置，不要把它当成普通节点订阅。
定义：Karing 配置文件是供应用读取节点、协议、规则或 DNS 等连接信息的订阅链接、配置文本或本地文件；服务商使用的 config.json 则是另一类应用级配置。
先用 10 秒判断你手里的配置是什么
先看来源，不要急着改文件：有 https:// 开头的完整地址，通常应按订阅链接添加；有已经保存到设备的 .yaml、.yml 或 .json 文件，应走本地配置文件导入；看到 config.json，则要先判断它是不是服务商给 Karing 使用的应用配置。
| 你手里的内容 | 在 Karing 中应选的入口 | 更新特点 | 适合场景 |
|---|---|---|---|
| 完整订阅链接 | 添加配置链接 | 可在配置管理中再次更新；具体是否能更新取决于链接仍可访问且返回内容有效 | 节点列表会变化，或需要从远程重新获取配置 |
| 本地 YAML、YML 或 JSON 文件 | 导入配置文件 | 官方说明此类文件无法更新 | 一次性导入已经保存的配置 |
| 复制好的配置链接或完整配置文本 | 从剪贴板导入，或粘贴到添加配置链接 | 取决于剪贴板内容是否完整 | 设备之间临时转移配置 |
| 配置链接二维码 | 扫描二维码 | 二维码内容失效或被截断时会失败 | 另一台设备展示配置链接时使用 |
config.json | 通常不是普通用户的节点导入入口 | 属于服务商与 Karing 的应用配置体系 | 服务商自定义 DNS、延迟检测等应用设置 |
Karing 官方“添加配置”页面列出了 Clash/Stash、V2Ray、sing-box、Shadowsocks、Sub 和 GitHub 等配置链接或部分配置内容，并提供剪贴板、本地文件、二维码、备份与同步等入口。可先查看Karing 官方添加配置文档确认当前支持范围。
Karing 配置文件最快导入步骤
- 先保护原始内容：不要把订阅链接、UUID、密码、私钥或完整配置公开发到群组、论坛和在线解析站。需要编辑时，先在本地复制一份副本。
- 进入添加配置：Karing 官方快速使用教程给出的通用入口是打开应用左上角设置按钮，再进入“添加配置”；桌面端也可从应用工具栏进入“添加配置”。如果当前平台界面没有完全相同的按钮名称，应优先使用应用中可见的“添加配置”入口，不要根据其他平台截图猜菜单。
- 按来源选择方式：有远程地址就选择“添加配置链接”；有本地文件就选择“导入配置文件”；复制了完整文本可用剪贴板导入；有配置链接二维码则选择扫描二维码。
- 等待配置出现：看到配置名称只代表导入记录已建立，还要进入配置列表确认是否有节点。
- 选择节点并连接：返回主屏，点击当前服务器名称进入选择列表；Karing 官方教程说明可进行延时检测，再选择节点或使用自动选择，最后打开连接开关。
- 分开确认三种状态：配置已添加、节点列表可见、连接可以建立，这三者不是同一个结果。只看到配置名称而没有节点时，应先查订阅返回内容或文件格式。
官方快速使用教程还列出 Windows、macOS、iOS、Android 等平台的系统要求和通用添加流程；但不同版本的按钮布局可能不同。需要备份时，可使用 Karing 官方添加配置页列出的备份与同步功能，包括 iCloud、WebDAV、局域网同步和导入导出。
Windows、macOS、Android、iOS 入口怎么对照
Karing 官方文档没有为每个平台都给出一套完全独立的文件导入菜单路径，因此以下表格只区分已能核对的入口方式，不把未经官方页面明确说明的按钮位置写成固定路径。
| 平台 | 订阅链接 | 本地文件 | 剪贴板或二维码 | 找不到入口时 |
|---|---|---|---|---|
| Windows | 从“添加配置”进入链接添加 | 从“添加配置”选择导入配置文件 | 使用剪贴板导入或扫描二维码 | 回到主屏或工具栏查找“添加配置” |
| macOS | 使用 Karing 的添加配置入口 | 使用本地配置文件导入 | 使用剪贴板或二维码入口 | 不要套用 iOS 截图，按当前版本主屏工具栏查找 |
| Android | 从应用的添加配置入口粘贴链接 | 使用导入配置文件 | 使用剪贴板或扫描配置链接二维码 | 先回到主屏或设置区域查找“添加配置” |
| iOS | 从应用的添加配置入口粘贴链接 | 使用文件导入入口 | 使用剪贴板或扫描二维码 | 按系统文件选择器授权读取本地文件 |
如果某个平台没有显示某个入口，先更新到当前可用版本并重新打开应用；不要把“本地文件无法自动更新”误认为导入失败。Karing 官方页面确认，本地文件属于一次性导入方式，而配置列表中的远程配置可以进入配置管理执行更新。
YAML、JSON 到底该选哪个？附脱敏结构示例
扩展名不是唯一判断标准。应先看文件的实际格式和来源：Clash/Stash 配置通常以 YAML 或 JSON 表示，sing-box 通常以 JSON 表示，V2Ray、Shadowsocks 和 Sub 也可能以链接或特定文本形式出现。Karing 官方快速教程列出这些配置类型，但并没有把所有服务商导出的文件统一规定为某一种扩展名。
下面是一个仅用于核对字段层级的脱敏骨架，不是可直接连接的完整配置，也没有填入真实服务器、端口、UUID、密码或代理组。它只帮助你判断 YAML 是否具备常见的“节点—代理组—规则”层次；实际字段必须以配置提供方和 Karing 当前支持格式为准。
proxies: [ { name: "示例节点", type: "协议类型", server: "example.invalid", port: 443, uuid: "请替换为真实值" } ]
proxy-groups: [ { name: "代理选择", type: "select", proxies: ["示例节点"] } ]
rules: [ "MATCH,代理选择" ]
- 节点字段：至少要能对应服务器地址、端口、协议类型，以及该协议要求的认证字段。
- 引用关系：代理组引用的节点名称必须与节点定义中的名称一致；规则引用的策略组也必须真实存在。
- 格式检查：JSON 要检查括号和引号是否成对；YAML 要检查缩进，不要混入制表符。
- 不要把骨架当成成品：缺少协议专属字段、TLS 参数或认证信息时，文件可能被识别但无法连接。
- 本地检查优先：使用本地代码编辑器或本地语法检查功能，不要把含有订阅链接、UUID、密码和私钥的文件粘贴到第三方在线校验站。
config.json、base.json、notice.json 有什么区别
config.json 不等于普通节点订阅。Karing 官方文档将它定义为服务商自定义的 Karing 应用配置，可包含 DNS、延迟检测地址、FakeIP 等相关设置；当用户完成服务商与 Karing 的绑定、基础配置加载完成后，应用会请求对应的 config.json，并覆盖相应的默认配置项。普通用户手里只有节点订阅时，通常不需要自行创建或编辑它。详情可查看Karing 官方 config.json 说明。
服务商管理文档把三类文件分开说明：base.json 用于服务商基础信息，config.json 用于应用配置，notice.json 用于应用通知。这个体系面向服务商或 Karing 集成维护者，并不是普通用户导入 YAML、JSON 节点文件的替代入口。可参考Karing 官方服务商管理文档。
因此，看到文件名时可以这样判断：节点订阅文件用于导入配置；服务商的 config.json 用于应用层设置；base.json 和 notice.json 也属于服务商集成体系。不要因为文件后缀都是 JSON，就把它们当作同一种配置。
导入失败、节点为空和连接不上怎么排查
| 报错或现象 | 更可能的原因 | 处理步骤 |
|---|---|---|
Connection reset by peer 或 Connection refused | 订阅请求可能被拦截或远端拒绝 | 确认链接仍有效；在 Karing 中启用可用的代理下载配置选项后重试，或向配置提供方确认链接状态。 |
http statusCode: 404 | 订阅地址不存在或路径已变化 | 重新获取完整订阅链接，不要手动猜测或拼接地址。 |
http statusCode: 403 | 请求被服务端拒绝 | 确认订阅权限和链接来源，必要时向配置提供方申请新的链接。 |
Failed host lookup | 订阅域名解析失败 | 检查当前网络和域名解析；如本地网络无法访问订阅地址，先更换网络环境后重试。 |
http response is empty | 服务端返回空内容 | 重新复制链接并确认账号权限；若仍为空，联系配置提供方核对订阅内容。 |
| 显示“无可用服务器” | 返回格式不匹配、User-Agent 不适配或内容没有节点 | 确认配置类型和链接来源；Karing 官方 FAQ 建议在不同服务商场景下尝试更换 User-Agent。 |
| 配置已出现但节点为空 | 返回的是空内容、登录页 HTML，或文件结构不受支持 | 在本地保存返回内容查看开头；如果是 HTML 登录页，不要当作 YAML/JSON 导入。 |
| 有节点但连接失败 | 节点本身不可用、系统权限未授予或模式设置不合适 | 先换同一配置中的其他节点，再确认系统 VPN 权限；一次只修改一个变量。 |
这些报错与处理方向可在Karing 官方常见问题中核对。排查顺序建议固定为：先验证链接或文件，再确认 Karing 能否识别，再确认节点列表，最后检查系统权限、代理模式和 DNS。不要同时改订阅、节点、DNS 和规则，否则很难判断真正原因。
导入后如何更新、备份和调整 DNS
本地配置文件无法自动更新，这是 Karing 官方添加配置页面明确写出的限制；需要更新时，应重新导入新文件。远程配置则可在配置管理中执行更新，但更新前应确认原始链接仍然有效，并保留必要的本地备份。
备份文件和订阅链接可能包含认证信息。Karing 官方添加配置文档列出 iCloud、WebDAV、局域网同步及导入导出等备份与同步方式；选择任何方式前，都应确认同步目标是自己的可信设备或存储位置。
DNS 设置不要一开始就大幅修改。Karing 官方 DNS 文档说明，DNS 分流会根据分流规则使用对应 DNS，FakeIP 是独立选项；通过代理服务器解析 DNS 还取决于代理服务器的支持程度，某些情况下可能影响性能。遇到域名打不开或部分应用异常时，先记录当前配置，再逐项关闭自定义 DNS、FakeIP 或 DNS 分流进行对比。具体字段可查看Karing 官方 DNS 文档。
如果你还要继续处理节点选择和连接状态，可阅读站内的Karing 配置教程：订阅导入、节点选择与连接排查；本文重点是文件类型、入口区分和配置结构，站内另一页重点是导入后连接排查，避免重复。
结论：不同配置文件应该怎么选
- 有长期使用的
https地址：优先添加订阅链接，并在配置管理中按需更新。 - 只有一个
.yaml、.yml或.json文件：选择本地配置文件导入，但它不会自动更新。 - 配置内容在电脑或聊天窗口中：复制完整内容后使用剪贴板导入，先确认没有混入说明文字。
- 看到
config.json：先判断它是否属于服务商与 Karing 的应用集成配置，普通用户通常不需要修改。 - 导入失败：按报错文案检查链接状态、返回内容、格式、节点和系统权限，不要先在线上传完整配置。
常见问题
Karing 本地配置文件为什么不会自动更新？
因为 Karing 官方添加配置文档明确将本地文件列为无法更新的导入类型。需要更新时，重新导入新文件；如果需要从远程获取变化，应使用仍然有效的订阅链接。
Karing 配置文件应该用 YAML 还是 JSON？
不能只看扩展名。先按配置来源判断：Clash/Stash 常见 YAML 或 JSON，sing-box 常见 JSON，其他类型也可能通过链接或文本导入。最终以配置提供方导出的实际格式和 Karing 当前支持范围为准。
config.json 是不是 Karing 的节点订阅文件？
通常不是。Karing 官方将 config.json 定义为服务商自定义的应用配置，可涉及 DNS、延迟检测地址等；普通用户导入节点时，一般使用订阅链接或本地配置文件。
为什么配置已经添加，但节点列表是空的？
先检查订阅返回内容是否为空、是否过期，或是否返回了需要登录的 HTML 页面；本地文件则检查 YAML 缩进、JSON 括号和节点字段。配置名称出现不代表节点内容一定有效。
导入时出现 404、403 或 Failed host lookup 怎么办？
404 通常表示订阅地址不存在，403 表示请求被拒绝，Failed host lookup 表示订阅域名解析失败。重新确认完整链接和权限，并按 Karing 官方 FAQ 的对应建议逐项排查，不要直接修改文件后缀。
备份 Karing 配置时需要注意什么？
订阅链接、UUID、密码和私钥都可能包含敏感信息。使用 iCloud、WebDAV、局域网同步或导入导出前，应确认目标设备和存储位置可信，不要把原始文件上传到公开或不明的在线工具。
相关阅读
参考资料
- 添加配置 | Karing 官方文档（karing.app）
- 快速使用教程 | Karing 官方文档（karing.app）
- APP配置文件 config.json | Karing 官方文档（karing.app）
- 服务商管理 | Karing 官方文档（karing.app）
- 常见问题 | Karing 官方文档（karing.app）
- DNS | Karing 官方文档（karing.app）