企业官网建设流程全解析

Folia 全屏歌词播放器安装速查：三条路线，10 分钟跑通第一首带歌词的歌

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

Folia 是一个全屏沉浸式歌词播放器，支持网易云、QQ 音乐、酷狗、Navidrome 与本地音乐库，桌面端另接波点音乐、YouTube Music、Spotify 与汽水音乐。本文按桌面、Linux、Docker 三条路线拆解安装过程，装完用两步验收确认跑通，全程约 10～20 分钟，视路线而定。

Folia 安装最容易卡住的三个位置

动手前先看这三处，可以省掉大部分白等时间：

• 渠道选错：官方网盘镜像只收录 Windows 与 Apple silicon 两种包；Intel Mac 和全部 Linux 包只在 Releases 页面。⚠️ 下载之前先定渠道，定错了要重下。
• 架构不通用：x86_64 与 ARM 包互不兼容，文件名里的平台标识要和你机器逐字对上。
• Linux 黑屏：大概率是 GPU 兼容问题，不是装坏了。切软件渲染环境变量即可（命令见文末排障表）。

一分钟准备

• 桌面版把前后端运行环境打包进安装程序，不用预装 Node.js 或任何开发工具，装完即用。
• Arch 用户先确认装了 AUR Helper（yay 或 paru）。
• Docker 路线要求 Docker Engine 24+ 与 Compose v2。
• 当前版本0.7.23。核对文件名里的版本号，命名规律以 README.md 的「快速下载」一节为准。

按路线执行安装

桌面版（Windows / macOS）

1. 选包：Windows 下载.exe，macOS 下载.dmg，文件名平台标识与机器一致。
2. 落盘：走网盘的先转存再取回，下载完确认文件不是 0 字节，中途断了可直接续传。
3. 安装：Windows 双击.exe按向导走完，安装目录可自选；macOS 打开.dmg，把 Folia 拖进 Applications。 ✅ 通过标准：应用列表出现 Folia 图标。
4. 启动：双击进入主界面，歌曲搜索框可以点即算跑通。

Linux 命令行版

Arch 用户执行一条命令，alsa-lib、gtk3等依赖自动解决，程序落到/opt/folia-major并生成应用菜单项：

yay -S folia-major-bin

✅ 通过标准：应用菜单出现新入口，双击能启动。

其他发行版（Debian、Ubuntu 等）从 Releases 下载folia-major-0.7.23-linux-x64.tar.gz，解压到任意目录后运行：

./folia-major

✅ 通过标准：窗口打开、界面正常渲染。想生成菜单入口，把包内resources/linux/folia-major.desktop复制到~/.local/share/applications/，将__APP_PATH__、__ICON_PATH__两个占位符替换为实际路径，细节见 packaging/linux/README-LINUX.txt。

Web 版（Docker / NAS）

把 deploy/docker 目录里的compose.yaml与环境变量模板.env放到 NAS 同一目录，先生成一个至少八位的随机字符串填进SYNC_TOKEN：

openssl rand -hex 32

然后启动并检查状态：

docker compose up -d

✅ 通过标准：浏览器打开http://NAS-IP:18080页面能加载。端口规划、环境变量、Navidrome 预置账号的完整说明见 deploy/docker/README.md。

两步验收：确认真的跑起来了

1. 对版本号：进入「关于」页，显示的0.7.23与刚下载的包一致才算装成功。💡 网盘镜像偶尔比 Releases 晚一拍，对不上直接重新下载。
2. 完成一次最小体验：登录一个在线音源，或导入一个本地音乐文件夹，播一首带歌词的歌——全屏歌词动画会自动亮起来。

出问题怎么办

装完的下一步：去设置里切换歌词动画主题，心象、浮名、流光每个主题的排版氛围都不同；桌面版还可以打开「设置 → 模组」的 Folium 模组系统（默认关闭），安装官方认证的歌词动画与新背景，平台规范见 mods/README.md。

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