企业官网建设流程全解析

Folia 快速上手：十分钟装好全屏歌词播放器（Windows / macOS / Linux）

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

Folia 把歌词做成铺满整块屏幕的沉浸式动画，同时支持网易云、QQ 音乐、酷狗在线音源，也能接入 Navidrome 和本地音乐库。这份安装教程覆盖 Windows、macOS、Linux 三端，照做完十分钟跑通：装包、启动、放一首带歌词的歌，屏幕被歌词动画点亮。

桌面版把前后端运行环境都打进了安装包，装完即用，不需要 Node.js，也不需要任何开发工具。

60 秒选对包：平台与文件对照表

先花一分钟对着表选文件，选错包是后面所有问题的一半来源。

注意：网盘镜像只覆盖 Windows 和 Apple silicon 的正式版。Intel Mac 和 Linux 的包只能走 Releases 页。下载完成先对一眼版本号：文件名里的版本要和 Releases 页最新标注一致，对不上就等镜像同步，或改走 Releases 重下。

这一步走完，进入下一段。

按系统安装 Folia 全屏歌词播放器

选对包之后，三个系统各走各的路线，段内只有三件事：下载、安装或解压、启动。

Windows：装完看开始菜单

• 从 Releases 页或网盘镜像下载 .exe，核对文件名版本。
• 双击 .exe，安装向导逐步走完。开始菜单里出现 Folia 图标，说明装到位了。
• 双击图标启动，登录一个在线音源，或导入一个本地文件夹。
• 播放一首带歌词的歌，屏幕被歌词动画铺满，这一步就算通过。

macOS：拖进 Applications 就完事

• 按芯片选包：Apple silicon 走网盘或 Releases，Intel 只能走 Releases。
• 打开 .dmg，把 Folia 拖进 Applications 文件夹。启动台里能看到 Folia 图标，说明装到位了。
• 从启动台启动，登录后放一首带歌词的歌，全屏动画亮起即通过。

Linux：解压即运行

• 从 Releases 页下载对应架构的 .tar.gz，x86_64 和 ARM 包互不通用。
• 解压到任意目录，直接运行里面的folia-major可执行文件。主界面正常出现，说明装到位了。
• 想让桌面菜单出现 Folia 图标，把模板.desktop文件复制到~/.local/share/applications/，再把__APP_PATH__、__ICON_PATH__两个占位符换成实际绝对路径，按桌面环境要求标记可信。具体配法写在 README-LINUX.txt。

到这里还没完，装完不等于能用，先做下面四件事。

装完先做四件事：怎么确认没装坏

四项全对，日常使用没问题。

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

不想走默认路线？两条进阶路径

• Arch 发行版用 AUR 一条命令装：

  yay -S folia-major-bin

  paru 用户把yay换成paru。依赖自动解决，程序装到/opt/folia-major，应用菜单里出现 Folia 且能点开即完成。依赖清单和安装位置想核对，看 PKGBUILD。构建阶段拉压缩包慢的话，可以先用网盘下好同版本的 Linux 压缩包放进 AUR 源码目录，再执行makepkg -si。

• 不装桌面端，部署 Web 版到浏览器或 NAS：把项目部署到 Vercel、Cloudflare 或 Docker，浏览器里直接听；页面添加为 PWA 后，手机上也能当 App 用。耗时按几十分钟算，完整步骤在 deploy/docker/，核心命令一条：

  docker compose up -d

  启动后docker compose ps里各服务显示 running，访问http://NAS-IP:18080能打开页面即部署成功。

翻车现场：四个高频坑

Q：下载总是断怎么办？

国内网络直连 GitHub Releases 容易慢或断流，优先换官方网盘镜像（夸克、百度）。注意镜像只覆盖 Windows 和 Apple silicon 的正式版，Linux 的 .tar.gz 没有镜像，只能走 Releases。

Q：Linux 启动黑屏或闪退？

多半是 GPU 兼容问题，不是装坏了。先用FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major以软件渲染启动验证；仍不稳定就切到更保守的FOLIA_LINUX_GRAPHICS_MODE=software。确认是显卡问题后，再用FOLIA_LINUX_GRAPHICS_MODE=system恢复系统图形路径。

Q：拿错包了怎么办？

基本两类：Intel Mac 装了 Apple silicon 版，或 Linux 下错 CPU 架构。文件名都带平台标识，回 Releases 页面逐字比对一次再重新下载即可。

Q：网盘镜像的版本和 Releases 对不上？

镜像同步有延迟，这是正常现象。要么等镜像更新后重新下载，要么直接改走 Releases。判断标准只有一条：文件名版本与 Releases 最新标注一致。

四项核对全对，挑一首带歌词的歌，让屏幕亮起来。

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