在较新的 Linux 发行版上,给 AppImage 赋予可执行权限后从终端启动,可能只看到:

AppImages require FUSE to run.

这通常不是 AppImage 文件损坏,而是系统缺少它挂载自身所需的 FUSE 2 库。AppImage 运行时要把自己挂载为临时文件系统,这一步依赖 FUSE(Filesystem in Userspace)。多数 AppImage 仍按 FUSE 2 构建;许多较新发行版(例如 Ubuntu 22.04 及更高版本)默认提供 FUSE 3,不再包含旧的 FUSE 2 库。缺少该库时,AppImage 无法完成挂载,于是出现上述报错。

如果下载的文件还没有可执行权限,先用 chmod 命令处理。下面两种做法都不需要重新下载 AppImage。安装软件包需要管理员权限,命令通过 sudo 执行,并会向系统安装软件包;提取模式会在本地创建文件或目录。

安装 FUSE 2 兼容库(推荐)

装上缺失的库后,同一个 AppImage 就能正常运行,不需要额外步骤。根据发行版选择对应命令。

Ubuntu / Debian / Linux Mint:

# For Ubuntu 22.04, Debian 12, Linux Mint, etc.
sudo apt install libfuse2
# For Ubuntu 24.04 and newer (the package was renamed)
sudo apt install libfuse2t64

如果提示找不到软件包,先确认 universe 仓库已启用,再重试:

sudo add-apt-repository universe
sudo apt update
sudo apt install libfuse2

在 Ubuntu/Debian 上,较旧版本使用 libfuse2,Ubuntu 24.04 及更高版本使用 libfuse2t64;后者是在 64 位 time_t 迁移中改名的。

Fedora:

sudo dnf install fuse fuse-libs

有用户反馈,同时安装 fuse-devel 可以解决某些依赖问题。

Arch Linux:

sudo pacman -S fuse2

openSUSE:

sudo zypper install fuse libfuse2

安装完成后再次运行 AppImage。如果仍然失败,注销并重新登录,或重启计算机。

不安装 FUSE,用提取模式运行

如果不想安装额外软件包,或者在这台机器上没有管理员权限,可以使用 AppImage 内置的提取模式,完全绕开 FUSE。临时模式会解包到临时目录;永久模式会在当前目录创建 squashfs-root 目录。

临时提取并运行

./YourFile.AppImage --appimage-extract-and-run

把 YourFile.AppImage 换成实际文件名。该命令使用 --appimage-extract-and-run 参数,把应用解包到临时目录并启动,不需要 FUSE。

不确定文件名? 在终端运行 ls,找到以 .AppImage 结尾的文件名,并照原样使用;大小写要一致。文件名含空格时,用引号括起来,例如 "./My App.AppImage"。

永久提取

./YourFile.AppImage --appimage-extract

这会在当前目录创建 squashfs-root 目录。之后用下面的命令启动应用:

./squashfs-root/AppRun

如果经常使用这个应用,永久提取比较方便,因为只需要解包一次。

两种方式怎么选

  • 希望之后直接运行原 AppImage,并且有管理员权限:安装 FUSE 2 兼容库。
  • 不想安装额外软件包,或没有管理员权限:使用 --appimage-extract-and-run 临时提取运行。
  • 经常使用同一个应用:用 ./YourFile.AppImage --appimage-extract 永久提取,之后运行解包目录中的启动文件。

常见问题

问:安装 FUSE 安全吗?

答:是。FUSE 是 Linux 生态中标准且广泛使用的组件;安装 FUSE 2 兼容库是常规且安全的操作。

问:Ubuntu 24.04 上应该用哪个包名?

答:使用 libfuse2t64。在 Ubuntu 24.04 及更高版本上,这个软件包在 64 位 time_t 迁移过程中被改名。

问:为什么很多 AppImage 仍然按 FUSE 2 构建?

答:因为 FUSE 2 在各发行版之间兼容性更广。较新的 AppImage 正在逐步转向 FUSE 3,但这一过渡仍在进行中。

问:修复后需要重新安装 AppImage 吗?

答:不需要。问题出在系统库上,而不是 AppImage 文件本身。安装好库或改用提取模式后,同一个文件即可工作。