Folia 歌词动画音乐播放器完整安装指南桌面与 Docker Web 两条路线一次讲清【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-majorFolia 是一款把歌词渲染成全屏动画的音乐播放器音源覆盖网易云、QQ 音乐、酷狗、Navidrome 以及本地音乐库。这篇安装与部署教程按使用场景拆成桌面、自托管 Web 两条主线Windows、macOS、各发行版 Linux 和 NAS 用户都能按平台快速定位到自己的部分文末还附了 Linux 黑屏这类常见坑的降级排查办法。先定路线桌面、Web 还是 Navidrome 直连选路线只需要问自己一个问题在哪个设备上听在电脑桌面上听、要看全屏歌词动画的话装 Electron 桌面版。它把前后端都打进了同一个安装包装完或解压完就能跑唯一的门槛是三个在线音源都需要先登录各自账号。想在手机浏览器或 NAS 上访问就走自托管 Web 版用 Docker 起一套服务之后浏览器打开地址即可还能把 PWA 直接加到手机桌面当 App 用。这条路不依赖桌面端但在线播放能力取决于你部署的 API 网关能接上哪几家平台。两条路线并不互斥。如果你手头已经有一台 Navidrome 服务器无论桌面版还是 Web 版都能直接把它挂成本地音源连第三方账号都省了。桌面路线按系统取包安装Windows 与 macOS从网盘取安装镜像 打开仓库根目录的 README.md找到「快速下载」一节里面放着夸克网盘和百度网盘提取码flia两个链接国内网络取包比较稳。Windows 用户下载.exe安装包走常规安装流程macOS 用户下载.dmgIntel 与 Apple silicon 是不同文件M 系芯片的机器选对应版本双击运行即可。有两点提前说明网盘镜像里只有 Windows 和 Apple silicon 这两个正式版安装包Intel Mac 和 Linux 都不包含在内而且网盘上的版本有时会落后于最新 release所以下载前最好先到发布页核对一下版本号避免装完才发现旧版缺功能。ArchAUR 助手一条命令装完先确认yay或paru已经装好然后执行yay -S folia-major-bin。助手会自动把 alsa-lib、gtk3、libxss、nss 这几个依赖装上并把程序部署到/opt/folia-major全程不用手动碰包。构建脚本放在 packaging/aur/folia-major-bin/ 目录下本质上做的事是从 Releases 拉folia-major-版本-linux-x64.tar.gz再在本地打包。这里有个容易卡住的点如果你的网络连 Releases 很慢构建会停在下载阶段长时间没反应——这种情况不用反复重试 AUR直接按下面的便携版方式手动部署就行。其他 Linux便携版手动部署Debian、Ubuntu 这类发行版没有现成包走便携版最省事从 Releases 页面下载linux-x64.tar.gz解压到一个固定目录比如~/Apps/Folia/之后别再挪位置。把包内resources/linux/folia-major.desktop复制到~/.local/share/applications/。用文本编辑器打开复制出来的文件把__APP_PATH__和__ICON_PATH__两个占位符替换成实际绝对路径前者指向解压目录里的可执行文件后者指向图标。保存后打开应用菜单folia-major就能搜到并启动了。占位符的完整替换示例在 packaging/linux/README-LINUX.txt 里照着对照即可。装完就验证登录、看歌词、确认动画安装动作结束不等于装好了当场验证一遍再收工打开应用在首页搜索平台名网易云 / QQ / 酷狗完成登录不想登录的话直接在本地音乐库里导入一个音频目录也行。播放任意一首歌确认歌词是全屏渲染的。Folia 的核心卖点就是内置的多套歌词动画主题而且每首歌还能调用 AI 按歌曲情绪自动生成一套配色背景这个效果在播放页能直观看到。顺手检查本地歌曲的歌词目录同名的.lrc/.vtt文件会被自动识别使用缺歌词或缺封面的本地歌曲程序也会自动尝试在线补全。Web 路线Docker 部署自托管栈 适合挂在 NAS 或一台常开的 Linux 机器上全家设备通过浏览器访问。准备一个空目录把 deploy/docker/ 里的compose.yaml和环境变量模板放进去模板改名为.env。接着生成一个随机串运行openssl rand -hex 32把输出填入.env里的SYNC_TOKEN。这个值是同步服务的必填项缺了它同步功能起不来所以别跳过。然后执行docker compose up -d启动浏览器访问http://你的地址:18080就能看到 Web 端首页手机浏览器里把它添加到主屏幕即可当 PWA 使用。每个环境变量的含义、各服务端口规划、Navidrome 预置账号的填法等细节都写在 deploy/docker/README.md 里按需查阅。应急Linux 黑屏、模糊、透明度异常的降级顺序 Linux 桌面端启动后出现黑屏、画面模糊或透明度不对绝大多数情况是 GPU 渲染路径出了问题按下面顺序降级即可FOLIA_LINUX_GRAPHICS_MODEswiftshader ./folia-major FOLIA_LINUX_GRAPHICS_MODEsoftware ./folia-major先试第一行的软件光栅化模式画面还不稳再退到第二行最保守的纯软件模式。排查过程中记得确认可执行文件与resources/目录确实位于同一个便携包内路径拆散也会引发类似症状。需要留意的是这组环境变量只作用于 Linux 桌面端的启动参数不会改动 Web 版或同步服务的任何配置。装到这一步第一首歌应该已经在你屏幕上铺开了。关于部署差异、遥控窗、Wayland 壁纸模式这些更深的机制可以继续往 docs/technical.md 里挖。【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考