FlClash Linux 安装与配置指南
简答:FlClash Linux 先按 <code>uname -m</code> 判断 CPU 架构,再从官方 Release 选择匹配的 DEB、RPM 或 AppImage。Ubuntu、Debian 通常优先 DEB,Fedora、RHEL 可优先 RPM,其他发行版可先用 AppImage 验证启动。安装后导入订阅或本地配置,先测试系统代理,确认基础连接正常后再排查 TUN。本文按 2026-10-27 核验,Release 当前显示 v0.9.2,但版本和文件名仍应以打开页面时的实际内容为准。
定义:FlClash Linux 是一款基于 ClashMeta(mihomo)核心的 Linux 桌面客户端,负责配置管理、规则路由和本地流量转发,本身不提供节点、订阅或网络接入服务。
30 秒速查:从架构到首次连接
| 顺序 | 操作 | 检查结果 |
|---|---|---|
| 1 | 运行 uname -m | x86_64 通常对应 amd64;aarch64 通常对应 arm64 |
| 2 | 打开 FlClash 官方 Releases | 只按当前页面实际资产选择,不固定套用旧文件名 |
| 3 | 下载匹配架构的 DEB、RPM 或 AppImage | 系统、架构和文件格式一致 |
| 4 | 核对 Release 页面显示的 SHA256 | 本地计算值与页面值完全一致 |
| 5 | 安装并启动客户端 | 能进入主界面,不立即退出 |
| 6 | 导入订阅或本地 YAML 配置 | 配置列表中出现可打开的配置 |
| 7 | 先开系统代理,再测试 TUN | 先区分客户端、配置、权限和线路问题 |
截至 2026-10-27,官方 Release 页面显示最新条目为 v0.9.2,并列出了 Linux amd64 与 arm64 的 AppImage、DEB、RPM 资产及对应 SHA256。版本、发布日期、文件名和校验值会变化,下载时应以当前 Release 页面为准,不要把本文示例名称当成固定名称。查看官方 Release 资产
先判断 Linux 架构,再选择安装包
在终端运行:
uname -m
| 命令输出 | 通常对应的 Release 架构 | 选择建议 |
|---|---|---|
x86_64 | amd64 | 选择当前 Release 中名称含 amd64 的 Linux 文件 |
aarch64 | arm64 | 选择当前 Release 中名称含 arm64 的 Linux 文件 |
| 其他结果 | 无法直接判断 | 先确认发行版、CPU 架构和官方 Release 是否提供对应资产 |
文件名可能使用 amd64、arm64、x86_64 或 aarch64 等不同写法,因此不要手动把文件名改成自己预想的格式。正确做法是先看当前 Release 的完整资产名称,再将实际文件名复制到安装命令中。
FlClash 官方项目资料将其描述为基于 ClashMeta 的多平台客户端,支持 Linux、订阅链接和配置文件;同时,项目的使用说明明确表示软件本身不提供代理服务器、节点、订阅或网络接入服务。官方项目仓库 项目内置声明
DEB、RPM、AppImage 怎么选
| 格式 | 优先考虑的系统 | 适合场景 | 注意事项 |
|---|---|---|---|
| DEB | Ubuntu、Debian 及兼容系统 | 希望使用系统包管理和桌面集成 | 架构必须匹配;安装失败时先看依赖报错 |
| RPM | Fedora、RHEL 及兼容系统 | 希望使用 RPM 系包管理方式 | 不同发行版的依赖和桌面集成可能不同 |
| AppImage | 其他桌面发行版或临时验证 | 尽量少改动系统,直接运行单个文件 | 需要执行权限;托盘和 TUN 仍可能需要额外处理 |
如果使用 Ubuntu 或 Debian,优先尝试 DEB;使用 Fedora 或 RHEL 系统时,优先查看当前 Release 是否提供匹配的 RPM;如果只是想先确认客户端能否启动,可以选择对应架构的 AppImage。这个选择只决定安装方式,不能据此推断节点延迟、线路稳定性或代理速度。
FlClash 项目 README 还提示,DEB 包会安装自身依赖;使用 AppImage 或 RPM 时,Linux 托盘图标可能需要 AyatanaAppIndicator 库。该说明针对项目的桌面集成,不等于所有系统都必须安装同一组依赖。官方 README 的 Linux 说明
Ubuntu 或 Debian:安装 DEB 并确认结果
- 运行
uname -m,确认使用 amd64 还是 arm64 资产。 - 从 官方 Release 页面下载实际的
.deb文件。 - 进入下载目录,例如:
cd ~/Downloads。 - 将下面命令中的文件名替换为实际下载名称:
sudo apt install ./实际文件名.deb。 - 安装结束后,从应用菜单搜索 FlClash;如果没有出现,先回到终端查看安装过程是否有错误。
- 启动客户端,确认能够进入主界面,再进行配置导入。
Ubuntu 官方文档说明可以使用本地 DEB 文件安装,并提醒包管理工具比单独使用低层安装命令更适合处理依赖关系。本文不把 Ubuntu 文档中的通用包管理行为扩展为 FlClash 的具体依赖承诺。Ubuntu 官方软件包管理文档
如果安装失败,先保留完整终端输出。重点查看文件架构是否匹配、依赖包是否缺失,以及系统是否为受支持的桌面环境;不要为了绕过报错直接使用强制安装参数。
Fedora 或 RHEL:安装 RPM 并检查依赖
- 运行
uname -m,确认选择 amd64 或 arm64 资产。 - 从当前 Release 页面下载实际的
.rpm文件。 - 进入文件目录:
cd ~/Downloads。 - 使用 DNF 安装本地文件:
sudo dnf install ./实际文件名.rpm。 - 查看 DNF 给出的安装、升级或依赖变更清单,确认没有异常删除计划。
- 安装完成后,从桌面应用菜单启动;若托盘图标缺失,再根据项目 README 检查 AyatanaAppIndicator 依赖。
这里的 DNF 命令用于安装本地 RPM,实际能否完成还取决于当前 Fedora、RHEL 版本和系统仓库状态。若 DNF 报依赖错误,应记录完整输出,先确认发行版版本和架构,不要把 Fedora 的依赖处理方式直接套用到其他发行版。
FlClash 项目 README 将 Fedora 的托盘依赖示例写为 libayatana-appindicator-gtk3,但这只对应托盘显示问题;如果客户端核心、配置或网络连接失败,不能仅靠安装托盘库解决。官方 README 的依赖说明
AppImage:校验、授权与启动
- 从官方 Release 页面下载与本机架构匹配的 AppImage。
- 进入下载目录:
cd ~/Downloads。 - 查看实际文件名:
ls -lh *.AppImage。 - 按实际文件名计算 SHA256:
sha256sum '实际文件名.AppImage'。 - 将本地计算结果与同一 Release 页面显示的 SHA256 逐字比较;不一致时不要继续运行。
- 赋予执行权限:
chmod +x '实际文件名.AppImage'。 - 启动:
./'实际文件名.AppImage'。
AppImage 官方快速入门给出的基本流程就是下载、赋予执行权限并运行。若提示缺少 FUSE、图形库或托盘组件,应记录完整报错,并用匹配发行版的 DEB 或 RPM 做对照,不要把启动失败直接判断为订阅或节点问题。AppImage 官方快速入门
如果 SHA256 不一致,先删除文件并重新从官方 Release 页面下载。校验一致只能说明本地文件与页面列出的摘要一致,不能证明某个订阅服务、节点或线路一定可用。
安装后导入配置:先确认客户端,再确认服务
- 打开 FlClash,找到配置或 Profiles 相关页面;不同版本的菜单名称可能变化,以当前界面显示为准。
- 导入服务提供方给出的订阅 URL,或选择本地 YAML 配置文件。
- 等待配置加载完成,确认配置列表中出现可打开的项目。
- 进入代理组或节点列表,选择配置中实际存在的代理组或节点。
- 先启用系统代理,使用浏览器或目标应用发起测试。
- 只有在系统代理基础连接正常后,才继续测试 TUN。
客户端安装成功、订阅能访问、节点可用和线路稳定是四个不同问题。FlClash 负责本地配置、规则路由和流量转发;订阅地址能否访问、配置是否返回节点、节点是否在线、延迟和丢包是否合适,则取决于配置来源、网络环境和具体线路,不能归因于客户端官方保证。FlClash 项目声明的服务边界
如果配置导入失败,先检查 URL 是否完整、浏览器或命令行是否能访问该地址、返回内容是否为空,以及本地 YAML 是否能被当前版本读取。不要公开粘贴包含账号、令牌或订阅参数的完整链接。
系统代理与 TUN:按权限和现象分流
FlClash 项目代码和工程说明显示,Linux 桌面端包含用于 TUN 授权的辅助服务;Linux 下需要授权时,应用会请求提升权限注册辅助服务,而不是要求用户长期以 root 身份运行整个桌面客户端。FlClash Linux 辅助服务说明
- 系统代理可用、TUN 不可用:先保留系统代理,记录 TUN 提示和应用日志,不要直接用 root 长期启动客户端。
- AppImage 可启动、TUN 授权失败:优先查看当前版本的授权提示;官方工程说明指出,AppImage 没有稳定的安装路径和可写核心文件,TUN 授权可能不可用,因此不要把 AppImage 的启动成功等同于 TUN 一定可用。官方工程说明中的 AppImage 限制
- 浏览器可用、终端不可用:桌面系统代理不一定会传递给所有命令行程序,检查目标程序是否支持代理环境变量或独立代理设置。
- 所有应用都不可用:先确认配置已加载、核心已运行,再检查系统代理状态、DNS、路由和本机防火墙。
项目 README 还列出 Linux 桌面端的系统代理和 TUN 功能,但没有为所有发行版承诺相同的菜单路径、权限行为或桌面集成效果。因此,找不到某个入口时应停止照抄旧教程,改看当前版本界面和日志。官方 README 的功能说明
常见连接问题:现象、检查、下一步
| 现象 | 先检查 | 下一步 | 验证标准 |
|---|---|---|---|
| 应用打不开 | 架构、文件权限、终端报错 | 改用匹配架构的另一种安装格式对照 | 能进入主界面且不立即退出 |
| DEB/RPM 安装失败 | 发行版、架构和依赖提示 | 保存完整报错,不使用强制参数跳过检查 | 包管理器完成安装且无未满足依赖 |
| AppImage 无法运行 | 是否执行、FUSE 或图形库提示 | 重新执行 chmod +x,再与 DEB/RPM 对照 | 终端启动后出现客户端窗口 |
| 没有节点或代理组 | 配置是否导入、刷新是否成功、返回内容是否为空 | 检查订阅来源或改用本地 YAML 测试 | 配置详情中出现实际代理组或节点 |
| 系统代理不生效 | 核心状态、系统代理开关、目标应用是否读取系统代理 | 关闭后重新开启,并查看应用日志 | 目标应用请求行为发生变化 |
| TUN 权限失败 | 当前安装格式、授权提示、systemd 环境 | 先用系统代理验证,再按当前版本提示授权 | 日志不再重复权限错误且虚拟接口正常 |
| 延迟或丢包异常 | 节点、DNS、网络类型和测试时间 | 在相同条件下更换节点并分别记录结果 | 多次测试结果可复现 |
不要用一次网页打开成功或失败来判断线路质量。排查时至少记录操作系统、桌面环境、安装格式、配置名称、节点名称、是否启用系统代理或 TUN、测试时间、延迟和丢包结果。本文不提供任何节点速度、线路稳定性或可用性保证。
安装前后的安全核对清单
- 下载地址是否为项目当前 Release 页面,而不是只看搜索结果中的页面标题。
- 文件名中的系统、架构和格式是否与本机一致。
- SHA256 是否与同一 Release 页面显示的值完全一致。
- 是否保留原始文件名,方便回退和复现安装问题。
- 订阅链接、账号信息和完整配置是否没有公开发送。
- 是否先用系统代理验证,再决定是否启用 TUN。
- 是否避免使用不明来源的修改包、预装配置或要求长期 root 运行的脚本。
本文核验的是 FlClash 官方项目仓库、官方 Release 页面、Ubuntu 包管理文档和 AppImage 官方文档;没有核验任何具体订阅服务、节点质量、线路性能、价格或可用性。
常见问题
FlClash Linux 应该下载哪个文件?
先运行 uname -m。x86_64 通常选择 amd64,aarch64 通常选择 arm64;Ubuntu、Debian 优先 DEB,Fedora、RHEL 优先 RPM,其他发行版或临时验证可以选择匹配架构的 AppImage。最终以当前官方 Release 页面实际资产名称为准。
FlClash Linux 自带节点吗?
不自带。官方项目声明 FlClash 是本地网络代理客户端,不提供代理服务器、节点、订阅或网络接入服务。用户需要自行准备订阅链接或本地配置,节点是否可用也不由客户端安装结果决定。
为什么 AppImage 能打开,但 TUN 不能用?
AppImage 能启动只说明图形客户端可以运行,不代表 Linux TUN 授权一定可用。官方工程说明指出,AppImage 没有稳定安装路径和可写核心文件,TUN 授权可能受限。先使用系统代理验证基础连接,再按当前版本的授权提示处理。
Ubuntu 安装 DEB 时提示依赖错误怎么办?
先确认文件架构与系统匹配,并保存完整终端报错。使用 apt 安装本地 DEB,避免直接用强制参数跳过依赖检查;如果仍失败,可以用匹配架构的 AppImage 做启动对照,但不要据此判断订阅或节点质量。
FlClash 导入订阅后没有节点怎么办?
检查订阅 URL 是否完整、地址是否能访问、返回内容是否为空,以及配置是否成功出现在列表中。若本地 YAML 也无法加载,再查看格式和日志。订阅服务、节点状态和线路质量属于配置来源或网络问题,不等于客户端安装失败。
浏览器能用,但 Linux 终端命令不能用,是什么原因?
桌面系统代理不一定会自动传递给所有终端程序。先确认 FlClash 核心和系统代理均处于运行状态,再检查目标命令行程序是否支持代理环境变量或独立代理设置。
