Folia 下载与安装：十分钟把全屏歌词动画播放器装好-平芜编程栈

Folia 下载与安装：十分钟把全屏歌词动画播放器装好

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

Folia 是一款全屏沉浸式歌词动画播放器，支持网易云、酷狗、Navidrome 等在线音源与本地音乐库，歌词会渲染成跟随节拍的全屏动画。本文带你走完 Folia 下载安装的完整流程，从选渠道到启动验证。桌面端基于 Electron 打包，内置前后端环境，装完无需另配运行环境。网络与步骤顺利的话，全程大约 10 分钟。

30 秒选路

这一节适合正准备动手安装的你：用 30 秒判断自己该走哪条路，不绕弯路。决策逻辑很简单——先看你的系统，再问自己接不接受命令行：Windows 或 Apple silicon 的 Mac、只想双击就能跑，走安装包路线；Arch 系发行版，包管理器路线最快；其他 Linux 发行版，或者想在 NAS 上部署 Web 版，走便携与自托管路线。

你的系统	走哪条路线	是否碰命令行
Windows 或 Apple silicon 的 Mac	安装包路线	否
Arch / EndeavourOS	AUR 路线	一行
其他 Linux 发行版，或 NAS 部署 Web 版	便携与自托管路线	部分

💡 三条路线拿到的都是同一个桌面端或 Web 版，区别只在分发形态。

三条安装路线：安装包、AUR 一行命令、便携与自托管

这一节是 Folia 安装的逐步操作，按系统拆成三条路线，找到对应你的 H3 跟着做即可。

Windows/macOS 安装包：网盘镜像或官方 Releases

适合谁：Windows 或 Apple silicon 的 Mac，装完双击就能用、不碰命令行。

具体步骤：

打开仓库 README，找到「快速下载」一节，点官方夸克网盘或百度网盘链接（百度提取码flia）。
在网盘客户端里下载对应平台的安装包：Windows 选.exe，macOS 选.dmg。
运行安装程序，按向导走完；桌面版内置前后端运行环境，装完直接可用。

⚠️只使用 README 里的官方网盘入口，避免来路不明的转发包。

装完应该看到：应用列表（Windows 为安装生成的快捷方式）里出现「Folia」，双击后能正常进入主界面。

Arch AUR 一行命令安装：yay 或 paru

适合谁：在用 Arch 或 EndeavourOS，且系统装过 AUR 助手。

具体步骤：先确认本机有yay或paru，然后执行下面这条命令：

这条命令会从 AUR 拉取folia-major-bin源码、从官方 Releases 下载对应的 Linux 压缩包，并自动解决alsa-lib、gtk3、libxss、nss等系统依赖；你装的是 paru 的话，把yay换成paru即可。

yay -S folia-major-bin

⚡ 如果构建时下载慢，先手动把同版本folia-major-<版本>-linux-x64.tar.gz下到 AUR 源码目录，再执行下面这条命令完成本地构建与依赖安装：

makepkg -si

装完应该看到：程序文件位于/opt/folia-major，终端能直接敲folia-major命令，应用菜单里多出一个folia-major启动项。依赖清单与安装位置定义见 PKGBUILD。

其他 Linux 发行版与 Web 自托管

适合谁：Ubuntu、Debian、Fedora 等发行版；或者想把 Web 版部署到 NAS、用浏览器访问。

便携版步骤：

从官方 Releases 取同版本的 Linux 压缩包，解压到任意目录——包内有folia-major可执行文件和resources/linux/目录（图标与桌面启动项模板）。
执行./folia-major启动。
想建桌面启动项，把resources/linux/folia-major.desktop复制到~/.local/share/applications/，把文件里__APP_PATH__、__ICON_PATH__两个占位符替换为可执行文件与图标的绝对路径，再按桌面环境要求标记为可信，详见 Linux 便携版说明。

Web 自托管：用 Docker Compose 全栈部署把 Web 版起在 NAS 或服务器上；本地音乐目录的访问依赖可信 HTTPS 安全上下文，部署文档里包含反向代理与证书要求。

装完应该看到：便携版启动后与安装包路线看到的主界面一致；自托管 Web 版用浏览器打开即可播放在线音源与本地曲库，手机上用 Chrome for Android 或 iOS Safari 创建 PWA 应用加到桌面即可。