ClashBar

配置与订阅

数据目录、配置发现规则、导入与订阅维护。

安装并完成首次启动后,配置与订阅是日常维护的核心。ClashBar 将工作文件放在 ~/Library/Application Support/clashbar;配置相关文件位于 …/clashbar/config,并在菜单栏面板的配置菜单中提供切换入口。

面板内选节点、测延迟见 日常使用;按 Wi‑Fi 自动换配置见 SSID 策略

数据目录

路径作用管理建议
config/用户配置(.yaml / .yml)与订阅导入结果建议备份;可手动维护文件名
core/运行时 mihomo 二进制升级/替换前先停止内核
icon/代理组图标磁盘缓存(节点页展示用)由程序维护;可安全删除,会按需重新下载
ui/Mihomo External UI 静态资源(配置了 external-ui / external-ui-url 时由内核生成)由内核维护;清理后重启内核可重新拉取
logs/运行日志与排障输出排障后可按需清理
state/应用运行状态与会话数据建议由程序维护,勿手改

根目录下还可能出现缓存文件(如 cache.db)以及内核生成的 GEO / 规则相关文件。切换内核后若异常,可参考 快速开始 · 切换内核 清理缓存。

维护建议

日常只需维护 config/icon/ui/logs/state/core/ 等优先交给 ClashBar 或内核管理,以降低运行状态不一致风险。

配置发现规则

应用扫描 config/ 时遵循:

  • 仅识别 .yaml / .yml 文件
  • 文件名排序加载
  • 未手动指定当前配置时,默认选中列表中的第一个配置

外部增删改文件后,可使用「重载配置文件」重新扫描列表;运行中内核需「重新加载配置」或重启内核后才会完整应用变更。

导入本地配置

在配置菜单中选择「导入本地配置」,选择有效的 Mihomo YAML。导入后从「切换配置」选中它;启动前会做配置校验。

若校验失败,请查看「日志」中 Mihomo 返回的错误,修正 YAML 后重新加载。缺少 GEO / MMDB 时的处理见 常见问题 · MMDB

导入订阅链接

选择「导入订阅链接」,填写:

  • 订阅链接:可访问的 HTTP 或 HTTPS 配置地址
  • 文件名:可选;留空时根据链接推断 YAML 文件名
  • 自动更新间隔(可选):按小时后台重新拉取

订阅下载完成后会出现在「切换配置」中。可复制原始订阅链接或删除该配置(删除会同时移除订阅元数据)。

切换与刷新

  • 在「切换配置」中选择当前配置
  • 对订阅配置可立即刷新单个来源
  • 「更新订阅链接」可批量更新已保存订阅
  • 「重新加载配置」让运行中内核重读当前配置
  • 「重载配置文件」重新扫描配置目录列表
  • 「在访达中显示」打开配置目录;设置中可打开内核目录

远程更新成功但节点/规则未变时,见 常见问题 · 远程配置更新后未生效

按 Wi‑Fi 切换配置

可开启 Wi‑Fi 自动切换,并将当前 SSID 绑定到某份配置。说明见 SSID 策略

配置中的运行时设置

「设置」标签可覆盖端口、允许局域网、IPv6、TCP 并发、日志级别等。详见 设置与维护

复杂的代理组、规则提供者与 DNS 仍应在 YAML 中维护权威配置。全部能力对照见 功能总览

On this page