Linux 发行版安装：AppImage、deb 包与系统集成

支持的发行版

AlgerMusicPlayer 的 Linux 版本基于 Electron，理论上能在所有主流发行版上运行。实际测试覆盖：

• Ubuntu 18.04+
• Debian 10+
• Linux Mint 20+
• Arch Linux / Manjaro（需要自行打包，社区可能有 AUR）
• Fedora / openSUSE（AppImage 即可）
• 其他主流发行版

方式一：AppImage（推荐）

AppImage 是单文件跨发行版方案，不需要安装：

# 下载（64位 x86_64）
wget https://github.com/algerkong/AlgerMusicPlayer/releases/download/v5.1.0/AlgerMusicPlayer-5.1.0-linux-x86_64.AppImage

# 下载（ARM64）
wget https://github.com/algerkong/AlgerMusicPlayer/releases/download/v5.1.0/AlgerMusicPlayer-5.1.0-linux-arm64.AppImage

# 赋予执行权限
chmod +x AlgerMusicPlayer-*.AppImage

# 直接运行
./AlgerMusicPlayer-5.1.0-linux-x86_64.AppImage

优点：跨发行版、绿色便携、不污染系统包管理。缺点：需要手动检查更新（应用内自动更新对 AppImage 可能不完全生效）。

方式二：.deb 包

适用于 Debian / Ubuntu / Linux Mint 等 deb 系：

# 下载
wget https://github.com/algerkong/AlgerMusicPlayer/releases/download/v5.1.0/AlgerMusicPlayer-5.1.0-linux-amd64.deb

# 安装（推荐用 apt 自动解决依赖）
sudo apt install ./AlgerMusicPlayer-5.1.0-linux-amd64.deb

# ARM64 设备
sudo apt install ./AlgerMusicPlayer-5.1.0-linux-arm64.deb

安装后可以在应用菜单或 alger-music-player 命令启动。

依赖问题

AppImage 已经内置了大部分运行时，通常不会出现缺少依赖的错误。如果 .deb 包安装时提示缺少库，先 sudo apt -f install 修复。

Wayland 注意事项

部分 Wayland 会话（如 GNOME on Wayland）可能出现窗口显示异常，这是 Electron 的已知问题。临时解决方案：

# 强制使用 X11 后端启动
GDK_BACKEND=x11 ./AlgerMusicPlayer-*.AppImage

更新

• AppImage：手动下载新版覆盖旧文件
• .deb 包：重新安装新版 .deb，apt install ./新包名.deb 会自动升级