快速入门与安装指引

欢迎使用 ClashMac 27.0！本篇指南将从零开始引导您在 macOS 上完成安全安装、启动服务、导入配置以及开启您的首个网络分流通道。

1. 下载与安全安装

为了保证软件能够正常读写本地配置文件并获得系统组件的调用权，请务必按照以下步骤进行安装：

双击打开下载的 .dmg 磁盘映像。
【重要】 必须将 ClashMac.app 拖入 Applications (应用程序) 文件夹中。
退出并弹出 .dmg 映像，进入系统的“应用程序”文件夹中双击运行 ClashMac。
CAUTION
绝不要直接在 .dmg 弹窗中双击启动应用。macOS 会对未安装至应用程序目录的软件启动安全只读挂载，导致配置无法保存且无法安装后台服务。

由于 macOS 严格的系统安全保护，首次双击打开应用时，可能会弹出 “无法打开，因为 Apple 无法检查其是否包含恶意软件” 的提示。

解决方法一：前往 macOS 的 系统设置隐私与安全性，下滑找到应用被拦截的提示，点击 仍要打开，并在弹出的确认框中输入您的 Mac 开机密码即可。
解决方法二 (针对极客)：若系统未弹出选项，可在终端中执行以下命令清除系统检疫隔离标记：
bash
```
sudo xattr -rd com.apple.quarantine /Applications/ClashMac.app
```

ClashMac 需要接管系统网络流量并管理网络分流，首次启动时应用将引导您安装核心辅助组件：

应用在首次运行时会自动检测本地是否备有核心网络引擎。若检测到核心缺失，应用会立即在后台启动静默下载。

自动下载与装配：应用会联网获取最新的 ClashMac 通用核心引擎并自动安装。
连接冷启动说明：请保持您的网络连接畅通。组件下载完成后，核心引擎将自动启动。
TIP
如果由于您的本地网络限制导致首次核心组件下载缓慢或失败，应用将自适应切换备用分发源进行重试，您也可以在高级设置中手动触发更新。

根据 macOS 15+ 及更高版本的安全规范，安装完成后必须在系统偏好中显式批准其后台运行：

密码验证通过后，ClashMac 会引导您自动打开系统设置页面。
请确认已定位在：“系统设置通用登录项与延伸功能”。
在“允许在后台”列表中，找到 ClashMac，并确保右侧的允许开关处于开启状态。
IMPORTANT
如果此开关被手动关闭或被系统禁用，后台服务将无法正常工作，客户端将出现红色的未连接提示。

ClashMac 启动后，需要导入配置文件才能获得可用的网络节点。

点击 macOS 右上角状态栏的 ClashMac 猫咪图标，选择 打开控制台。
导航至左侧侧边栏的配置页面。
根据您的配置文件来源，选择以下一种方式导入：
- 远程订阅下载：点击右上角 + 并选择 导入订阅，输入您的订阅链接，在命名框中命名（例如：订阅一），然后点击完成。系统将自动联网拉取节点数据并展示卡片。
- 本地文件导入：点击右上角 + 并选择 添加本地配置，直接从本地导入已有的配置文件。
【激活配置】 导入成功后，单击对应的配置文件卡片。卡片边缘亮起高亮的系统主题强调色，代表当前配置文件已成功激活加载。

当配置激活后，您就可以开启代理服务了：

点击系统右上角的 ClashMac 托盘图标，拉出状态栏快捷菜单。
开启接管模式：
- 系统代理：推荐日常使用。该模式会自动设置 macOS 系统级代理，支持绝大多数浏览器（如 Safari、Chrome）和遵循系统代理的应用程序。
- 增强模式(TUN)：若您需要让不遵循系统代理的终端命令行、Docker 容器、虚拟机或网络游戏通过代理网络，请开启此开关。它将在系统内创建虚拟网卡以接管全局的全部流量。
切换分流模式（可在状态栏菜单或控制台顶部切换）：
- 规则模式：自动根据配置文件里的分流规则分配流量。国内网站（如淘宝、百度）直连，海外受限网站自动通过代理节点访问，兼顾速度与隐私。
- 全局模式：所有网络流量强制通过您选中的单一节点。
- 直连模式：所有流量绕过代理，直接使用本地宽带访问。
选择节点：点击策略组（如 Proxy）对应的二级菜单，单选一个延迟状况良好的节点。