Folia 安装指南五种路线一次装对桌面到 NAS 全打通【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major先回答一道选择题你打算在哪里听 Folia答案只有两种——本机桌面或者NAS / 服务器上的浏览器。这道题决定路线别选反了。Folia 是一款全屏歌词动画播放器本地音乐库能导入网易云、QQ 音乐、酷狗等在线音源也能直接搜来播放歌词会铺满整块屏幕做沉浸动画。它有两个形态——Electron 打包的桌面版Windows、macOS、Linux和跑在浏览器里的 Web 版。桌面版内置前后端运行环境装完即用Web 版面向多设备访问适合部署在 NAS 上。本文当前仓库版本为 0.7.23实际文件名请以 Releases 页面为准。选路线一张表看懂五种安装路径安装路径覆盖范围适合谁Folia-Setup-版本.exe仅 Windows不想碰命令行的桌面用户Folia-版本-arm64.dmg/Folia-版本-x64.dmg仅 macOS按芯片选包dmg 拖进 ApplicationsAUR 包folia-major-bin仅 Arch / EndeavourOS想要菜单启动项和自动依赖的 Arch 用户folia-major-版本-linux-x64.tar.gz所有 x64 LinuxUbuntu、Debian、Fedora 等一切非 Arch 发行版Docker Compose 全栈任意 Docker 宿主要手机、平板、电脑在浏览器里同时访问的人国内网络直连 GitHub Releases 困难时README「快速下载」一节提供了夸克 / 百度两个网盘入口。注意网盘只镜像了 Windows 安装包和 Apple silicon 的 dmgIntel Mac 与 Linux 包必须走 Releases下载前先核对文件名里的版本号。省装完想快速感受效果播放任意带歌词的歌再点全屏按钮流光Lumi这类主题最直观。Windows下 exe跑完安装向导下载。去 Releases 页面拿Folia-Setup-版本.exe直连慢就改用官方网盘。网盘用户建议先把文件转存进自己的网盘空间再拉下来中途断了能续传。安装。双击后是标准 NSIS 向导安装目录可以改其余一路确认。程序本身携带全部运行环境不需要单独装 Node 或 Electron。启动。装完从开始菜单点开桌面端细节Wayland 遥控窗等见 Linux 与桌面端技术说明。坑只装官方渠道的分发文件。来路不明的第三方转包一律不要碰。macOS先认芯片再挑 dmg下载。点「关于本机」确认芯片Apple silicon 拿Folia-版本-arm64.dmgIntel 拿Folia-版本-x64.dmg。记住一点——网盘只有 arm64 版Intel Mac 只能走 Releases。安装。打开 dmg把Folia.app拖进Applications之后关掉挂载盘只运行 Applications 里的正式应用。启动。首次打开如果弹出「已损坏」或「无法验证」这不是真的坏了应用缺少 Apple Developer ID 签名被 Gatekeeper 拦下。终端执行下面这条命令再重新打开即可xattr -dr com.apple.quarantine /Applications/Folia.app更完整的原理和「隐私与安全性」备选操作见 macOS 提示应用已损坏的处理文档。坑macOS 版暂时不支持应用内自动更新每次覆盖安装新版 dmg 后上面那条xattr命令都要再跑一次。Arch 系AUR 一行命令装 folia-major下载 安装合并成一条命令。确认已装 yay 或 paruyay -S folia-major-binparu 用户把包管理器换成paru -S folia-major-bin即可。构建完成后alsa-lib、gtk3、libxss、nss四个依赖自动解决程序放进/opt/folia-major菜单启动项一并生成启动时直接点图标。坑这个包是基于预编译 Release 打出来的PKGBUILD版本通常比最新发行慢半拍构建时还要从 Releases 拉 Linux 压缩包。网络慢就先手动下载同版本folia-major-版本-linux-x64.tar.gz放进源码目录再执行makepkg -si。其他 Linux便携 tar.gz解压即播下载。Releases 页面拿folia-major-版本-linux-x64.tar.gz。安装。解压到任意目录包里三样东西folia-major可执行文件、resources/linux/icon.png、resources/linux/folia-major.desktop。要桌面启动项的话把.desktop复制到~/.local/share/applications/把里面的__APP_PATH__和__ICON_PATH__换成可执行文件和图标文件的绝对路径再按桌面环境要求标记为可信。完整说明见 Linux 便携版说明。启动。./folia-major坑启动黑屏、透明度异常或 GPU 进程崩溃先换渲染路径FOLIA_LINUX_GRAPHICS_MODEswiftshader ./folia-major还不行就切到最保守的软件渲染把值改成software。X11 下如果「智能动感模式」提示没有可用的 WebGPU可以手动开 VulkanFOLIA_LINUX_VULKAN1 ./folia-major --ozone-platformx11。原生 Wayland 下别开 Vulkan那个变量会被忽略开了反而容易崩。Docker 自托管把 Folia 装进 NAS这一节给想让手机和电脑都打开同一个 Folia 的人。要求 Docker Engine 24 与 Compose v2完整细节见 Docker Compose 全栈部署文档。下载。不拉源码只在一个空目录里放两个文件compose.yaml和.env模板README「获取方式」给了下载地址。安装。先生成同步令牌再填进.env的SYNC_TOKENopenssl rand -hex 32然后验证配置并启动docker compose config docker compose up -d --wait启动与访问。浏览器打开http://NAS-IP:18080就是 Web 端http://NAS-IP:13000/health用来确认 Sync Server 活着。网易云、酷狗、QQ 音乐接口都没有对外端口全部走 gateway 转发这是刻意的安全设计。坑局域网 IP 上的普通 HTTP 不属于浏览器安全上下文本地音乐目录导入等功能会不可用。正式用本地曲库的话让 NAS 的反向代理终止 HTTPS证书链必须完整合法再把绑定地址收到127.0.0.1。AI 配置留空即可不影响播放。装好之后的验收清单启动 Folia在「关于」页核对版本号应与你下载的文件名一致。登录一个在线音源网易云 / QQ / 酷狗或导入一个本地音乐文件夹。播放一首带歌词的歌进入全屏歌词动画确认渲染正常、不卡帧。三条都过安装就算完成。出问题时按症状对号入座下载一直断或慢得离谱。先试Windows 和 Apple silicon Mac 用户直接切官方网盘支持断点续传。还不行Intel Mac 与 Linux 用户改走 Releases挑网络空闲时段拉Arch 用户也可以先手动下好 tar.gz 再本地构建 AUR 包。macOS 弹窗说应用已损坏。先试终端跑xattr -dr com.apple.quarantine /Applications/Folia.app后重新打开。还不行确认你运行的是Applications里的应用而不是 dmg 挂载盘里的临时副本文件不完整就重新下载一次。Linux 黑屏、透明效果发虚、GPU 进程闪退。先试FOLIA_LINUX_GRAPHICS_MODEswiftshader前缀启动。还不行换成software跑通再说。若只是 X11 下 WebGPU 不可用按上文加FOLIA_LINUX_VULKAN1参数Wayland 下忽略此条。装出来的版本号比最新 Release 旧。先试把文件名里的版本号与 Releases 页最新值对比不一致就直接下官方最新包。还不行网盘镜像和 AUR 包天然滞后别在旧渠道上反复试AUR 用户手动下 tar.gz 本地构建最快。现在按你的系统回到「选路线」那张表把对应的压缩包或镜像拖进手里——Windows 装向导、macOS 拖应用、Linux 敲回车、NAS 跑 compose验收清单三条全绿全屏歌词动画就是你的了。【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
