Folia 全屏歌词播放器安装教程：从下载到首次播放只要十分钟-创锋一号

Folia 全屏歌词播放器安装教程：从下载到首次播放只要十分钟

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

想让歌词在屏幕上整屏铺开、跟着节拍跳舞？Folia 是一个全屏歌词动画播放器，支持本地音乐、Navidrome 以及网易云、QQ 音乐、酷狗等在线音源。这篇文章只解决一件事：把最新版 Folia 装到你的电脑上。桌面版内置了完整的前后端环境，装完打开就能用，顺利的话十分钟能走完全部流程。

先选路线：你属于哪三种人里的哪一种

下载之前先花十秒钟判断自己的情况，后面照着对应路线走就行：

装完即用派（Windows / macOS / 大多数 Linux 用户）：直接拿官方桌面安装包或 Linux 便携压缩包，全程不碰命令行。这是本文的主路线，绝大多数人走这条。
Arch 系用户：有 AUR 包folia-major-bin，一条命令装好并自动生成应用菜单入口。
NAS / 服务器自托管派：想用手机浏览器访问，走 Docker Compose 部署 Web 版，耗时半小时以上，属于进阶选项。

💡 三条路线最终装到的都是同一个 Folia，区别只在运行形态。桌面版内置前后端，Web 版把服务端拆到了 Docker 容器里。

Windows / macOS 桌面版：最快安装步骤

适用对象：不想碰命令行的用户，装完双击图标就能听歌。

打开仓库首页的 README.md，找到「快速下载」一节。国内网络优先用官方网盘镜像（夸克 / 百度云），网络方便就直接走官方 Releases 页面。
按系统挑对应文件：Windows 选.exe安装包，macOS 选.dmg（Apple silicon 芯片版本）。网盘里先「转存到自己的网盘」再下载，中途断了能续传。
运行安装程序，按向导点完。桌面版不需要你额外装 Node.js 或配置任何后端，装完即完整。
在应用列表里找到 Folia，双击启动。

⚠️ 避坑：网盘镜像只提供 Windows 与 Apple silicon 版 macOS 的正式安装包。需要 Linux 包或 Intel 芯片的 Mac 版本时，必须直接去 Releases 页面下载。下载后先核对文件名里的版本号，和最新发行版对得上再安装，避免装到来路不明的转发包。

Linux 安装：AUR 一行命令，或便携版解压

Arch / EndeavourOS 用户：确认装了 AUR Helper 后，一行命令搞定：

# 用 yay 从 AUR 安装预构建包；paru 用户把 yay 换成 paru yay -S folia-major-bin

包会自动解析alsa-lib、gtk3、nss等依赖，把程序放进/opt/folia-major，并在应用菜单里生成folia-major启动项。依赖与安装位置的定义都在 packaging/aur/folia-major-bin/PKGBUILD 里，想确认行为可以翻一眼。

其他发行版（Ubuntu、Debian 等）：从 Releases 下载同版本的 Linux 便携压缩包，解压到任意目录即可运行：

# 把 Linux 便携版压缩包解压到你习惯的目录，例如 ~/Apps/folia-major tar xzf folia-major-<版本号>-linux-x64.tar.gz

便携包里有可执行文件folia-major和桌面启动项模板，按 packaging/linux/README-LINUX.txt 把模板复制到~/.local/share/applications/、替换掉__APP_PATH__和__ICON_PATH__两个占位符，就能在应用菜单里看到入口了。

⚡ 加速：AUR 构建时会自动从 Releases 拉取 Linux 压缩包，这一步卡住的话，先在网盘下载同版本压缩包，放进 AUR 源码目录再执行makepkg -si本地构建，就能跳过网络等待。

自托管 Web 版：在 NAS 或服务器上跑 Folia

这条路线适合「想在手机浏览器里看全屏歌词」或者家里有 Navidrome 的用户，耗时明显更长，但一次部署多设备共享。

核心动作只有三步：准备一个空目录，放入 Compose 配置和环境变量模板两个文件，然后启动：

# 创建空目录，下载 compose 配置与 .env 模板（详见仓库 deploy/docker/README.md） mkdir folia-docker && cd folia-docker # 把随机生成的 token 填入 .env 的 SYNC_TOKEN 后，启动整个服务栈 docker compose up -d --wait

启动后浏览器访问http://服务器IP:18080就是 Folia Web 界面。完整的目录结构、环境变量说明、QQ 音乐登录态配置都写在 deploy/docker/README.md 里，照着抄即可。移动端可以在 Chrome for Android 或 iOS Safari 里把网页「添加到主屏幕」，获得接近 App 的体验。

装完验证清单：四步确认能用

无论走哪条路线，装完都按这个顺序过一遍：

从应用菜单（或浏览器地址）正常启动 Folia，界面能完整渲染出来。
在「关于」页核对版本号，确认拿到的就是你想装的那一版。
接入音源：登录网易云 / QQ 音乐 / 酷狗，填 Navidrome 地址，或导入本地文件夹建曲库。
播放一首带歌词的歌——歌词动画铺满全屏的那一刻，就说明一切正常。想换视觉风格，去设置里的主题选项切换即可。

疑难杂症：常见卡点问答

Q：下载一直中断或特别慢？A：换国内官方网盘镜像，以 README 的「快速下载」一节为唯一入口。注意网盘只覆盖 Windows 与 Apple silicon 版 macOS；Linux 包请直接走 Releases，或先手动下载压缩包再本地构建 AUR 包。

Q：网盘里的版本比最新版旧？A：网盘镜像通常会滞后于最新发行。下载前把文件名里的版本号与 Releases 页面的最新值比对，不一致就等网盘同步，或直接改走官方直连。

Q：Linux 启动黑屏、透明度异常或闪退？A：九成是 GPU 兼容问题，先用软件渲染验证：

# 以 swiftshader 软件渲染模式启动，确认是否 GPU 兼容问题 FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major

如果仍然不稳定，把swiftshader换成software再试最保守的纯软件渲染。

Q：Linux 便携版解压后，怎么生成桌面启动项？A：把包内resources/linux/folia-major.desktop模板复制到~/.local/share/applications/，将__APP_PATH__、__ICON_PATH__占位符替换为实际路径，再按桌面环境要求把该文件标记为可信，菜单里就会出现 Folia 了。

装完登录一个音源、导入本地曲库或直接点开一首带歌词的歌，第一句歌词就能让整屏亮起来。去挑一个最对味的主题，让全屏歌词替你放歌 🎵

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析