Guided tutorialsGUIDE / 01

第一次使用，
也能从容开始。

从安装到系统级流量接管，每个步骤都保持清楚、可验证并且可逆。

012 MIN

安装与首次启动

安全下载、安装并完成 macOS 首次运行确认。

开始教程 → 023 MIN

导入配置

通过订阅地址、配置文件或 URL Scheme 添加配置。

开始教程 → 033 MIN

开启 Enhanced Mode

让所有应用流量按照当前规则处理。

开始教程 → 045 MIN

从 ClashX 迁移

备份配置、避免双客户端冲突并分阶段验证。

开始教程 → 054 MIN

让指定 App 直连

确认进程名并创建 PROCESS-NAME 规则。

开始教程 → 065 MIN

TUN 断网排查

按层定位 DNS、权限、节点或网络工具冲突。

开始教程 → +COMMUNITY RULES

国内 App 直连

使用 cn-apps-direct 一键绕过常用国内应用，并参与维护规则。

阅读完整说明 →

01 / FIRST RUN

安装与首次启动

建议始终从官方 GitHub 仓库下载，整个过程约需两分钟。

  1. 下载最新版本打开官方 Releases，选择最新 Stable 版本。
  2. 移动到应用程序打开安装包，将 ClashFX 拖入“应用程序”。
  3. 确认首次运行按 macOS 安全提示确认打开。
  4. 找到菜单栏图标ClashFX 在菜单栏运行，点击图标进入功能。

02 / CONFIG

导入你的配置

ClashFX 是客户端，不提供节点或订阅。请使用你合法获得的配置地址。

  1. 复制订阅地址从服务提供方复制完整 URL，不要公开分享。
  2. 打开配置菜单点击菜单栏图标，进入“配置”并选择导入。
  3. 粘贴并命名设置便于识别的配置名称后确认。
  4. 选择并更新检查节点和规则是否加载成功。

03 / TUN

开启 Enhanced Mode

TUN 会接管系统流量。首次开启需要管理员权限，之后可随时关闭。

开启前先确认普通系统代理模式连接正常。
  1. 确认配置已启用选择可用配置和节点。
  2. 打开增强模式在菜单栏找到 Enhanced Mode 并启用。
  3. 授予权限按系统提示输入管理员凭据。
  4. 检查连接状态访问常用网站确认规则生效。

04 / MIGRATION

从 ClashX 迁移

大多数 Clash YAML 配置可以复用，但部分旧内核专有字段可能需要调整。

避免冲突不要同时运行 ClashX 与 ClashFX。
  1. 记录当前配置保存订阅地址、自定义规则和节点组。
  2. 完整退出 ClashX先关闭系统代理和 TUN。
  3. 在 ClashFX 导入重新添加订阅或迁移 YAML。
  4. 分阶段验证先测试系统代理，再开启 Enhanced Mode。

05 / PROCESS RULE

让指定 App 直连

进程规则依赖真实可执行文件名，主要用于 Enhanced Mode。

- PROCESS-NAME,WeChat,DIRECT
  1. 找到可执行文件名运行 ls /Applications/应用名.app/Contents/MacOS/。
  2. 生成规则也可以前往本站工具页面生成。
  3. 放在具体规则前面mihomo 从上到下匹配。
  4. 优先使用内置开关常见国内应用可启用国内 App 直连。

06 / TROUBLESHOOT

Enhanced Mode 断网

先恢复网络，再逐层复现，不要一次替换整份配置。

打开诊断工具
  1. 关闭 Enhanced Mode同时取消系统代理，先恢复基础网络。
  2. 只验证系统代理选择已知可用节点测试。
  3. 检查 DNS 与权限排查安全 DNS 和旧网络扩展。
  4. 收集脱敏诊断移除订阅 URL、节点、本机用户名与公网 IP。