Folia 国内安装完整教程：网盘、AUR、便携版 3 种方法-平芜编程栈

Folia 国内安装完整教程：网盘、AUR、便携版 3 种方法

【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major

国内直连官方下载页拉安装包，速度慢是常态，大文件拉到一半断线也很常见。如果你正被这个情况卡住，Folia 国内下载其实不必硬靠加速工具。

Folia 是主打歌词全屏动画的音乐播放器，覆盖本地音乐、Navidrome 以及网易云、QQ 音乐、酷狗等音源。官方为此准备了网盘镜像、AUR 包和 Linux 便携版三种渠道，这篇文章把 Folia 安装的三条路径一次讲清：Windows 和 macOS 走网盘转存，Arch 一条命令装好，其余发行版解压便携版、自己建启动项。

Windows、Arch、其他 Linux：该选哪种装法？

你在 Windows 或 macOS 上：直接走网盘镜像，三步装完。
你在 Arch Linux 上：AUR 已有现成包，敲一条命令即可。
你在 Ubuntu、Debian 这类其他发行版上：用便携版手动部署。

Folia 网盘镜像怎么拿到安装包？

Folia 下载在国内的首选是官方网盘镜像。镜像放在夸克网盘与百度网盘（提取码 flia），官方提供的覆盖 Windows 与 Apple silicon 的安装包。操作分三步：

翻到项目 README，找到「直接下载」小节，里面的官方网盘入口直接复制；
打开夸克或百度客户端，登录账号，把安装包转存进自己的网盘，客户端下载就不卡了；
按平台挑文件：Windows 拿.exe，macOS 拿.dmg（认准 Apple silicon 版本），运行安装即可。

桌面版把前后端运行环境都内置了，装完不用再配置任何东西。

⚠️ 入口只认 README 里给出的官方地址，别人二次转存的安装包千万别用。

Arch 装 Folia 要敲几条命令？

Folia 已进 AUR（Arch 的社区软件仓库），包名是folia-major-bin。交给 yay 或 paru 都能装（它们都是 AUR Helper，帮你查找并安装 AUR 仓库里包的工具）：

# yay yay -S folia-major-bin # 或 paru -S folia-major-bin

alsa-lib、gtk3、nss这类依赖构建时会自动解决，程序放进/opt/folia-major，系统菜单里同时生成folia-major启动项，什么都不用手动补。

⚡ 提速技巧：AUR 构建时要回 Releases 取便携压缩包folia-major-<版本>-linux-x64.tar.gz。这一步如果慢，先把同版本压缩包从网盘转存进构建源码目录，再跑makepkg -si，就能跳过下载环节。

其他 Linux 上如何手动部署 Folia 便携版？

从网盘拿到同版本的folia-major-<版本>-linux-x64.tar.gz（Linux 包也可到官方 Releases 页对照），解压之后三步搞定：

目录里有folia-major可执行文件、resources/linux/folia-major.desktop启动项模板和resources/linux/icon.png图标；
把模板复制到~/.local/share/applications/folia-major.desktop（用户级应用菜单目录），打开它，将__APP_PATH__指向folia-major可执行文件所在的绝对路径，__ICON_PATH__指向resources/linux/icon.png的绝对路径；
部分桌面环境（如 GNOME）还会要求把启动项标记为「可信」或赋予可执行权限，没有这步要求的可跳过。

完整说明见 packaging/linux/README-LINUX.txt。

装完 Folia 后怎么自查？

✅ 起播一首歌，歌词以全屏动画铺满画面，而不是一行静态文字； ✅ 登录各音源可用：本地音乐库、Navidrome、QQ 音乐、酷狗、网易云，切换顺畅； ✅ 应用菜单里出现folia-major启动项，点它能正常拉起程序。

三项全过，就可以安心听歌了。

常见问题

Folia 启动后黑屏、透明异常或闪退怎么办？

多半是图形兼容问题。换成软件渲染方式启动：FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major。还嫌不稳就再保守一档，改用FOLIA_LINUX_GRAPHICS_MODE=software，细节可查上文提到的 README-LINUX.txt。