Folia 安装教程：10 分钟把全屏歌词播放器装到 Windows、macOS 和 Linux

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

Folia 是一款把歌词渲染成全屏动画的沉浸式音乐播放器，桌面端基于 Electron，覆盖 Windows、macOS、Linux 三套系统，另有可 Docker 部署的 Web 版。它可接网易云、酷狗、QQ 音乐、Navidrome 与本地音乐库。读完本文，你能在自己的机器上完成 Folia 安装部署，并听到第一首带歌词动画的歌。

30 秒摸底你的机器

这节只是自检，全部过了就直接走下一步。

• 系统：Windows 10/11、macOS（Apple silicon 与 Intel 均有包）或 Linux x86_64。
• 网络：能打开 Releases 页面即可；国内直连慢可走网盘镜像，但镜像只覆盖 Windows 与 Apple silicon Mac。
• 磁盘：预留约 500MB，安装路径避免中文与空格。
• 依赖：桌面版内置运行环境，无需自行安装 Node.js（可跳过）。
• Arch 用户：走 AUR 路线需先备好 yay 或 paru（可跳过）。

拿对安装包

这节做完，你手上会有一个与当前版本匹配的安装包文件。

按优先级走三条路：

1. 官方 Releases（推荐）：从仓库 README 的「快速下载」一节进入 Releases 页面，按平台挑文件——Windows 取.exe安装包，macOS 取.dmg，Linux 取linux-x64的.tar.gz便携包。
2. 网盘镜像：国内直连慢时用夸克、百度网盘；注意镜像只提供 Windows 与 Apple silicon 的正式版包，Intel Mac 与 Linux 仍以 Releases 正式包为准。
3. 包管理器：Arch 系发行版可完全省掉下载，直接走 AUR。

[!NOTE] ⚠️ 核对版本号：看包名里的版本段（如folia-major-0.7.x-linux-x64.tar.gz），与 release 列表最新一条不一致，说明拿到的是旧包。

装进你的桌面

这节做完，系统里多了一个能直接启动的 Folia。

Windows 一键安装

1. 双击取回的.exe安装包，按向导走完安装。
2. 开始菜单出现 Folia 条目，代表安装成功。

macOS 拖放安装

1. 双击.dmg，把 Folia 图标拖入 Applications 目录。
2. 首次启动若被系统拦下，在「系统设置 → 隐私与安全性」里允许一次，再启动。

Linux 便携包免编译部署

1. 把便携包解压到固定目录：

mkdir -p ~/Apps/Folia && tar -xzf folia-major-0.7.x-linux-x64.tar.gz -C ~/Apps/Folia # 解压便携包到目标目录

2. 复制桌面启动项模板到应用菜单目录：

cp ~/Apps/Folia/resources/linux/folia-major.desktop ~/.local/share/applications/ # 复制 .desktop 模板

3. 编辑复制出的.desktop文件，把__APP_PATH__与__ICON_PATH__两个占位符分别替换为folia-major可执行文件和resources/linux/icon.png的绝对路径。
4. 桌面环境有要求时，把该文件标记为可信，再从应用菜单启动。

Arch 系 AUR 一行安装

yay -S folia-major-bin # 一行完成下载与部署

paru 用户把yay换成paru即可，本小节完成。

跑起来的三个信号

不用纠结装没装成功，看这三个信号，中任意一个就是真的跑起来了。

• 首页：启动后看到 Folia 首页，顶部可切换在线音源，底部是播放控制条。
• 歌曲列表：登录网易云等音源后，首页能列出歌曲并正常播放。
• 命令行：终端里folia-major命令可直接执行（AUR 或 Linux 部署完成后）。

卡住了就查这张表

卡点基本都在这张表里，照行处理即可。

装完往哪里看

本文止于跑通，更深的细节顺着这三条查。

• docs/technical.md：Linux 图形模式、Wayland 遥控窗等桌面端细节。
• packaging/linux/README-LINUX.txt：便携目录结构、桌面启动项与图形变量逐项说明。
• deploy/docker/README.md：Web 版本 Docker Compose 全栈部署。

登录任意在线音源，或导入本地音乐库，放一首带歌词的歌，全屏歌词动画就跑起来了。

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