Folia 歌词动画音乐播放器快速安装指南桌面与 NAS 全流程【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-majorFolia 是一款把歌词渲染成全屏沉浸式动画的音乐播放器可接入网易云、QQ 音乐、酷狗、Navidrome 与本地曲库。本文按机器类型给出 4 套安装方案Windows 与 macOS 桌面 3 步、Arch 一条命令、其他 Linux 便携版 3 步、NAS 上 Docker 自托管 4 步全程不超过 30 分钟。两问定位你的路线动手前先回答两个问题就能锁定唯一该走的方案这台机器有屏幕、当桌面用还是无头的服务器 / NAS——前者装桌面版后者走 Docker 自托管。你的 Linux 发行版是 Arch 吗——是AUR 一条命令装完不是解压便携版后手动补启动项。各方案依赖的运行环境已并入下方对应小节的「① 你需要」不需要预先统一备货。Arch 一条命令装 folia-major-bin① 你需要配好的 AUR Helperyay 或 paru能访问 GitHub Releases 的网络构建时要拉取预构建包② 操作步骤安装 AUR 包yay 与 paru 二选一版本同步由 packaging/aur/folia-major-bin/update.sh 维护yay -S folia-major-bin # paru 用户替换成 paru -S folia-major-bin构建完成后程序落盘到/opt/folia-major桌面启动项自动注册无需再配。③ 如何判断成功终端直接运行folia-major能拉起主界面应用菜单出现 folia-major 图标。播放任意一首歌歌词渲染为全屏动画窗口随歌曲切换主题。⚡ AUR 构建需要下载folia-major-版本-linux-x64.tar.gz网速慢时先把同版本压缩包经网盘转存放进构建源码目录再手动执行makepkg -si跳过下载。alsa-lib、gtk3、libxss、nss 四个运行依赖由 AUR Helper 构建时自动装好打包逻辑见 packaging/aur/folia-major-bin/PKGBUILD。Windows 与 macOS网盘直装桌面版① 你需要夸克或百度客户端账号官方入口README.md「快速下载」小节夸克网盘或百度云提取码flia导入本地音乐时曲库目录需可写② 操作步骤打开 README.md「快速下载」小节复制官方网盘链接夸克网盘或百度云提取码flia。⚠️ 第三方转发包可能夹带旧版本或篡改内容只认官方入口。登录夸克或百度客户端把安装包转存到自己的网盘再下载到本地。运行安装包Windows 为.exemacOS 为.dmgApple silicon 选对应版本装完直接启动。③ 如何判断成功开始菜单 / 应用菜单出现 folia-major 启动项点它能打开主界面。播放任意一首歌歌词渲染成全屏沉浸式动画窗口主题随歌曲切换。网易云、QQ 音乐、酷狗、Navidrome 与本地曲库各登录 / 导入成功一次来回切换不报错。导入目录里的歌曲自动读取了元数据与同名.lrc歌词。其他 Linux便携版三步补齐启动项适合 Ubuntu、Debian、Fedora 等发行版。Linux 便携版解压后包含folia-major可执行文件、resources/linux/icon.png图标与resources/linux/folia-major.desktop启动项模板完整说明见 packaging/linux/README-LINUX.txt。① 你需要Linux 便携版压缩包解压权限以及写~/.local/share/applications/的权限② 操作步骤解压到固定目录先手动跑一遍确认可执行./folia-major # 确认可执行文件与 resources/ 同目录把启动项模板复制进用户应用目录cp resources/linux/folia-major.desktop ~/.local/share/applications/folia-major.desktop编辑复制出的folia-major.desktop__APP_PATH__替换为folia-major可执行文件的绝对路径__ICON_PATH__替换为resources/linux/icon.png的绝对路径桌面环境若有要求再将该.desktop标记为可信。③ 如何判断成功应用菜单出现 folia-major 图标点击可正常拉起主界面。播放任意一首歌全屏歌词动画正常渲染、窗口随歌曲切换主题。NAS 上 Docker 安装 Web 版适合无桌面环境的 NAS 或服务器完整部署文档见 deploy/docker/README.md。对外的端口只有两个Web 网关默认 18080Sync Server 默认 13000。① 你需要Docker Engine 24 与 Docker Compose v2网易云、QQ 音乐、酷狗至少一个账号Navidrome 需要自己的服务器地址② 操作步骤新建空目录只取 Compose 与环境变量模板两个文件模板即 deploy/docker/.env.examplemkdir folia-docker cd folia-dockercurl -fL https://raw.githubusercontent.com/chthollyphile/folia-major/main/deploy/docker/compose.yaml -o compose.yamlcurl -fL https://raw.githubusercontent.com/chthollyphile/folia-major/main/deploy/docker/.env.example -o .env生成同步令牌把输出填入.env的SYNC_TOKEN至少 8 位openssl rand -hex 32验证配置并启动容器docker compose config docker compose pull docker compose up -d --wait浏览器访问http://NAS-IP:18080打开 Folia Web。③ 如何判断成功docker compose ps显示全部容器 running。浏览器打开http://NAS-IP:18080能看到首页。http://NAS-IP:13000/health返回健康.env中SYNC_TOKEN已生效。出错了怎么办现象Linux 启动后黑屏、透明度 / 模糊异常或 GPU 崩溃可能原因系统图形栈与渲染路径不兼容处理改用软件渲染模式启动更多取值见 packaging/linux/README-LINUX.txtFOLIA_LINUX_GRAPHICS_MODEswiftshader ./folia-major仍不稳定再换FOLIA_LINUX_GRAPHICS_MODEsoftware ./folia-major现象网盘链接失效或版本太旧可能原因使用了非官方渠道的转存处理以 README.md「快速下载」小节的官方入口为准再回 Releases 页面核对版本号。现象GitHub Releases 下载慢甚至断流可能原因当前网络访问海外 CDN 受阻处理Windows 与 Apple silicon 改走官方网盘Arch 用户先把同版本folia-major-版本-linux-x64.tar.gz经网盘转存放进构建源码目录再makepkg -si。现象装完桌面版应用菜单里没有启动项可能原因.desktop内路径写错或文件未标记可信处理检查~/.local/share/applications/folia-major.desktop的路径是否与实际文件位置一致并按桌面环境要求把该文件标记为可信或可执行。按机器对号入座桌面走网盘或 AUR无头设备走 Docker30 分钟内全部完成。桌面端细节、Wayland 与遥控窗口见 docs/technical.mdLinux 渲染模式的更多取值见 packaging/linux/README-LINUX.txt。【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考