Folia 安装教程：10 分钟装好这款全屏歌词动画播放器
【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major
Folia 是把歌词渲染成全屏动画的播放器，支持本地音乐库、Navidrome 与网易云、QQ 音乐、酷狗等在线音源。这篇 Folia 安装教程带你走完下载、安装到跑起第一首带歌词的歌，顺利的话 10 分钟搞定。
装完长什么样：全屏歌词动画就是目标
启动后，播放一首带歌词的歌，整块屏幕会铺满歌词动画——文字随节奏浮入、放大、发光，底部是简洁的播放条。不同主题的排版氛围完全不同，装完就能看到这种「文字 PV」效果。
开工前核对 4 件事
- 系统：Windows、macOS，还是哪个 Linux 发行版（Arch 系或其他）
- 架构：Mac 确认是 Apple silicon（arm64）还是 Intel（x64）
- 网络：能否直连官方 Releases 页，不行就走官方网盘镜像
- 工具：Arch 用户需 AUR Helper（yay 或 paru）；Docker 用户需 Docker Engine 24+ 与 Compose v2
Windows / macOS 安装包 5 步装完
难度：低，约 5-10 分钟。
- 打开仓库 README 的「快速下载」一节，进入官方 Releases 页面（当前版本 0.7.23）。
- 按平台选安装包：Windows 选
.exe；macOS Apple silicon 选Folia-<版本>-arm64.dmg，Intel 选Folia-<版本>-x64.dmg。 - 下载完成后运行安装程序，Windows 按向导走完即可；macOS 把
Folia.app从 dmg 拖进Applications，不要在挂载盘里直接运行。 - 桌面版内置前后端运行环境，装完直接打开就能用。
⚠️ 只使用 README 里的官方下载入口，避免来路不明的转发包；下载前务必核对文件名里的版本号与 Releases 最新值一致。
其他安装路线按需选
网盘镜像：Releases 下载慢怎么办
适用：国内网络、Windows 与 Apple silicon macOS 用户。
- 在 README「快速下载」一节打开官方夸克或百度网盘链接。
- 先在网盘客户端转存到自己的网盘再下载，断了可续传。
- 只覆盖 Windows 与 Apple silicon 正式版；Intel Mac 和 Linux 仍回 Releases。
⚠️ 网盘镜像通常滞后于最新发行，下载前比对文件名版本号，不一致就等它同步或改走直连。
Arch 一行命令装完（AUR）
适用：Arch 或 EndeavourOS 用户。
- 确认装了 yay 或 paru，执行
yay -S folia-major-bin（paru 用户换成paru -S folia-major-bin）。 - 构建过程自动解析 alsa-lib、gtk3、nss 等依赖，装入
/opt/folia-major并生成菜单项。
依赖清单见 packaging/aur/folia-major-bin/PKGBUILD。
⚠️ 构建要从 GitHub 拉 Linux 压缩包，版本可能落后于最新 Release；网络慢时先手动下载同版本
folia-major-<版本>-linux-x64.tar.gz放进源码目录，再执行makepkg -si。
Linux 便携 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__替换为实际路径，再按桌面环境要求标记为可信。
详细说明与图形参数见 packaging/linux/README-LINUX.txt。
Docker：把 Web 版部到 NAS 或服务器
适用：NAS、服务器或想在手机浏览器里用的用户。难度：较高，约 30 分钟起。
- 按 deploy/docker/README.md 准备
compose.yaml与.env两个文件。 - 生成
SYNC_TOKEN填入.env，执行docker compose pull与docker compose up -d --wait。 - 浏览器打开
http://NAS-IP:18080即可使用。
⚠️ 局域网 HTTP 下本地音乐目录导入等能力不可用，正式使用本地曲库需给 NAS 配好 HTTPS 反向代理，文档有完整写法。
确认装好了：3 步验证
- 启动应用，在设置里核对版本号与安装包文件名一致。
- 登录一个在线音源（网易云 / QQ / 酷狗），或导入一个本地音乐文件夹。
- 播放一首带歌词的歌，看到全屏歌词动画铺满屏幕，安装就成功了。
💡 到设置的主题里换一种歌词动画风格试试，同一首歌的氛围会完全不一样。
出问题先查这里
| 现象 | 先查什么 | 一句话解法 |
|---|---|---|
| 下载慢或一直中断 | 是否直连 Releases | 换官方网盘镜像；Linux 包仍走 Releases 或先手动下载再本地构建 AUR |
| macOS 提示「Folia.app 已损坏」 | 版本是否未带 Apple 签名 | 不是真的坏了，是缺签名：终端执行xattr -dr com.apple.quarantine /Applications/Folia.app后重新打开，详见 docs/desktop/macos-app-damaged.md |
| Linux 黑屏、透明度异常或闪退 | GPU 兼容性 | 用FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major验证，仍不稳定改FOLIA_LINUX_GRAPHICS_MODE=software |
| 网盘版本比最新旧 | 文件名版本号 | 镜像有滞后，核对版本号，不一致就等它同步或改直连 |
装好、登录一个音源或导入本地歌库，第一首歌就能让全屏歌词亮起来 🎵 现在就去 README 的「快速下载」一节，把你平台的安装包拿下来。
【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
