ClashFX 安装与快速上手指南

发布于 2026-03-01 · 最后更新 2026-03-01

系统要求

在开始之前，请确认你的设备满足以下要求：

• macOS 12 Monterey 或更高版本（支持到 macOS 15 Sequoia）
• Apple Silicon（M1/M2/M3/M4）或 Intel 处理器均可
• 约 50MB 磁盘空间
• 管理员权限（增强模式需要）

ClashFX 以 Universal Binary 形式发布，一个安装包同时支持 Apple Silicon 和 Intel Mac，无需区分下载。

下载 ClashFX

前往 GitHub Releases 页面获取最新版本：

https://github.com/Clash-FX/ClashFX/releases/latest

在 Assets 列表中找到 ClashFX.dmg 文件并下载。建议始终使用最新版本以获得最佳体验和安全修复。

如果你需要特定版本，可以在 所有版本 页面中查找。

安装步骤

第一步：打开 DMG 文件

双击下载的 ClashFX.dmg 文件，macOS 会挂载磁盘映像并打开安装窗口。

第二步：拖入 Applications

将 ClashFX 图标拖入 Applications（应用程序）文件夹。如果提示是否替换已有版本，选择「替换」。

第三步：处理安全提示

由于 ClashFX 目前不通过 Mac App Store 分发，macOS 可能会阻止首次运行。这是正常的安全行为，按以下步骤解决：

1. 尝试打开 ClashFX，看到「无法打开”ClashFX”，因为无法验证开发者」提示
2. 打开 系统设置 → 隐私与安全性
3. 在页面底部找到关于 ClashFX 的提示
4. 点击 「仍要打开」
5. 在弹出的确认对话框中点击 「打开」

完成后，后续启动将不再出现此提示。

第四步：首次启动

启动 ClashFX 后，你会在菜单栏右上角看到 ClashFX 的图标。点击图标即可打开主菜单，包含以下常用选项：

• 设置为系统代理 — 开关系统代理
• 代理模式 — 全局 / 规则 / 直连
• 增强模式 — TUN 全局代理
• 代理 — 查看和切换节点
• 配置 — 管理配置文件
• 远程配置管理 — 管理订阅链接

导入配置

ClashFX 需要配置文件才能连接代理。你有三种方式导入配置：

方式一：URL Scheme 一键导入（推荐）

如果你的服务商提供了一键导入按钮或链接，点击即可自动打开 ClashFX 并导入配置。ClashFX 支持两种 URL Scheme：

clashfx://install-config?url=你的订阅链接（URL 编码后）&name=配置名称
clash://install-config?url=你的订阅链接（URL 编码后）&name=配置名称

两种格式都可以使用，兼容大部分服务商的一键导入按钮。

方式二：手动添加远程订阅

1. 复制你的订阅链接
2. 点击菜单栏 ClashFX 图标
3. 选择 配置 → 远程配置管理
4. 点击窗口中的 「添加」 按钮
5. 粘贴订阅链接，设置配置名称
6. 点击确认，等待下载完成

详细教程请查看 导入远程订阅。

方式三：使用本地配置文件

如果你有现成的 .yaml 配置文件：

1. 打开 Finder，按 Cmd + Shift + G 前往文件夹
2. 输入 ~/.config/clash/ 并回车
3. 将你的 .yaml 配置文件复制到此目录
4. 在 ClashFX 菜单的 配置 中选择该配置文件

验证安装

完成配置导入后，按以下步骤验证 ClashFX 是否正常工作：

1. 点击菜单栏 ClashFX 图标
2. 确认 「设置为系统代理」 已开启（前面有勾号）
3. 在 代理 菜单中选择一个可用节点
4. 打开浏览器，访问 https://www.google.com
5. 如果能正常访问，说明 ClashFX 已成功运行

如果菜单栏图标旁显示了实时网速，说明有流量正在通过 ClashFX 路由。

基本操作速查

代理模式说明

• 全局模式：所有流量都走代理节点，适合需要全部翻墙的场景
• 规则模式（推荐）：根据配置文件中的规则自动分流，国内直连、国外走代理
• 直连模式：不使用任何代理，所有流量直接连接

大多数情况下推荐使用 规则模式，它能自动判断哪些流量需要代理。

开机自启动

如果希望 ClashFX 开机自动启动：

1. 打开 系统设置 → 通用 → 登录项
2. 点击 「+」 按钮
3. 在 Applications 中选择 ClashFX
4. 添加后每次开机 ClashFX 会自动启动

常见安装问题

提示”文件已损坏”

在终端中执行以下命令移除隔离标记：

xattr -cr /Applications/ClashFX.app

然后重新打开 ClashFX。

DMG 无法挂载

确认文件下载完整，没有被中断。可以删除后重新下载。如果使用了代理下载，尝试直连下载。

菜单栏看不到图标

检查菜单栏图标是否被其他图标遮挡。尝试按住 Cmd 键拖动其他菜单栏图标腾出空间。

全局快捷键

ClashFX 支持通过 AppleScript 实现全局快捷键。你可以使用 macOS 的 Automator 创建快捷操作：

tell application "ClashFX" to toggleProxy

tell application "ClashFX" to proxyMode "rule"

可用命令包括 toggleProxy（开关代理）和 proxyMode（切换模式，参数为 global、rule 或 direct）。

下一步

安装完成后，建议继续阅读以下教程：

• 导入远程订阅 — 配置订阅链接，获取代理节点
• 增强模式教程 — 开启 TUN 全局代理，代理所有应用
• 配置文件编辑 — 自定义你的代理规则和配置