Folia 全屏歌词播放5 分钟安装指南【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major官方 Releases 页面打开要等好几分钟发行版软件源里又没有 Folia第一次安装 Folia 的人大多卡在下载这一步。Folia 是一款以全屏歌词动画为核心的音乐播放器支持网易云、QQ 音乐、酷狗在线曲库和本地音乐库。这篇指南带你走官方安装包这条路径从零到打开第一首带歌词的歌预计 5 分钟。跑之前先确认环境系统Windows 10、macOS 或 Linux x86_64桌面版是 Electron 应用、内置运行环境缺了 Node.js 等依赖不会报安装错误磁盘2-4 GB 空闲应用与音频缓存会持续增长空间不足安装会失败网络能访问 GitHub或有一条国内网盘渠道Releases 海外下载慢README.md 里有网盘入口兜底账号播放在线歌需要一个网易云、QQ 音乐或酷狗账号没有账号只能听本地曲库Docker可选仅自托管 Web 版需要Docker Engine 24 与 Compose v2只用桌面版可跳过这一项选一条部署路径路径适合谁预计耗时需要额外装什么官方安装包Windows / macOS 用户5 分钟无安装包自包含AUR 包Arch / Manjaro 等 AUR 系发行版约 15 分钟AUR 助手yay 或 paru便携 tar.gz其他 Linux 发行版10 分钟无解压即用Docker Compose自托管 Web 版、浏览器里听15-30 分钟Docker Engine 24 与 Compose v2 网盘镜像README 里提到的夸克 / 百度只同步 Windows 的.exe与 macOS Apple silicon 的.dmgLinux 读者直接走 AUR 或便携版网盘版本可能滞后于官方发布。怎么选Windows 和 macOS 用户直接选官方安装包最省心Arch / Manjaro 用户跑一条 AUR 命令最省事其他 Linux 发行版走便携版想在手机浏览器里听歌再考虑 Docker 部署 Web 版。⚠️ 只使用 README.md 内的下载入口不要下载来路不明的第三方转发包。主路径桌面版安装步骤打开 README.md滚动到「快速下载」一节有官方 Releases 与网盘镜像两个入口。网络好直接走 Releases慢就走网盘。按平台挑文件Windows 选.exemacOS 选.dmgmacOS 注意确认 Apple silicon 版本。下载。一般 3-8 分钟取决于带宽如果超过 10 分钟没动换另一条渠道再下。双击安装包Windows 跟着向导走完即可macOS 把图标拖进 Applications 文件夹。核对版本当前官方版本为0.7.23见 package.json与安装包文件名比对网盘版本更旧就先比对再决定是否替换。从桌面或开始菜单启动 Folia。桌面版内置前后端运行环境无需额外配置主界面是 3D 专辑轮播加顶部搜索框。其他路径一句话入口AUR执行yay -S folia-major-bin自动解析alsa-lib、gtk3、nss等依赖应用落在/opt/folia-major并生成folia-major命令与菜单项包定义见 packaging/aur/folia-major-bin/PKGBUILD。便携版从 Releases 下载最新folia-major-版本-linux-x64.tar.gz解压到自选目录即可运行桌面启动项配置见 packaging/linux/README-LINUX.txt。Web 版Docker用 Docker Compose 自托管Web 默认地址http://NAS-IP:18080完整步骤见 deploy/docker/README.md。跑起来之后先放一首歌在主界面登录入口登录一个在线音乐源。顶部搜索框搜一首带歌词的歌。点播放进入全屏歌词视图看歌词动画跟随节奏走动。想听本地歌进入本地曲库管理导入音频文件同目录.lrc歌词会自动加载。验收标准主界面正在播放歌曲全屏歌词随节奏逐行动画部署就算完成。容易踩的坑现象启动后黑屏、透明度/模糊异常或 GPU 进程崩溃→ 处理用软件渲染启动FOLIA_LINUX_GRAPHICS_MODEswiftshader ./folia-major仍不稳定就改FOLIA_LINUX_GRAPHICS_MODEsoftware恢复系统图形路径设为system。现象AUR 构建卡在 tar.gz 下载或报 404→ 处理AUR 包版本落后于官方最新版。先核对版本号把同版本 tar.gz 预先放进构建源码目录srcdir再执行makepkg -si跳过慢速下载。现象便携版解压后应用菜单里没有启动项→ 处理依次核对.desktop文件是否在~/.local/share/applications/、__APP_PATH__与__ICON_PATH__两个占位符是否已替换为实际路径、文件是否标记为可信或可执行。现象网盘里的版本比预期旧→ 处理网盘镜像滞后于官方发布属正常现象以 Releases 页面版本号比对后再决定是否覆盖替换。接下来可以看deploy/docker/README.mdDocker Compose 自托管 Web 版手机浏览器直接听docs/technical.md技术架构、更新通道与 Wayland / Hyprland 遥控窗细节docs/local-library-management.md本地曲库导入、重扫与歌词匹配细则把歌词动画拉满切一首你最近循环的歌。【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考