Folia 全屏歌词播放器安装部署指南：十分钟装完就能放歌（Windows / macOS / Linux）-迪斯科星球

Folia 全屏歌词播放器安装部署指南：十分钟装完就能放歌（Windows / macOS / Linux）

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

Folia 是一个把歌词做成全屏动画的音乐播放器，解决"歌在放、屏幕却是空的"这件事：歌词会铺满整块屏幕，还能按歌曲情绪生成 AI 主题配色。它支持网易云、QQ 音乐、酷狗等在线音源，也能接 Navidrome 和自己的本地音乐文件夹。本文覆盖 Windows / macOS / Linux 三端桌面安装，外加 AUR 与 Docker / Web 两条进阶路线，装完能不能用，十分钟见分晓。

先定路线：对照环境挑该下的文件

你的环境	推荐路径	预计耗时
Windows 64 位	下载 .exe 安装包，官方网盘镜像可选	约 5 分钟
macOS Apple silicon	下载 .dmg，拖进 Applications	约 5 分钟
macOS Intel	仅 Releases 页有对应 .dmg	约 5 分钟
Linux x86_64 / ARM	下载 .tar.gz，解压直接运行	约 10 分钟
Arch / Manjaro	AUR 一条命令装 folia-major-bin	约 10 分钟
NAS / 手机	Web 部署（Docker 或托管平台），浏览器访问	30 分钟起

网盘镜像只覆盖 Windows 与 Apple silicon 的正式版，Intel Mac 和 Linux 的包只能在 Releases 页拿。

路线选择：桌面版还是 Web 部署

桌面版适合绝大多数人：安装包把前后端运行环境都打进了里面，装完即用，不需要 Node.js，也不需要任何开发工具。
Web 部署适合两类场景：想在浏览器里直接听，或把页面加为 PWA（可安装到手机主屏的网页应用）后当 App 用。
本文主线走桌面版，Web 部署的核心命令收在后面的进阶路线里。

下载核对：版本对不上就别急着装

以 Releases 页最新标注为准，核对下载文件名里的版本号；对不上就等镜像同步，或改回 Releases 页重新下。
国内网络直连下载容易断流，Windows 与 Apple silicon 用户优先走官方网盘镜像。
Linux 的 .tar.gz 没有镜像，下完确认能正常解压，目录里应有folia-major可执行文件和resources/目录。

安装部署：Windows 安装、macOS 拖拽安装、Linux 解压运行

三选一，动作都很轻：
- Windows 安装：双击 .exe，安装向导保持默认选项一路走完即可。
- macOS 拖拽安装：打开 .dmg，把 Folia 拖进 Applications 文件夹。
- Linux 解压运行：.tar.gz 解压到任意目录，终端进入该目录后运行./folia-major。
Windows 看开始菜单、macOS 看启动台，有图标就说明装到了位。
Linux 需要手动配启动项：参照 README-LINUX.txt，把.desktop模板复制到~/.local/share/applications/，将__APP_PATH__、__ICON_PATH__两个占位符替换成实际绝对路径，按桌面环境要求标记可信。

Linux 解压运行后，主界面长这样：

首次启动验证：登录音源，点亮全屏歌词动画

启动 Folia，登录一个在线音源（网易云 / QQ 音乐 / 酷狗），或导入一个本地文件夹；有 Navidrome 的话在设置里填地址接入。
随便挑一首带歌词的歌播放。
屏幕被歌词动画铺满、歌词跟着节拍动起来，验证通过。

进阶路线：AUR 安装与 Docker / Web 部署

Arch / Manjaro：AUR 安装一条命令，yay -S folia-major-bin（paru 用户把yay换成paru），依赖自动解决；依赖清单和安装位置见 PKGBUILD。
NAS / 群晖 / 自建服务器：Docker Compose 全栈部署，容器起完浏览器访问http://NAS-IP:18080，完整配置见 deploy/docker/。
手机：Web 版部署后，在 Chrome / Safari 里把页面"添加到主屏幕"，即可当 PWA 用。

冒烟测试：全屏歌词动画亮不亮，四项全过才算装好

🏷️ 版本：「关于」页显示的版本号，和安装包文件名里的一致
🔑 音源：成功登录一个在线音源，或本地 / Navidrome 能列出歌曲
🎤 歌词：播放带歌词的歌，全屏歌词动画正常亮起、逐字滚动
🎨 主题：切换两三个歌词主题，排版和背景都能正常换

四项都对上，就可以当日常主力播放器用了。

高频问题：断流、拿错包、黑屏

Q：下载总是断流？

A：换官方网盘镜像，取回后重新核对版本。注意镜像只有 Windows 与 Apple silicon 的正式版，Linux 包还是走 Releases 页。

Q：装完打不开，怀疑拿错包？

A：Intel 与 Apple silicon 的 .dmg 不通用，Linux x86_64 与 ARM 的 .tar.gz 也不通用。回 Releases 页对照文件名逐字核对，重新下载。

Q：Linux 启动黑屏或闪退？

A：多半是显卡兼容问题，先怀疑 GPU。用软件渲染验证：FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major；仍不稳定就改用FOLIA_LINUX_GRAPHICS_MODE=software。

Q：本地歌曲没有歌词？

A：把同名.lrc歌词文件放到音频同目录即可自动识别；连了在线音源时也会自动匹配，匹配不准可在播放页手动改。

挑一首你存了很久、带逐字歌词的歌，让整块屏幕先亮起来。

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

企业官网建设流程全解析