Folia 安装指南把全屏歌词动画播放器装到你电脑和 NAS 上【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-majorFolia 是一款把歌词渲染成全屏沉浸式动画的音乐播放器支持本地音乐库、Navidrome 以及网易云、QQ 音乐、酷狗等在线音源。这篇教程带你从零把它跑起来桌面端装到 Windows / macOS / Linux或者用 Docker 自托管出一个浏览器可访问的 Web 端。桌面路线一般 10 分钟内完成Docker 路线约半小时。先选路线在 Windows、macOS 或 Linux 上本地使用看下面对应系统的小节下载官方预编译安装包即可。想用浏览器访问或部署到 NAS / 服务器走 Docker 自托管一节对外暴露 Web 网关与 Sync Server 两个端口。用 Arch / EndeavourOS优先 AUR一条命令装好依赖和桌面启动项。下载 Windows 安装包并运行适用Windows 桌面装完即用。从官方 Releases 页面下载Folia-Setup-版本.exe。国内网络慢时改走 README「快速下载」一节的官方网盘夸克 / 百度建议先转存再下载中断可续传。双击运行向导允许修改安装目录一路确认。装完从开始菜单启动前后端运行环境已内置无需另装 Node.js 等依赖。⚠️ 现象装完发现版本号比 Releases 最新值旧。原因网盘镜像通常滞后。处置比对文件名里的版本号直接下官方最新包。按芯片选 macOS 的 dmg适用Apple silicon 或 Intel Mac 本机使用。先按「关于本机」确认芯片。Apple silicon 下载Folia-版本-arm64.dmgIntel 下载Folia-版本-x64.dmg。官方网盘只有 arm64 版Intel Mac 必须走 Releases。打开 dmg把Folia.app拖进Applications不要在挂载盘里直接运行。首次打开若提示「应用已损坏」或「无法验证」这不是损坏是缺少 Apple Developer ID 签名被 Gatekeeper 拦截。在终端执行xattr -dr com.apple.quarantine /Applications/Folia.app执行后从Applications重新打开。 macOS 版暂不支持应用内自动更新。每次覆盖安装新 dmg 后都要再跑一次上面的xattr命令。更多原理见 docs/desktop/macos-app-damaged.md。解压 Linux 便携包或走 AUR适用Ubuntu、Debian、Fedora 等发行版的便携版Arch 系走 AUR。便携版非 Arch 系从 Releases 页面下载folia-major-版本-linux-x64.tar.gz解压到任意目录。在该目录直接运行./folia-major。需要桌面启动项时把包内resources/linux/folia-major.desktop复制到~/.local/share/applications/将其中的__APP_PATH__、__ICON_PATH__替换为可执行文件和icon.png的绝对路径再按桌面环境要求标记为可信。细节见 packaging/linux/README-LINUX.txt。AURArch / EndeavourOSyay -S folia-major-bin⚠️ 现象启动后黑屏、透明度异常或 GPU 崩溃。原因图形路径与当前显卡不兼容。处置先用FOLIA_LINUX_GRAPHICS_MODEswiftshader ./folia-major验证仍不稳定再改用FOLIA_LINUX_GRAPHICS_MODEsoftware。X11 下 WebGPU 不可用时可加FOLIA_LINUX_VULKAN1 ./folia-major --ozone-platformx11原生 Wayland 下不要开 Vulkan。用 Docker 在 NAS 上自托管 Web 端适用想让手机、浏览器都能访问 Folia不在桌面使用。要求 Docker Engine 24 与 Compose v2。新建空目录从仓库的 deploy/docker/ 把compose.yaml与.env模板放进同一目录。用openssl rand -hex 32生成随机串填入.env的SYNC_TOKEN必填至少八位。执行docker compose config检查配置再docker compose up -d --wait启动。浏览器访问http://NAS-IP:18080进入 Web 端http://NAS-IP:13000/health检查 Sync Server。本地音乐目录的访问依赖可信 HTTPS 安全上下文NAS 上需要自行配置反向代理与证书变量含义、健康检查入口等完整说明见 deploy/docker/README.md。装好了吗验收清单启动 Folia在设置里的「帮助」页核对版本号与下载文件名一致以 Releases 页面为准。登录一个在线音源网易云 / QQ / 酷狗或导入一个本地音乐文件夹列表能正常出歌。播放一首带歌词的歌能进入全屏歌词动画且渲染正常。装不上时先看这 5 条下载一直中断或特别慢→ 网盘镜像只覆盖 Windows 与 Apple silicon Mac这两类直接换官方网盘Intel Mac 与 Linux 包继续走 Releases。macOS 提示「Folia.app 已损坏」→ 缺 Apple 签名被 Gatekeeper 拦截执行xattr -dr com.apple.quarantine /Applications/Folia.app后重新打开。macOS 15 起「按住 Control 点击打开」的绕过方式已失效别在这上面花时间。Linux 启动黑屏或闪退→ 图形兼容问题按上文顺序换swiftshader、software两个FOLIA_LINUX_GRAPHICS_MODE值重试。装出来的版本对不上最新 Release→ 网盘镜像与 AUR 包都会滞后下载前把文件名里的版本号与 Releases 页最新值比对。dmg 打不开、解压中途报错→ 多半是下载中断导致文件不完整重新下载一次并确认你运行的是拖进Applications的正式应用不是 dmg 挂载盘里的临时副本。Docker 起不来→ 先docker compose config看.env是否漏填SYNC_TOKEN再检查 Docker 版本是否满足 24。下一步打开 README.md 的「快速下载」小节按你的系统取对应安装包部署后想配置跨设备同步主题再回看 deploy/docker/README.md 的环境变量一节。【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考