企业官网建设流程全解析

Folia 歌词动画播放器保姆级安装教程：四步完成选包、下载、装机与验证

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

Folia 是一款全屏沉浸式歌词动画播放器，核心体验是把网易云、酷狗、QQ 音乐、Navidrome 或本地音乐库里的歌词渲染成铺满整个窗口的动画。桌面端基于 Electron 打包，覆盖 Windows、macOS、Linux；手机或无桌面的服务器则走 Web 版。照下面「核对环境 → 定渠道 → 安装 → 自检」的顺序做一遍，你手里就是一台能出声、能出全屏歌词动画的 Folia。

环境核对表：按系统和架构锁定安装包

下载之前先对号入座。下表按安装动作的繁琐程度从少到多排列，越靠上越省事：

动手前还有三件事要认清：

• Linux 便携包没有安装过程。解压后就是folia-major可执行文件加resources/目录（内含应用图标和桌面启动项模板），放哪个目录由你定。
• 桌面版与 Web 版是两条独立版本线，两边版本号对不上属正常，各取各的最新版。
• 如果你在用 Navidrome 自建曲库，拿包方式和上表完全一致，装完在设置里填服务器地址即可接入。

三个问题定下载渠道

别急着翻下载页，按顺序回答三个问题，渠道就定了。

问题一：你的系统架构是什么？→ 它只决定包名。架构定产物：Windows 对应.exe，Apple silicon 对应-arm64.dmg，Intel Mac 对应-x64.dmg，Linux 对应 tar.gz。先定架构再找文件，顺序反了拿错包。

问题二：你的网络连 GitHub 直连顺畅吗？→ 顺畅就直接走官方 Releases，全平台、版本最新。慢、卡、转圈就换官方网盘：README「快速下载」一节挂着夸克网盘和百度网盘两个官方入口（百度提取码flia）。

问题三：你在意版本新鲜度吗？→ 网盘镜像的版本可能落后于最新 release，下之前先对一下版本号，落差大就回直连。AUR 包同理：当前包版本 0.1.4，可能落后于 Releases 最新版。

⚠️ 网盘镜像只有 Windows 与 Apple silicon 两个正式版安装包，Intel Mac 和 Linux 都不在其中，翻不到是正常现象。

安装实操：分平台短步骤

Windows：双击安装

1. 从 Releases 或网盘拿到Folia-Setup-<版本>.exe。
2. 双击，按向导装完。
3. 从开始菜单启动 Folia。

macOS：把应用拖进「应用程序」

1. 打开对应的-arm64.dmg（Apple silicon）或-x64.dmg（Intel）。
2. 把Folia.app拖进「应用程序」文件夹。
3. 从应用程序里启动，别在挂载盘里直接双击运行。

通用 Linux：手动部署步骤

1. 下载folia-major-<版本>-linux-x64.tar.gz。
2. 解压到一个固定目录，例如~/Apps/Folia/，以后升级就覆盖到这里。
3. 把包内resources/linux/folia-major.desktop模板复制到~/.local/share/applications/。
4. 打开复制出的文件，把__APP_PATH__换成可执行文件的绝对路径，__ICON_PATH__换成图标的绝对路径（例如Exec=/home/yourname/Apps/Folia/folia-major）。
5. 桌面环境有要求的话，把这个.desktop标记为可信。
6. 在解压目录运行./folia-major，或点应用菜单里的 Folia。

模板写法与完整路径示例见 packaging/linux/README-LINUX.txt。

Arch：一条命令装 AUR 包

1. 确认yay或paru可用。
2. 执行：

yay -S folia-major-bin

构建会自动从 Releases 拉取对应的 Linux tar.gz，装进/opt/folia-major，创建桌面启动项，并顺带装好alsa-lib、gtk3、libxss、nss这些依赖。 3. 在应用菜单里直接启动。

⚠️ 这个构建本质上还是要连 Releases 下载 tar.gz，进度卡住时别干等，直接走上一节的手动部署。

首次运行自检：做到哪一步才算装对

装完做三个动作，第三个完成即算通过：

1. 看首页——启动应用，确认首页完整渲染出来，不是白屏或半成品。
2. 播一首测试曲——搜索一首熟悉的歌并点击播放，确认声音正常输出。
3. 看歌词面——歌词应随歌声以动画形式铺满整个窗口，而不是一行挤在角落的字幕。

到第三步、全屏歌词动画出现，才算装对。

跑通之后的日常：导入本地歌曲时 Folia 会自动匹配在线歌词和封面，本地库重扫、匹配、实体管理细节见 docs/local-library-management.md；Navidrome、QQ 音乐等在线源的服务器地址与账号都在「设置」里配置。想让本地音乐库自己托管、通过网络提供访问的话，可以看 deploy/docker/README.md 的 Docker 方案。

症状排查：三列从症状到对策

收尾

全程真正的坑只有三个：包拿错、目录放错、渲染模式没切对；这三样对了，歌就能放。Wayland 壁纸模式、遥控窗等更多平台细节见 docs/technical.md；macOS「应用已损坏」的完整排查（含 Gatekeeper 原理）见 docs/desktop/macos-app-damaged.md 🎵

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