Folia 安装教程：十分钟从下载到全屏歌词动画

Folia 安装教程十分钟从下载到全屏歌词动画【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-majorFolia 是把歌词渲染成全屏沉浸式动画的桌面音乐播放器支持本地音乐库与网易云、QQ 音乐、酷狗等在线音源。这篇 Folia 安装教程只解决一件事把对应系统的安装包拿到手并启动。下面按「选路线 → 确认 → 安装 → 验证 → 排障」走一遍顺利的话十分钟跑通。一张表对比 4 条下载路线对号入座路线适用系统耗时特点官方 Releases 直连Windows / macOS / Linux10-20 分钟全平台版本最新官方网盘镜像夸克 / 百度Windows、macOS仅 arm645-10 分钟国内直连快支持断点续传AUR 包folia-major-binArch / EndeavourOS3-5 分钟一行命令自动装依赖Docker Web 自托管NAS / 服务器30 分钟以上Web 端多设备浏览器访问桌面用户走前两条或 AUR想让手机、电视也访问同一套服务的选 Docker。下载前确认 3 件事Mac 芯片按「关于本机」确认 Apple siliconarm64还是 Intelx64。两个芯片的安装包文件名不同官方网盘只提供 arm64 版Intel Mac 必须走 Releases。网络条件能否直连官方 Releases 页面。直连困难时Windows 与 Apple silicon Mac 改走官方网盘镜像百度云提取码flia建议先转存到自己网盘再下载中断可续传。版本仓库当前版本为 0.7.23实际以 Releases 页为准。网盘镜像与 AUR 包通常滞后下载前先比对文件名里的版本号。分系统安装按你的系统对号入座Windows装完向导 3 步就能启动适用场景装完即用不碰命令行。下载Folia-Setup-版本.exeReleases 页或官方网盘。双击运行NSIS 向导支持修改安装目录一路确认即可。桌面版已内置前后端运行环境安装完成从开始菜单直接启动。⚠️ 只使用官方渠道的分发文件来路不明的转发包一律不装。LinuxArch 一行命令其他发行版解压即跑Arch 系AUR 一行装好确认已装 AUR Helperyay 或 paru然后执行yay -S folia-major-bin # paru 用户paru -S folia-major-bin构建完成后自动解决alsa-lib、gtk3、libxss、nss依赖程序装进/opt/folia-major并生成菜单启动项。⚠️ 该 AUR 包基于预编译 Release 打包版本通常落后于最新发行依赖清单见 packaging/aur/folia-major-bin/PKGBUILD。网络慢时先手动下载同版本folia-major-版本-linux-x64.tar.gz放进源码目录再执行makepkg -si。其他发行版便携版 tar.gz 一条命令启动适用场景Ubuntu、Debian、Fedora 等非 Arch 系。从 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。启动黑屏、透明度异常或 GPU 崩溃时先用FOLIA_LINUX_GRAPHICS_MODEswiftshader ./folia-major验证仍不稳定再改FOLIA_LINUX_GRAPHICS_MODEsoftware。macOS一条 xattr 命令解除系统拦截适用场景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原理细节与「隐私与安全性」备选方案见 docs/desktop/macos-app-damaged.md。 macOS 版暂不支持应用内自动更新每次覆盖安装新 dmg 后都要重跑一次上面的xattr命令。NAS / 服务器Docker 两个文件起 Web 版适用场景不在桌面用手机和浏览器都要访问。按 deploy/docker/README.md 在空目录下载compose.yaml与.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 安全上下文NAS 上需自行配置反向代理与证书。启动后 3 步确认装好了从菜单或快捷方式启动 Folia在「关于」页核对版本号与下载文件名一致。登录一个在线音源网易云 / QQ / 酷狗或导入一个本地音乐文件夹。播放一首带歌词的歌全屏歌词动画渲染正常即算过关。6 种装不上的情况速查Q下载一直中断或特别慢原因Releases 页面国内直连困难。 处理官方网盘只覆盖 Windows 与 Apple silicon Mac这两类直接换网盘镜像Intel Mac 与 Linux 包继续走 ReleasesArch 用户可先手动下好 tar.gz 再本地构建 AUR。QmacOS 提示「Folia.app 已损坏」原因缺 Apple 签名被 Gatekeeper 拦截。 修复xattr -dr com.apple.quarantine /Applications/Folia.app执行后重新打开。macOS 15 起「Control 点击打开」的绕过方式已失效不要在这上面浪费时间。QLinux 启动黑屏、透明度异常或闪退原因GPU 兼容问题。 修复FOLIA_LINUX_GRAPHICS_MODEswiftshader ./folia-major仍不行FOLIA_LINUX_GRAPHICS_MODEsoftware ./folia-majorX11 下提示 WebGPU 不可用时可加FOLIA_LINUX_VULKAN1 ./folia-major --ozone-platformx11原生 Wayland 下不要开 Vulkan。Q装出来的版本和最新 Release 对不上原因网盘镜像与 AUR 包都会滞后。 处理下载前把文件名里的版本号与 Releases 页最新值比对不一致就直接下官方最新包AUR 用户可手动下 tar.gz 本地构建。Qdmg 解压后打不开、安装中途报错原因下载中断导致文件不完整。 处理重新下载一次再试确认运行的是拖进Applications的正式应用而不是 dmg 挂载盘里的临时版本。QDocker 起来后页面打不开或本地音乐功能不可用原因端口没对上或缺少 HTTPS 安全上下文。 处理docker compose ps确认容器状态按http://NAS-IP:18080访问本地音乐库导入依赖可信 HTTPS给 NAS 配好反向代理与证书后刷新页面。下一步Windows装完向导后从开始菜单启动到「关于」页核对版本号。macOS把Folia.app拖进Applications跑一次xattr命令再双击启动。Linux解压目录里执行./folia-majorArch 用户直接yay -S folia-major-bin。NASdocker compose up -d --wait完成后浏览器打开http://NAS-IP:18080。播一首带歌词的歌全屏歌词动画出来就算装好了。【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考