★ FEATURED ARTICLE Folia 歌词动画播放器安装部署指南网盘直装、AUR 一条命令、NAS Docker 3 条路线 10 分钟跑通【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major国内网络从 GitHub Releases 直连基本跑不动。Folia 是一款以全屏歌词动画为核心的本地音乐 / Navidrome / 多平台在线播放器支持网易云、QQ 音乐、酷狗与本地曲库。本文按国内下载、Linux 安装的实际环境把 3 条路线走通装完 10 分钟内放出第一首歌。先对号入座3 个问题定安装路线Q我是什么系统AWindows / macOS 走主路线网盘直接装桌面版Arch 且配好 yay / paru走 AUR 分支Ubuntu、Fedora 等其他 Linux 发行版走便携版分支想在手机或浏览器听、不装本地程序走 NAS Docker 分支。Q我要不要用本地曲库或 NavidromeA要。桌面版最直接浏览器侧的 Web 版本地库功能需要可信 HTTPS 安全上下文否则降级。Q需要能跑构建吗A不需要。官方桌面版与 Web 镜像都内置前后端运行环境装完免配置只有贡献者才需要仓库内的开发脚本。主路线Windows / macOS 网盘直装 4 步走通准备打开仓库 README 的「快速下载」小节复制官方网盘入口夸克、百度提取码flia。官方网盘只提供 Windows 与 Apple silicon 的正式版安装包不含 Linux 包。获取安装包登录夸克 / 百度客户端把安装包转存到自己网盘再下载对应平台的文件Windows 选.exemacOS 选 Apple silicon 版.dmg。 ⚠️ 只认 README 里的官方入口来路不明的第三方转发包一律不要用。安装双击安装包运行。桌面版内置前后端运行环境装完无需配置依赖。首次运行启动 Folia搜索任意歌曲并播放确认歌词渲染为全屏沉浸式动画而不是简单滚动条。分支路线Arch Linuxyay / paru 一条命令装好 folia-major-bin适用场景你在 Arch 上已配置 yay 或 paru希望装完即得应用菜单与升级链路。执行安装命令yay -S folia-major-bin # 或使用 paru paru -S folia-major-bin确认AUR Helper 自动处理alsa-lib、gtk3、nss等依赖应用落在/opt/folia-majorfolia-major命令进 PATH应用菜单生成启动项。包内容与依赖可对照 AUR 包构建文件。⚡ 提速AUR 构建要从 Releases 拉folia-major-版本-linux-x64.tar.gz便携包这一步慢的话先用网盘下载同版本压缩包放进构建目录的srcdir再执行makepkg -si跳过下载。其他 Linux 发行版便携版 4 步部署并创建启动项适用场景Ubuntu / Fedora 等发行版想手动控制安装目录。从网盘或 Releases 拿folia-major-版本-linux-x64.tar.gz解压tar -xzf folia-major-版本-linux-x64.tar.gz得到folia-major可执行文件与resources/目录。运行一次验证./folia-major能正常出界面再继续。复制桌面启动项模板cp resources/linux/folia-major.desktop ~/.local/share/applications/编辑复制后的文件把__APP_PATH__替换为可执行文件绝对路径__ICON_PATH__替换为resources/linux/icon.png的绝对路径桌面环境有要求时把该.desktop标记为可信或可执行。⚠️ 排查任何启动问题前先确认可执行文件和resources/位于同一便携包目录二者被拆开是最高频的坑。NASDocker Compose 拉起 Folia Web 版适用场景想在手机、浏览器或大屏上听歌有一台装了 Docker Engine 24 与 Compose v2 的机器。新建空目录从 Docker 部署目录 下载compose.yaml与环境变量模板.env.example改名为.env两个文件放同一目录。执行openssl rand -hex 32生成令牌把输出填入.env的SYNC_TOKENAI 配置可留空不影响播放。启动并检查docker compose config docker compose up -d --wait docker compose ps打开http://NAS-IP:18080验证 Web 页面Sync Server 健康入口为http://NAS-IP:13000/health。⚠️ 本地音乐目录导入需要可信 HTTPS 安全上下文局域网纯 HTTP 下在线播放与歌词可用本地库功能会降级正式用曲库请让反向代理终止 HTTPS。装完能不能用三问自检能不能播放一首歌并看到歌词动画播放任意歌曲进播放页确认歌词是全屏沉浸式动画可切换歌词动画模式看不同效果。✅能不能登录你打算用的音源打开登录入口确认能登录网易云、QQ 音乐、酷狗或填好 Navidrome 服务器地址并测试连接本地曲库页应出现「Import Folder」入口。✅能不能从系统入口稳定拉起Linux 在应用菜单搜索folia-majorWindows 看开始菜单macOS 看启动台点进去应与手动运行的界面一致。✅出错了先查这里如果你看到 Linux 启动后黑屏、透明度 / 模糊异常或 GPU 崩溃先确认可执行文件与resources/在同目录、弄清自己在 X11 还是 Wayland 下仍不行再改用软件渲染FOLIA_LINUX_GRAPHICS_MODEswiftshader ./folia-major再不稳定则换最保守的FOLIA_LINUX_GRAPHICS_MODEsoftware想回系统图形路径设system。变量全集见 Linux 便携版说明。如果你看到 Web 版页面能打开但本地音乐目录导不进先确认访问地址是可信 HTTPS 安全上下文、浏览器是 Chromium 系仍不行再检查反向代理是否透传X-Forwarded-Proto等头部部署细节见 Docker Compose 全栈部署文档。如果你看到网盘链接失效或版本明显偏旧先回到 README「快速下载」小节拿最新官方入口仍不行再到 Releases 页面自行对照版本号勿用中间人转存的旧包。延伸阅读packaging/linux/README-LINUX.txtLinux 便携版目录结构、全部图形兼容变量与壁纸模式的前置要求。deploy/docker/README.mdDocker 全栈的环境变量、Navidrome 预置账号与 HTTPS 反代配置。docs/technical.mdLinux 包细节、Wayland / Hyprland 遥控窗与桌面端技术说明。按环境挑一条路线照做装完即放歌词动画随第一首歌启动。【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
阅读完成 · 觉得有帮助？
