Linux 使用教程
本教程面向最终用户,介绍如何在 Linux 桌面系统上安装、登录和使用本客户端。
说明:本客户端是一个图形界面(GUI)应用,必须在带桌面环境(X11 或 Wayland)的 Linux 上运行,无法在纯命令行 / 无头服务器上使用。如果你需要在服务器上跑代理,请直接使用 Mihomo(clash-meta)内核的命令行版本,而不是本客户端。
一、系统要求
- 64 位 x86 架构(amd64 / x86_64)的 Linux 桌面系统
- 带图形桌面环境:GNOME、KDE、XFCE、Deepin 等均可(X11 或 Wayland)
- 常见发行版:Ubuntu / Debian、Fedora / RHEL / openSUSE、Deepin / UOS、Arch 等
应用运行依赖以下系统库(多数桌面发行版已自带,缺失时按下文排错章节安装):
GTK 3(图形界面基础)libayatana-appindicator3(系统托盘图标)libkeybinder-3.0(全局快捷键)
二、选择安装包格式
每次构建会产出三种格式,运行效果完全一致,只是分发方式不同,按你的发行版选择其一即可:
| 格式 | 适用系统 | 特点 | 下载地址 |
|---|---|---|---|
.deb | Debian / Ubuntu / Deepin / UOS 等 | 系统包管理器安装,自动处理依赖、创建菜单项 | （点击下载） |
.rpm | Fedora / RHEL / CentOS / openSUSE 等 | 系统包管理器安装,自动创建菜单项 | （点击下载） |
.AppImage | 任意发行版 | 免安装,下载后直接双击运行,适合不想动系统的场景 | （点击下载） |
下载到的文件名形如
Feito-<版本号>-linux.deb(Feito为应用标识,可能随渠道不同而变化)。下文命令中请把文件名替换成你实际下载到的名字。
三、安装步骤
方式 A:DEB 包(Debian / Ubuntu / Deepin 等)
# 进入下载目录
cd ~/Downloads
# 安装(自动解决依赖)
sudo apt install ./Feito-*-linux.deb
# 或者用 dpkg 安装后再补依赖
# sudo dpkg -i ./Feito-*-linux.deb
# sudo apt -f install
安装完成后,在应用菜单(活动 / 启动器)里搜索应用名称即可启动。
方式 B:RPM 包(Fedora / RHEL / openSUSE 等)
cd ~/Downloads
# Fedora / RHEL
sudo dnf install ./Feito-*-linux.rpm
# openSUSE
# sudo zypper install ./Feito-*-linux.rpm
# 老系统可用
# sudo rpm -i ./Feito-*-linux.rpm
方式 C:AppImage(免安装,任意发行版)
cd ~/Downloads
# 赋予可执行权限
chmod +x ./Feito-*-linux.AppImage
# 直接运行
./Feito-*-linux.AppImage
AppImage 依赖 FUSE。若运行报
dlopen(): error loading libfuse.so.2,见下文排错章节。
四、首次使用
- 启动应用:从应用菜单点击图标,或运行 AppImage。
- 登录账号:在登录页输入你的账号和密码登录(没有账号请先到官网注册)。
- 自动导入配置:登录成功后,客户端会自动拉取并导入你的订阅配置,无需手动操作。
- 连接代理:
- 在主界面选择一个节点 / 节点组;
- 打开总开关启动代理。
- 系统代理 / TUN 模式:
- 系统代理模式:自动为系统设置 HTTP/SOCKS 代理,适合大多数用户。
- TUN 模式(虚拟网卡):接管全局流量,兼容性更好,但首次开启可能需要授予网络权限(见排错章节)。
启动后应用会常驻系统托盘,关闭窗口默认最小化到托盘而非退出;从托盘菜单可快速切换开关或退出。
五、常用操作
- 切换节点:主界面节点列表中点击选择,延迟测速结果会一并显示。
- 查看流量 / 套餐:仪表盘可查看实时上下行速率与套餐用量。
- 更新订阅:配置会自动刷新;也可在界面手动触发刷新。
- 开机自启 / 静默启动:在设置中按需开启。
- 浅色 / 深色主题:在设置的"主题"中切换(自动 / 浅色 / 深色)。
六、卸载
DEB
sudo apt remove Feito # 包名以实际安装名为准
# 如需连同配置一起清除:
# sudo apt purge Feito
RPM
sudo dnf remove Feito # 或 sudo rpm -e Feito
AppImage
直接删除下载的 .AppImage 文件即可。如需清理残留配置,删除用户配置目录:
rm -rf ~/.config/<应用配置目录>
七、常见问题排错
1. 双击没反应 / 终端报无法连接显示
Gtk: cannot open display / Unable to init server
说明当前环境没有图形界面(如 SSH 无头会话、纯 TTY)。本应用必须在桌面会话中运行,请在带桌面的环境登录后再启动。
2. 托盘图标不显示
缺少 appindicator 支持库,安装后重启应用:
# Debian / Ubuntu
sudo apt install libayatana-appindicator3-1
# Fedora
sudo dnf install libayatana-appindicator-gtk3
GNOME 用户可能还需安装 "AppIndicator and KStatusNotifierItem Support" 扩展才能显示托盘。
3. AppImage 报错 libfuse.so.2 缺失
# Debian / Ubuntu
sudo apt install libfuse2
# Fedora
sudo dnf install fuse fuse-libs
或临时解包运行:./feito-*.AppImage --appimage-extract-and-run
4. 缺少 GTK 库无法启动
# Debian / Ubuntu
sudo apt install libgtk-3-0
# Fedora
sudo dnf install gtk3
5. TUN 模式开启失败 / 无权限
TUN 模式需要创建虚拟网卡的网络权限。请确认:
- 以正常桌面用户运行(应用会按需申请提权);
- 系统已加载
tun模块(lsmod | grep tun,无输出可执行sudo modprobe tun)。 如仍失败,可先改用"系统代理模式"。
6. 连接成功但无法上网 / 获取配置失败
- 确认账号订阅有效、未过期;
- 检查系统时间是否准确(时间偏差会导致 TLS 握手失败);
- 尝试切换其他节点;
- 重新登录以刷新配置。