企业官网建设流程全解析

Folia 全屏歌词播放器安装教程：从下载选包到首次播放，一次走通

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

Folia 是一款全屏沉浸式歌词播放器，支持网易云、QQ 音乐、酷狗、Navidrome 与本地音乐库，桌面端另可接波点音乐、YouTube Music、Spotify 与汽水音乐。这篇教程带你从挑选安装包走到安装完成、播出一首带歌词的歌，预计花费 10 到 20 分钟。你只需要一个对应系统的操作系统，不用预装 Node.js 或任何开发工具，桌面版把运行环境都打包在了安装程序里。

动手前先核对三件事

下载渠道。全平台安装包都在 Releases 页面（README.md的「快速下载」一节有入口）。国内网络下载慢或反复中断时，可以改用官方网盘镜像（夸克 / 百度，提取码flia）。⚠️ 网盘只提供 Windows 与 Apple silicon 的正式版，Intel Mac 和 Linux 包没有镜像，只能走 Releases。

包名与架构。当前版本是0.7.23，文件命名有规律，x86_64 与 ARM 的包不通用，下载前逐字核对：

前置依赖。桌面版无需任何预装环境；Arch 用户额外需要 yay 或 paru；Docker 部署需要 Docker Engine 24+ 与 Compose v2。

下载并核对安装包

1. Windows：在 Releases 取Folia-Setup-0.7.23.exe；macOS：按芯片取Folia-0.7.23-arm64.dmg（Apple silicon）或Folia-0.7.23-x64.dmg（Intel），同名.zip也可以；Linux：取folia-major-0.7.23-linux-x64.tar.gz。走网盘的，先转存到网盘再取回本地。
2. 核对文件不是 0 字节、没有被浏览器截断；中途断了直接续传或重下一次。

✅ 通过标准：文件名里的平台与架构标识和你的机器逐字一致。

安装：按系统各走三步

1. Windows：双击.exe，安装向导里可自选安装目录，一路点下一步走完。✅ 通过标准：应用列表里出现 Folia 图标。

2. macOS：打开.dmg，把Folia.app拖进 Applications，不要直接在挂载盘里运行。然后打开终端运行下面这条命令，它移除应用的下载隔离标记，执行完没有报错就是成功：

   xattr -dr com.apple.quarantine /Applications/Folia.app

   ✅ 通过标准：从 Applications 双击能正常打开，不再弹「已损坏」提示，说明见 docs/desktop/macos-app-damaged.md。

3. Arch Linux：终端运行yay -S folia-major-bin，它从 AUR 拉取预构建包并自动解决alsa-lib、gtk3等依赖，程序落到/opt/folia-major并生成应用菜单项。✅ 通过标准：应用菜单出现 Folia 入口。依赖清单可对照 PKGBUILD 核对。

4. 其他 Linux 发行版：把.tar.gz解压到任意目录（如~/Apps/Folia），双击或运行包内的folia-major可执行文件。想给应用菜单加入口，把包内resources/linux/folia-major.desktop复制到~/.local/share/applications/，把__APP_PATH__、__ICON_PATH__两个占位符替换为实际路径，步骤细节见 README-LINUX.txt。✅ 通过标准：命令行窗口跑起来、界面正常渲染。

5. NAS / Web：把 deploy/docker/ 里的compose.yaml与环境变量模板放进同一目录，在.env里填入SYNC_TOKEN（至少八位随机字符串），然后运行docker compose up -d，它会拉取全部服务镜像并在后台启动。✅ 通过标准：浏览器打开http://NAS-IP:18080能加载页面；配置细节见 deploy/docker/README.md。

首次启动，播一首带歌词的歌

1. 双击启动 Folia，等待主界面加载。✅ 通过标准：首页出现歌曲搜索框，且可以正常输入。
2. 登录一个在线音源，或点「Import Folder」导入一个本地音乐文件夹（导入只保存索引，不上传文件内容）。
3. 搜索并播放一首带歌词的歌。

✅ 通过标准：歌词动画铺满整块屏幕、随进度推进。

确认跑通了

1. 进入「关于」页面核对版本号，与刚下载的包一致才算装对。💡 网盘镜像偶尔比 Releases 晚一拍，对不上就直接重新下载。
2. 完成一次最小体验：登录音源（或导入本地文件夹），播一首带歌词的歌，确认全屏歌词动画自动亮起。
3. 进设置切两三个主题，每个动画的排版氛围都不一样。

遇到问题先看这里

装好后的下一步，是去设置里挑一个喜欢的主题、开启「设置 → 模组」里的 Folium 模组系统（默认关闭），从模组市场装官方认证的歌词动画与新背景；更多玩法与部署细节，见 README.md 与 docs/ 目录。

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