Folia 歌词动画播放器安装指南：网盘镜像 + AUR 一键装好，5 分钟跑通全屏歌词-港品优选

Folia 歌词动画播放器安装指南：网盘镜像 + AUR 一键装好，5 分钟跑通全屏歌词

【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major

Folia 是一款把歌词渲染成全屏动画的音乐播放器，支持在线平台与本地音乐库。国内直连发布源慢、版本对不上是最常见的卡点。本文按平台给出网盘镜像、AUR、便携版三条路，约 5 到 10 分钟装好跑通。

按系统架构与网络情况判断安装路径

先对号入座，四项判断直接决定你走哪条路：

系统与架构：Windows、macOS（区分 Apple silicon 与 Intel）、Arch Linux 或其他 Linux 发行版。
网络情况：官方发布源直连是否卡顿。慢就走官方网盘镜像（夸克、百度），它只镜像 Windows 与 Apple silicon 的正式版。
用途：日常听歌用桌面版，内置前后端运行环境，即装即用；想在浏览器里跑属于 Web 版部署，不在本文范围。
权限：macOS 未做 Apple 签名与公证，首次启动会被拦截，需额外一步处理；Linux 桌面环境（X11 / Wayland）不同，排错方式也不同。

下载渠道决策表：平台、前提条件与耗时

场景	推荐方案	前提条件	耗时/难度
Windows	官方网盘镜像（夸克 / 百度）	能登录网盘客户端	约 5 分钟 / 极低
macOS（Apple silicon）	官方网盘镜像（夸克 / 百度）	百度网盘提取码`flia`	约 5 分钟 / 极低
macOS（Intel）	官方发布源安装包	终端权限	约 10 分钟 / 低
Arch Linux	AUR 包`folia-major-bin`	已装`yay`等 AUR Helper	约 10 分钟 / 低
其他 Linux 发行版	发布源 Linux 便携版压缩包	有图形桌面环境	约 10 分钟 / 中

三条路径的分平台安装步骤

Windows 与 macOS 网盘镜像安装步骤

打开项目 README.md「直接下载」一节，复制夸克网盘或百度网盘官方链接（百度网盘提取码flia），转存到自己的网盘。
下载对应平台的安装包：Windows 选.exe，macOS 选.dmg，Apple silicon 选arm64版本。
核对文件名中的版本号，与最新正式发布一致。
Windows 双击.exe按向导装完即可；macOS 打开.dmg把Folia.app拖进Applications，不要在挂载盘里直接运行。

💡 网盘链接随版本更新，务必以 README「直接下载」一节的官方入口为准，别用来路不明的转发包；网盘镜像目前只提供 Windows 与 Apple silicon 正式版，Intel Mac 请走发布源。

Arch Linux AUR 包一键安装步骤

确认已装 AUR Helper（如yay），构建脚本可查仓库内的 PKGBUILD。
执行安装命令：

yay -S folia-major-bin

依赖alsa-lib、gtk3、libxss、nss会自动处理，应用装到/opt/folia-major，应用菜单生成folia-major启动项。

⚡ 构建拉压缩包慢时，先把同版本folia-major-<版本>-linux-x64.tar.gz下到 AUR 构建目录的源码目录，再执行makepkg -si，跳过慢速下载。

其他 Linux 发行版便携版安装步骤

从官方发布源下载 Linux 便携版压缩包，文件名形如folia-major-<版本>-linux-x64.tar.gz，核对版本号与最新正式版一致。
解压到任意目录，得到folia-major可执行文件与resources/linux/目录。
把resources/linux/folia-major.desktop复制到~/.local/share/applications/。
打开复制后的文件，将__APP_PATH__替换为folia-major可执行文件绝对路径，__ICON_PATH__替换为resources/linux/icon.png绝对路径；若桌面环境有要求，再标记为可信。

完整说明见 packaging/linux/README-LINUX.txt。

首次启动验证清单

装完花 30 秒确认以下 4 条，全部勾上才算真正跑通：

从应用菜单启动 Folia，主界面正常出现，不黑屏
登录网易云 / QQ 音乐 / 酷狗，或导入本地音乐库，播放一首歌
歌词渲染为全屏动画，主题切换正常
应用内版本号与你下载的安装包一致

黑屏、打不开与下载慢时的故障排查表

现象	可能原因	解法
Linux 启动后黑屏、透明度异常或闪退	Vulkan / GPU 兼容问题	用`FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major`启动；仍不稳定改`FOLIA_LINUX_GRAPHICS_MODE=software`，说明见 packaging/linux/README-LINUX.txt
macOS 提示「Folia.app 已损坏，无法打开」	当前版本未做 Apple 签名与公证，Gatekeeper 拦截	终端执行`xattr -dr com.apple.quarantine /Applications/Folia.app`后从`Applications`重新启动，详见 docs/desktop/macos-app-damaged.md
macOS 只提示「无法验证」且没有绕过入口	Intel 芯片走「隐私与安全性」放行	系统设置 → 隐私与安全性 → 仍要打开；Apple silicon 上直接执行上面的`xattr`命令
网盘链接失效、版本过旧或下载很慢	网盘镜像滞后 / 直连发布源被限速	以 README「直接下载」一节的官方网盘入口为准并自行对比版本号；其他平台重新下载同一文件即可
启动失败、提示架构不兼容	下错了架构的安装包	确认系统架构（Apple silicon / Intel / x86_64），重新下载对应版本

Linux 包细节、Wayland 遥控窗与壁纸模式看 docs/technical.md；想在 NAS 或服务器自托管 Web 版，看 deploy/docker/README.md。现在去享受全屏歌词动画吧 🎵

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析