Folia 全屏歌词播放器安装教程：Windows、macOS、Linux 与 NAS 从 0 到跑通

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

受够了屏幕底下那条小歌词栏？Folia 就是答案。它把歌词渲染成全屏沉浸式动画，背景主题还会随歌曲自动切换。本文覆盖 Windows/macOS、Arch、其他 Linux 与 NAS Docker 四条安装路线，跟着做 30 分钟内装完。

先按你的机器选对安装包

四条路线不用挨个试，看机器直接选：

不管走哪条，安装包都从仓库 README「快速下载」小节拿。⚠️ 只认那里的官方入口，第三方转包内容没法核实，别冒险。

Windows 与 macOS：双击安装拿到全屏歌词

桌面版内置前后端运行环境，不编译、不碰依赖。

做什么：打开 README 的「快速下载」小节，拿最新安装包。Windows 是.exe，macOS 是.dmg，Apple silicon 机器选对应版本。装完直接启动。

✅ 验证：开始菜单或应用程序里出现 folia-major 入口，点它能打开主界面。装好的主界面长这样：

卡住了怎么办：

• 下载慢或断流：换 README 里的网盘入口（夸克或百度），只提供 Windows 与 Apple silicon 正式版。
• 启动后内容像旧版：回 README「快速下载」核对版本号，确认拿的是最新安装包。

Arch：一条命令装完 Folia

AUR 包folia-major-bin从 Releases 拉预构建的 linux-x64 压缩包。alsa-lib、gtk3、libxss、nss 四个运行依赖由 AUR Helper 自动装好，打包逻辑见 PKGBUILD。

做什么，一条命令装完：

yay -S folia-major-bin # paru 用户把 yay 换成 paru

结束后程序落在/opt/folia-major，启动项一并注册。

✅ 验证：终端敲folia-major能启动；应用菜单出现 folia-major 图标。

卡住了怎么办：AUR 构建要从 Releases 下载folia-major-<版本>-linux-x64.tar.gz。网络差就先网盘转存同版本压缩包，放进构建源码目录，再手动跑makepkg -si，跳过慢速下载。

其他 Linux：便携版解压即跑

适合 Ubuntu、Debian、Fedora。便携包含三样东西：folia-major可执行文件、图标、桌面启动项模板，都在resources/linux/下，完整说明见 README-LINUX.txt。

做什么：把压缩包解压到固定目录，先手动确认能跑，再把启动项模板复制到用户应用目录：

./folia-major # 首次运行，确认可执行 cp resources/linux/folia-major.desktop ~/.local/share/applications/

然后编辑复制出的folia-major.desktop，改两处：__APP_PATH__换成语句的可执行文件绝对路径，__ICON_PATH__换成resources/linux/icon.png的绝对路径。桌面环境有额外要求时，把这个文件标记为可信。

✅ 验证：应用菜单出现 folia-major 图标，点它能正常拉起主界面。到这里基本就成了。

卡住了怎么办：启动遇到黑屏、模糊异常或 GPU 崩溃，改用软件渲染启动：

FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major # 仍不稳定就改 software

NAS 与服务器：Docker 四步上线 Folia Web 版

适合没有桌面环境的机器。对外只开两个端口：18080 是网页，13000 是同步服务。其余服务只在 Docker 网络内部互通。

做什么：新建一个空目录，从仓库deploy/docker/拿两个文件进去：compose.yaml和.env.example（后者改名为.env）。手上没有仓库就先克隆：https://gitcode.com/GitHub_Trending/fo/folia-major

生成一段随机串当同步令牌，粘进.env的SYNC_TOKEN：

openssl rand -hex 32 # 输出即令牌，要求至少 8 位

接着校验配置、拉镜像、起容器并检查状态：

docker compose config && docker compose pull && docker compose up -d --wait docker compose ps # 容器应全部 running

✅ 验证：浏览器访问http://NAS-IP:18080，能看到 Folia 主界面；http://NAS-IP:13000/health返回健康。

Web 版在浏览器里的界面与桌面版一致，在线音乐搜索、播放都可用：

关键参数速查（其余都在.env模板里，不懂用途就别动）：

⚠️ 打算用本地曲库的话，裸http://NAS-IP不属于浏览器安全上下文，目录导入会不可用。先让 NAS 反向代理终结 HTTPS 再访问，细节见 deploy/docker/README.md。

第一次播放：把这几项全打勾

装完之后逐项过一遍，全部打勾才算装完：

• 按下播放，歌词铺满整个屏幕，呈沉浸式动画
• 网易云、QQ 音乐、酷狗或 Navidrome 至少登录成功一次，来回切换不报错
• 导入本地音乐目录，元数据与同名.lrc歌词自动加载
• 桌面版：应用菜单有 folia-major 入口，点它程序能拉起
• Docker：SYNC_TOKEN生效，/health返回健康

本地曲库导入成功后，页面长这样：

全部打勾之后，可以打开 AI 主题生成，让背景跟着歌曲情绪走，或试试壁纸模式，用法见 技术与开发说明。本地曲库的匹配、歌单与缓存细节在 本地音乐库管理。

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