Folia 安装指南：十分钟装好全屏歌词动画播放器-育师

Folia 安装指南：十分钟装好全屏歌词动画播放器

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

Folia 把歌词渲染成全屏沉浸式动画，支持本地音乐、Navidrome 与网易云、QQ 音乐、酷狗等在线音源。这篇 Folia 安装教程带你把它装到 Windows、macOS 或 Linux 上并成功播放，顺利的话十分钟就能跑起来。

开工之前：先弄清你装在哪

不用把每种装法都记下来，先看你是什么情况：

Windows 电脑或 Apple silicon 的 Mac：最主流的用法，官方有现成安装包，装完直接点播放。
Arch / EndeavourOS 桌面：AUR 里有人打包好了，一条命令搞定，需要终端。
其他 Linux 发行版（Ubuntu、Debian 之类）：走便携压缩包，解压即用，不往系统里装东西。
想让手机浏览器也能听：那是 NAS / 服务器自托管的路子，量级不同，要单独留时间。

网络在国内就优先走官方网盘，在海外就直接连官方 Releases。

装 Windows 官方包（Apple silicon 版同路）

这条路线对大多数人最省心，五步以内结束：

打开 README.md 的「快速下载」一节，国内网络点官方网盘入口，海外网络直接去官方 Releases。 → 拿到的是同一份官方包，只是线路不同。
用网盘的同学先转存到自己的网盘再下载。 → 中途断了可以续传，不用从头来。
按平台挑包：Windows 是.exe，macOS 是.dmg（Apple silicon 版）。 → 网盘只覆盖这两份正式版，认准后缀。
运行安装程序按向导走完；macOS 则挂载镜像把 Folia 拖进 Applications。 → 桌面版已内置前后端环境，装完不装任何额外依赖。

⚠️ 只用 README 里的官方网盘入口，避免来路不明的转发包。

Arch 系 AUR 一行装好

Arch 用户不用下载安装包，让 AUR 直接从官方源包构建：

确认装了 AUR 助手，yay或paru都行。 → 助手只是构建外壳，没有就先装一个。
在终端执行（把yay换成paru效果一样）：

yay -S folia-major-bin

→ 它自动拉源码包、构建、安装，过程不用你动手。 3. 构建会顺手解决 alsa-lib、gtk3、libxss、nss 这些系统依赖，装完程序落在/opt/folia-major，并生成应用菜单项。 → 从菜单点开就能用，路径都不用记。

依赖清单和安装位置的定义，在 PKGBUILD 里可以逐行核对。

💡 构建要从官方 Releases 拉 Linux 压缩包，线路慢的话先手动下载同版本压缩包放进源码目录，再执行makepkg -si在本地收尾。

其余路线：各说一句

不走上面两条的，看这张表就够了：

你的情况	路线	一句话说明
Intel Mac	官方 Releases 直连	网盘里没有 Intel 包，去 Releases 下载 Intel 版`.dmg`，挂载后拖进 Applications。
其他 Linux	便携版解压	Releases 下载`folia-major-<版本>-linux-x64.tar.gz`，解压到任意目录，终端跑`./folia-major`确认启动。
NAS / 服务器	Web 自托管（Docker）	拉取 Compose 与环境模板、生成 Sync Token 后`docker compose up`，耗时最长，细节见 deploy/docker/README.md。

装完三步验收

无论走的哪条路，打开之后做三件事就算真正装好：

启动：从应用菜单或桌面快捷方式打开 Folia。
核对版本：进「关于」或首页，确认版本号是0.7.23。
点亮全屏：登录一个在线音源或导入本地曲库，播放一首带歌词的歌，进入全屏歌词动画——画面铺满、歌词动起来就成功了。

常见卡点：问答速查

Q：下载中断或很慢怎么办？A：多半是线路问题。国内改走官方网盘入口（Windows / Apple silicon 正式版都有）；Linux 包或 AUR 构建就先手动下载同版本压缩包，再在本地构建、解压。若发现网盘里的包版本偏旧，比一下文件名里的版本号，对不上就等同步或改直连。

Q：Linux 启动黑屏、透明度异常或闪退？A：基本是 GPU 兼容问题，先换 swiftshader 渲染路径试试：

FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major

仍不稳定就再退一步用软件渲染：FOLIA_LINUX_GRAPHICS_MODE=software ./folia-major。

Q：便携版解压后为什么没有桌面快捷方式？A：包不会自动生成。把resources/linux/folia-major.desktop复制到~/.local/share/applications/folia-major.desktop，再把里面的__APP_PATH__和__ICON_PATH__占位符分别替换成可执行文件与resources/linux/icon.png的绝对路径，详见 README-LINUX.txt。