Folia 安装完整指南四条路线快速装好全屏歌词动画播放器【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-majorFolia 是一款把歌词渲染成全屏沉浸动画的桌面播放器能接本地音乐库也能登录网易云、QQ 音乐、酷狗在线音源。这篇 Folia 安装教程只解决一件事把安装包下载到你的机器并跑起来。顺利的话十来分钟就能装完。先确认你走哪条路线动手前先问自己三个问题你在什么系统上Windows、macOS、Linux 各走各的包Linux 用户再细分一步——Arch 系Arch / EndeavourOS走 AUR其他发行版走便携压缩包。Mac 是什么芯片点左上角「关于本机」看是 Apple siliconarm64还是 Intelx64两种芯片的安装包文件名不同选错了装不了。能不能直连官方 Releases 页直连没问题的话版本最新、平台最全直连慢或断流时Windows 和 Apple silicon Mac 用户有官方网盘夸克 / 百度兜底但网盘只有这两个平台的包且通常只收 Windows 与 arm64 Mac 的正式版。四条路线速览对号入座即可官方 Releases 直连——Windows / macOS / Linux 全覆盖版本最新约 10-20 分钟。官方网盘镜像——只覆盖 Windows 和 arm64 Mac国内直连快、支持断点续传约 5-10 分钟。建议先把文件转存到自己网盘再下载。AUR 包folia-major-bin——Arch / EndeavourOS 专用一条命令装完约 3-5 分钟但版本通常落后官方发行。Docker Web 自托管——面向 NAS / 服务器让手机和浏览器都能访问30 分钟起步。仓库版本目前是 0.7.23但具体下哪个包永远以官方 Releases 页最新一条为准。桌面安装Folia Windows 安装下载 exe 跑完向导去哪下去 Releases 页拿Folia-Setup-版本.exe走网盘的话拿同名文件记得先转存再下载中途断了也能续传。怎么装双击安装程序这是 NSIS 向导中途可以修改安装目录其余一路确认即可。桌面版把前后端运行环境都打进了包里装完从开始菜单启动就行不用额外装运行时。容易卡住只装官方渠道的分发文件网上来路不明的转发包一律不碰。Folia macOS 安装按芯片选 dmg再拖进 Applications去哪下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原理和「隐私与安全性」的备选方案写在仓库的 docs/desktop/macos-app-damaged.md。 另一个要记住的点macOS 版目前不支持应用内自动更新以后每次用新 dmg 覆盖安装都要把这行xattr命令重跑一遍。Folia Linux 安装便携包与 AURUbuntu / Debian / Fedora便携版 tar.gz 直接启动去哪下从 Releases 页拿folia-major-版本-linux-x64.tar.gz。怎么装解压到任意目录进目录直接启动./folia-major想生成桌面启动项的话把包内的resources/linux/folia-major.desktop复制到~/.local/share/applications/再把模板里的__APP_PATH__和__ICON_PATH__两个占位符替换为可执行文件和resources/linux/icon.png的绝对路径最后按你的桌面环境要求把这个启动项标记为可信即可。完整说明和图形环境变量参考 packaging/linux/README-LINUX.txt。Arch 系 AUR一条命令装完装好 yay 或 paru 之后执行yay -S folia-major-binparu 用户把命令换成paru -S folia-major-bin即可。构建过程会自动解决alsa-lib、gtk3、libxss、nss四个依赖程序装进/opt/folia-major并生成菜单启动项。⚠️ 这个 AUR 包是基于预编译 Release 打的包依赖清单见 packaging/aur/folia-major-bin/PKGBUILD所以版本一般落后官方最新发行。如果你的网络拉 Releases 很慢可以先把同版本的folia-major-版本-linux-x64.tar.gz手动下好放进 AUR 源码目录再执行makepkg -si本地构建。Linux 图形排障启动后黑屏、透明度异常或直接闪退多半是 GPU 兼容问题。按这个顺序试FOLIA_LINUX_GRAPHICS_MODEswiftshader ./folia-major FOLIA_LINUX_GRAPHICS_MODEsoftware ./folia-majorX11 环境下如果 WebGPU 不可用可以用 Vulkan 路线替代FOLIA_LINUX_VULKAN1 ./folia-major --ozone-platformx11注意原生 Wayland 下不要开这个 Vulkan 选项只针对 X11 使用。让手机和浏览器也能访问Docker Web 自托管桌面版只能在本机用想让手机、浏览器都能访问就把 Folia 部署成 Web 服务跑在 NAS 或服务器上。具体步骤按 deploy/docker/README.md 的说明新建一个空目录下载compose.yaml和.env模板不用拉源码。生成令牌后填进.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 是否健康。环境要求Docker Engine 24 与 Compose v2。 还有一个前置条件容易被忽略读取本地音乐目录依赖浏览器「可信 HTTPS 安全上下文」局域网 HTTP 下部分能力会降级NAS 上需要自己配好反向代理和证书。30 秒验收确认装好了三条都打勾才算真的装完打开「关于」页版本号和你下载的文件名一致能登录任一在线音源网易云 / QQ / 酷狗或成功导入一个本地音乐文件夹播放一首带歌词的歌全屏歌词动画渲染正常避坑5 个最常见的卡点下载一直中断或慢得没法用→ 官方网盘只覆盖 Windows 和 arm64 Mac → 这两类直接换网盘镜像下载其余平台继续走 ReleasesArch 用户也可以先手动下好 tar.gz 再本地构建 AUR。macOS 弹出「Folia.app 已损坏」→ 应用缺 Apple 签名被 Gatekeeper 按未公证应用拦截 → 终端执行xattr -dr com.apple.quarantine /Applications/Folia.app后重新打开macOS 15 起「Control 点击打开」这条绕过路已经走不通别在上面浪费时间。Linux 启动黑屏、透明度异常或闪退→ GPU 与 Electron 图形栈不兼容 → 先试FOLIA_LINUX_GRAPHICS_MODEswiftshader不行再换softwareX11 下 WebGPU 不可用可加FOLIA_LINUX_VULKAN1 ./folia-major --ozone-platformx11原生 Wayland 不要开 Vulkan。装出来的版本和最新 Release 对不上→ 网盘镜像和 AUR 包都会滞后 → 下载前把文件名里的版本号和 Releases 页最新值比一下不一致就直接下官方最新包。dmg 解压后打不开、安装中途报错→ 多为下载中断导致文件不完整或跑的是 dmg 挂载盘里的临时副本 → 重新完整下载一次并确认你运行的是拖进Applications里的那个正式应用。你拿到的是去哪看Folia-Setup-版本.exe「桌面安装 → Windows」一节Folia-版本-arm64.dmg/-x64.dmg「桌面安装 → macOS」一节folia-major-版本-linux-x64.tar.gz「Folia Linux 安装」便携版或 AUR 一节【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Folia 安装完整指南四条路线快速装好全屏歌词动画播放器【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-majorFolia 是一款把歌词渲染成全屏沉浸动画的桌面播放器能接本地音乐库也能登录网易云、QQ 音乐、酷狗在线音源。这篇 Folia 安装教程只解决一件事把安装包下载到你的机器并跑起来。顺利的话十来分钟就能装完。先确认你走哪条路线动手前先问自己三个问题你在什么系统上Windows、macOS、Linux 各走各的包Linux 用户再细分一步——Arch 系Arch / EndeavourOS走 AUR其他发行版走便携压缩包。Mac 是什么芯片点左上角「关于本机」看是 Apple siliconarm64还是 Intelx64两种芯片的安装包文件名不同选错了装不了。能不能直连官方 Releases 页直连没问题的话版本最新、平台最全直连慢或断流时Windows 和 Apple silicon Mac 用户有官方网盘夸克 / 百度兜底但网盘只有这两个平台的包且通常只收 Windows 与 arm64 Mac 的正式版。四条路线速览对号入座即可官方 Releases 直连——Windows / macOS / Linux 全覆盖版本最新约 10-20 分钟。官方网盘镜像——只覆盖 Windows 和 arm64 Mac国内直连快、支持断点续传约 5-10 分钟。建议先把文件转存到自己网盘再下载。AUR 包folia-major-bin——Arch / EndeavourOS 专用一条命令装完约 3-5 分钟但版本通常落后官方发行。Docker Web 自托管——面向 NAS / 服务器让手机和浏览器都能访问30 分钟起步。仓库版本目前是 0.7.23但具体下哪个包永远以官方 Releases 页最新一条为准。桌面安装Folia Windows 安装下载 exe 跑完向导去哪下去 Releases 页拿Folia-Setup-版本.exe走网盘的话拿同名文件记得先转存再下载中途断了也能续传。怎么装双击安装程序这是 NSIS 向导中途可以修改安装目录其余一路确认即可。桌面版把前后端运行环境都打进了包里装完从开始菜单启动就行不用额外装运行时。容易卡住只装官方渠道的分发文件网上来路不明的转发包一律不碰。Folia macOS 安装按芯片选 dmg再拖进 Applications去哪下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原理和「隐私与安全性」的备选方案写在仓库的 docs/desktop/macos-app-damaged.md。 另一个要记住的点macOS 版目前不支持应用内自动更新以后每次用新 dmg 覆盖安装都要把这行xattr命令重跑一遍。Folia Linux 安装便携包与 AURUbuntu / Debian / Fedora便携版 tar.gz 直接启动去哪下从 Releases 页拿folia-major-版本-linux-x64.tar.gz。怎么装解压到任意目录进目录直接启动./folia-major想生成桌面启动项的话把包内的resources/linux/folia-major.desktop复制到~/.local/share/applications/再把模板里的__APP_PATH__和__ICON_PATH__两个占位符替换为可执行文件和resources/linux/icon.png的绝对路径最后按你的桌面环境要求把这个启动项标记为可信即可。完整说明和图形环境变量参考 packaging/linux/README-LINUX.txt。Arch 系 AUR一条命令装完装好 yay 或 paru 之后执行yay -S folia-major-binparu 用户把命令换成paru -S folia-major-bin即可。构建过程会自动解决alsa-lib、gtk3、libxss、nss四个依赖程序装进/opt/folia-major并生成菜单启动项。⚠️ 这个 AUR 包是基于预编译 Release 打的包依赖清单见 packaging/aur/folia-major-bin/PKGBUILD所以版本一般落后官方最新发行。如果你的网络拉 Releases 很慢可以先把同版本的folia-major-版本-linux-x64.tar.gz手动下好放进 AUR 源码目录再执行makepkg -si本地构建。Linux 图形排障启动后黑屏、透明度异常或直接闪退多半是 GPU 兼容问题。按这个顺序试FOLIA_LINUX_GRAPHICS_MODEswiftshader ./folia-major FOLIA_LINUX_GRAPHICS_MODEsoftware ./folia-majorX11 环境下如果 WebGPU 不可用可以用 Vulkan 路线替代FOLIA_LINUX_VULKAN1 ./folia-major --ozone-platformx11注意原生 Wayland 下不要开这个 Vulkan 选项只针对 X11 使用。让手机和浏览器也能访问Docker Web 自托管桌面版只能在本机用想让手机、浏览器都能访问就把 Folia 部署成 Web 服务跑在 NAS 或服务器上。具体步骤按 deploy/docker/README.md 的说明新建一个空目录下载compose.yaml和.env模板不用拉源码。生成令牌后填进.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 是否健康。环境要求Docker Engine 24 与 Compose v2。 还有一个前置条件容易被忽略读取本地音乐目录依赖浏览器「可信 HTTPS 安全上下文」局域网 HTTP 下部分能力会降级NAS 上需要自己配好反向代理和证书。30 秒验收确认装好了三条都打勾才算真的装完打开「关于」页版本号和你下载的文件名一致能登录任一在线音源网易云 / QQ / 酷狗或成功导入一个本地音乐文件夹播放一首带歌词的歌全屏歌词动画渲染正常避坑5 个最常见的卡点下载一直中断或慢得没法用→ 官方网盘只覆盖 Windows 和 arm64 Mac → 这两类直接换网盘镜像下载其余平台继续走 ReleasesArch 用户也可以先手动下好 tar.gz 再本地构建 AUR。macOS 弹出「Folia.app 已损坏」→ 应用缺 Apple 签名被 Gatekeeper 按未公证应用拦截 → 终端执行xattr -dr com.apple.quarantine /Applications/Folia.app后重新打开macOS 15 起「Control 点击打开」这条绕过路已经走不通别在上面浪费时间。Linux 启动黑屏、透明度异常或闪退→ GPU 与 Electron 图形栈不兼容 → 先试FOLIA_LINUX_GRAPHICS_MODEswiftshader不行再换softwareX11 下 WebGPU 不可用可加FOLIA_LINUX_VULKAN1 ./folia-major --ozone-platformx11原生 Wayland 不要开 Vulkan。装出来的版本和最新 Release 对不上→ 网盘镜像和 AUR 包都会滞后 → 下载前把文件名里的版本号和 Releases 页最新值比一下不一致就直接下官方最新包。dmg 解压后打不开、安装中途报错→ 多为下载中断导致文件不完整或跑的是 dmg 挂载盘里的临时副本 → 重新完整下载一次并确认你运行的是拖进Applications里的那个正式应用。你拿到的是去哪看Folia-Setup-版本.exe「桌面安装 → Windows」一节Folia-版本-arm64.dmg/-x64.dmg「桌面安装 → macOS」一节folia-major-版本-linux-x64.tar.gz「Folia Linux 安装」便携版或 AUR 一节【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
