企业官网建设流程全解析

Folia 全屏歌词播放器快速上手指南：Windows / macOS / Linux 十分钟装完开听

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

装完 Folia 你能做什么

Folia 是一款以全屏沉浸式歌词动画为核心的音乐播放器，支持网易云音乐、QQ 音乐、酷狗等在线音源，也支持 Navidrome 和本地音乐库。桌面版把前后端运行环境都打进了安装包，不需要 Node.js，也不需要任何开发工具。装完登录一个音源，随便播一首带歌词的歌，整块屏幕就会被歌词动画铺满。

选对安装包：按平台速查

两条限制先记住：网盘镜像只覆盖 Windows 与 Apple silicon 的正式版，Intel Mac 和 Linux 只能走 Releases；Linux 的 x86_64 与 ARM 包互不通用。下载完成后先对一遍文件名里的版本号与 Releases 页最新标注是否一致，对不上就说明镜像还没同步，换回 Releases 重新下。

分平台安装步骤

Windows 安装步骤

从 Releases 页下载.exe，双击后按安装向导逐步走完即可。开始菜单里能看到 Folia 图标，说明装到位了。

macOS 安装步骤

打开.dmg，把 Folia 拖进 Applications 文件夹。启动台里出现 Folia 图标，说明装到位了。

Linux 安装步骤

把.tar.gz解压到任意目录，直接运行里面的folia-major可执行文件即可，无需安装。想加桌面启动项，把resources/linux/folia-major.desktop复制到~/.local/share/applications/，再把文件里的__APP_PATH__、__ICON_PATH__两个占位符替换成实际绝对路径，按桌面环境要求标记为可信。完整做法见 README-LINUX.txt。

启动 Folia 并验收

首次启动后，登录一个在线音源，或导入一个本地音乐文件夹。再播一首带歌词的歌，屏幕被歌词动画铺满的那一刻，安装就算彻底完成了。顺手切换两三个主题，可以感受不同排版的氛围。

进阶路线：AUR、Web 部署与手机

• Arch 一行命令安装：执行yay -S folia-major-bin（paru 用户把yay换成paru），依赖自动解决，程序装到/opt/folia-major。依赖清单与安装位置可核对 PKGBUILD。
• Web 版部署（NAS / 浏览器）：不想装桌面端时，可部署到 Vercel、Cloudflare 或 Docker，浏览器里直接听。完整步骤在 deploy/docker/README.md。
• 手机当 App 用：Web 版部署完成后，在 Chrome for Android 或 iOS Safari 里把页面添加为 PWA。

自检清单

• 🏷️ 版本：「关于」页的版本号与安装包文件名里的版本一致
• 🔑 音源：成功登录一个在线音源，或导入本地文件夹、接入 Navidrome
• 🎤 歌词：播放带歌词的歌，全屏动画正常亮起
• 🎨 主题：切换两三个主题，排版显示无异常

四项全部对上，就可以开始日常使用了。

常见现象排障

下载总是断流→ 国内网络直连 GitHub Releases 速度慢 → 换官方网盘镜像（夸克、百度），取回后再核对一遍版本。Linux 的.tar.gz没有镜像，只能走 Releases。

Linux 启动黑屏或闪退→ GPU 兼容问题，不是装坏了 → 用FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major以软件渲染模式启动验证；仍不稳定就把swiftshader换成software；确认原因后，再改用system恢复系统图形路径。

拿错包→ 两类常见情况：Intel Mac 装了 Apple silicon 版，或 Linux 下错了 CPU 架构 → 文件名都带平台标识，回 Releases 页逐字比对后重新下载。

挑一首带歌词的歌，让整块屏幕亮起来。

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