Appearance
CatBar 快速配置与详细使用指南
CatBar 是一款开源的 macOS 平台状态栏代理客户端。它的名字直译过来就是“小猫栏”，不仅是因为其图标可爱，更因为它是一款极其轻巧灵动的“菜单栏 (Menu Bar)”工具。
在经典的 ClashX 隐退后，许多开发者开始尝试填补这个生态空缺。CatBar 以极简的代码和原生的 macOS 设计语言，把繁杂的网络配置全部塞进了屏幕顶部的一个小下拉菜单中。它默认对接了 Clash/Mihomo 的核心引擎，使得它在保持“小而美”的同时，依然拥有极为强劲的网络转发性能。
1. 软件下载与安装准备
由于这是一款开源生态内的独立软件，推荐大家直接从开发者的 GitHub 仓库获取。
第一步：获取最新安装包
- Mac 专属：前往发布页 (Releases)，下载对应的
.dmg文件包。 - 注意芯片架构：如果您使用的是 M1/M2/M3 等 Apple Silicon 芯片，请下载标有 ARM/aarch64 的版本；如果您使用的是 Intel 芯片的老款 Mac，请下载 x64 版本。
第二步：安装与应对苹果安全警告
- 双击下载的
.dmg文件，将萌萌的 CatBar 图标拖动到Applications文件夹内。 - 解除系统隔离：苹果系统对于没有商业开发者签名的应用非常严格。如果您在启动软件时被提示“应用已损坏，无法打开”，请千万不要将它移入废纸篓。请打开系统自带的 终端 (Terminal) 应用，执行以下隔离解除指令：
bash
sudo xattr -r -d com.apple.quarantine /Applications/CatBar.app(回车后输入您的 Mac 开机密码，密码输入时不会显示星号，输完回车即可)
2. 获取机场订阅链接
再可爱的工具，要带您连通外网也必须有给力的“机场节点”。
- 登录您的机场服务商后台（如果您还在挑选高性价比、不跑路的节点，欢迎查看本站的 👉 2026 优质稳定机场榜单）。
- 在网站控制面板或订阅中心，找到 “一键订阅” 区域。
- 请点击 “复制 Clash 订阅链接” 或者 “复制通用节点订阅”。CatBar 能够完美读取这套工业标准的配置。
3. 导入节点与开启代理（图文流程）
在 CatBar 中配置网络极为简单，所有的操作都在顶部的状态栏完成：
步骤一：呼出主菜单
运行软件后，Mac 屏幕右上角菜单栏会出现一个小猫咪图标。点击该图标，展开下拉菜单，找到 配置管理 (Profiles) 或订阅管理的入口。
步骤二：新建配置并拉取节点
在弹出的管理窗口中，点击“+”号添加按钮，输入一个便于辨认的名字（比如您的机场名字），接着将刚刚复制的订阅 URL 粘贴进去。保存后，点击 更新 (Update/Download) 拉取云端数据。
步骤三：在状态栏选择配置
下载完成后，再次点击顶部菜单栏的小猫图标。在长长的菜单中，单击勾选您刚刚下载的机场配置，确保内核正式读取了这份文件。
步骤四：设为系统代理
在下拉菜单中，找到 设为系统代理 (Set as System Proxy) 的勾选项，将其打勾。此时您的浏览器流量已成功被软件接管，可以访问外网了。
步骤五：挑选低延迟节点与分流模式
确保菜单中的出站模式被设置为 规则 (Rule) 以实现国内外智能分流。在展开的代理组列表中，挑选一个数值较小的绿色节点点击使用即可。
4. 进阶玩法：开启 TUN (增强模式) 虚拟网卡
对于 Mac 用户而言，“系统代理”的覆盖面其实很有限，它主要针对浏览器生效。如果您需要加速外服游戏、Telegram 桌面版，或是进行极客开发（使用 Docker、Brew、Git 等命令），您必须开启更强大的 TUN 模式 (增强模式)。
- 工作原理：它会在您的系统底层建立一张虚拟网络接口（网卡），强制截获电脑上的所有网络通信包，让原本不走代理的软件全部乖乖翻墙。
- 如何开启：在下拉菜单或偏好设置页面中寻找 增强模式 (Enhanced Mode) / TUN 模式 并打勾。此时 macOS 会弹出一个安全提权窗口，请输入您的 Mac 锁屏密码或指纹进行授权。授权通过后，您的电脑便实现了“真·全局接管”。
5. 常见问题排查与 FAQ
无论界面多简约，底层的排障逻辑是不变的。以下是 5 个常见问题：
1. 为什么导入订阅时一直提示“网络连接超时”或失败？
这通常是因为您本地宽带的 DNS 遭到了大面积污染，导致客户端找不到配置服务器。 解决办法：请联系机场客服要“备用防污染订阅链接”，或者临时使用手机开热点给 Mac 连上网络，成功更新出节点后再换回原本的宽带。
2. 系统代理已经打勾了，为什么谷歌打不开，甚至连百度也连不上了？
这是极大概率发生了代理端口冲突或系统网络偏好设置卡死。 解决办法：请检查并彻底退出后台运行的其他所有的翻墙软件。然后在菜单栏中，先把“设为系统代理”取消打勾，等待 3 秒后再重新打勾，以此来刷新系统底层注册状态。
3. 为什么在代理列表里点击测速，所有节点都显示 Timeout？
全部超时说明您的客户端已经和所有的境外节点彻底失联。
- 请先登录机场官网检查您的流量是否用尽或套餐已过期。
- 可能是配置中的旧节点已被防火墙集体精准阻断，请去“配置管理”点击“更新”，重新拉取机场最新的抗封锁 IP。
4. 我开启了 TUN 模式，为什么我的外服游戏还是延迟很高？
TUN 模式虽然截获了所有的流量，但如果内部分流规则判定该游戏流量为“国内直连（Direct）”，它依然不会走海外节点。 解决办法：在下拉菜单的顶部，把路由模式从“规则 (Rule)”强制切换为“全局代理 (Global)”，并直接选定您的专属游戏线路节点，然后再启动游戏。
5. 终端 (Terminal) 里下载东西很慢，系统代理不管用？
是的，Mac 系统的终端有时不认普通的系统代理。 解决办法：直接在终端里复制粘贴这条临时命令：export http_proxy=http://127.0.0.1:7890 https_proxy=http://127.0.0.1:7890，回车后即可让当前终端窗口走上代理通道。