企业官网建设流程全解析

Folia 安装教程：十分钟装好全屏歌词动画播放器

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

Folia 是把歌词渲染成全屏沉浸动画的桌面音乐播放器，支持网易云、QQ 音乐、酷狗、Navidrome 等在线音源，也能接入本地音乐库。这篇 Folia 安装教程给出三条路线：官方安装包、AUR 一行命令、Docker 自托管，桌面用户照着做，十分钟就能玩到全屏歌词。

装前 30 秒自查

• 机器是什么系统，Mac 又是什么芯片。Windows、macOS 还是 Linux；Mac 在「关于本机」里确认 Apple silicon 还是 Intel，两者安装包文件名不同，官方网盘镜像只有 Apple silicon 版。
• 能否直连官方 Releases 页面。直连困难时，Windows 与 Apple silicon Mac 可换夸克或百度网盘镜像（百度提取码 flia），Intel Mac 和 Linux 包仍要走 Releases。
• 装在哪里跑：桌面电脑、Arch 服务器，还是 NAS。这决定走哪条路线。在线音源无需提前准备账号，装完扫码或输密码登录即可。

选一条安装路线

只想装完就用 → 路线一。Arch 用户、习惯终端 → 路线二最短。不想装在桌面，想让手机和浏览器都能打开 → 路线三。

路线一：官方桌面安装包

这条路线最省事，不碰命令行，桌面版内置前后端运行环境，装完即用。

Windows：拿到 .exe 跑完安装向导

1. 从 Releases 页面拿Folia-Setup-<版本>.exe。直连困难就换夸克或百度网盘（提取码 flia），网盘通常滞后一两个版本，先比对文件名里的版本号。
2. 双击它，安装向导支持修改安装目录，选个顺手的位置装完。
3. 从开始菜单启动。只使用官方渠道的分发文件，来路不明的转发包一律不装。

macOS：按芯片选对 dmg

dmg 文件名随芯片不同，选错装不上。

1. Apple silicon 拿Folia-<版本>-arm64.dmg，Intel 拿Folia-<版本>-x64.dmg。网盘镜像只有 arm64，Intel Mac 只能走 Releases。
2. 打开 dmg，把Folia.app拖进Applications，别在挂载盘里直接运行。
3. 首次弹出「应用已损坏」或「无法验证」，是缺 Apple Developer ID 签名导致的拦截，不是真损坏。终端执行：

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

再重新打开即可，原理与备选方案见macOS「应用已损坏」说明。

⚠️ macOS 版没有应用内自动更新，每次覆盖安装新 dmg 都要再执行一次上面的 xattr 命令；macOS 15 起「Control 点击打开」的绕过方式已失效。

Linux：解压便携 tar.gz

非 Arch 发行版（Ubuntu、Debian、Fedora 等）通用。

1. 从 Releases 下载folia-major-<版本>-linux-x64.tar.gz，解压到任意目录。
2. 在包目录直接运行./folia-major。
3. 想有桌面启动项：把包内resources/linux/folia-major.desktop复制到~/.local/share/applications/，把__APP_PATH__和__ICON_PATH__两个占位符换成可执行文件与图标的绝对路径，再按桌面环境要求标记为可信。

💡 启动后黑屏、透明度异常或 GPU 崩溃，先用FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major验证；仍不稳定再换FOLIA_LINUX_GRAPHICS_MODE=software。X11 下提示 WebGPU 不可用时可加FOLIA_LINUX_VULKAN=1 ./folia-major --ozone-platform=x11，原生 Wayland 下不要开 Vulkan。

路线二：AUR 一行命令

给 Arch 用户，依赖自动解决，顺带生成菜单启动项。

1. 确认装了 yay 或 paru。
2. 执行：

yay -S folia-major-bin # paru 用户：paru -S folia-major-bin

3. 构建完成后自动解决alsa-lib、gtk3、libxss、nss依赖，程序装进/opt/folia-major，命令叫folia-major。

⚠️ 该包基于预编译 Release 打包，版本会滞后：仓库里的 PKGBUILD 目前还是 0.1.4，实际以 AUR 页面为准。网络慢时，先手动下载同版本folia-major-<版本>-linux-x64.tar.gz放进源码目录，再执行makepkg -si。

路线三：Docker 自托管 Web 版

不在桌面用、想让手机和别的设备通过浏览器打开 Folia，走这条。

1. 在空目录放入仓库deploy/docker/下的compose.yaml与.env模板。用openssl rand -hex 32生成随机串填进SYNC_TOKEN（要求至少 8 位），AI 配置留空不影响播放。详见Docker 部署说明。
2. 校验配置后启动：

docker compose config docker compose pull docker compose up -d --wait

3. 浏览器访问http://NAS-IP:18080打开 Web 端，http://NAS-IP:13000/health检查 Sync Server。

⚠️ 要求 Docker Engine 24+ 与 Compose v2。本地音乐目录导入依赖可信 HTTPS 安全上下文，NAS 上要自行配反向代理与证书，否则本地曲库等功能会降级。

确认装好了

• 启动 Folia，在「关于」页核对版本号与下载文件名一致（仓库当前版本 0.7.23，以官方 Releases 页为准）
• 登录一个在线音源（网易云 / QQ / 酷狗），或导入一个本地音乐文件夹
• 播放一首带歌词的歌，全屏歌词动画正常出现、渲染无异常

出问题先查这里

装好后先导入本地曲库或登录在线音源，再按本地音乐库管理了解导入、重扫与歌词匹配的细节。

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