Folia 怎么装?5 分钟跑通全屏歌词动画播放器-迪斯科星球

Folia 怎么装?5 分钟跑通全屏歌词动画播放器

【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器 A multi-platform music player for local files, Navidrome, and online streaming services, featuring stunning animated lyrics.项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major

TL;DR 先给最快的一条路

绝大多数人只需要一件事:去项目 Releases 页面(入口在 README.md 的「获取方式」一节),按你的系统下载安装包双击装完。Windows 取.exe、macOS 取.dmg、Linux 取.deb或.rpm,全程不用写一行代码。想在浏览器或 NAS 上打开它的话,后面有 Docker Compose 一条线的方案。

30 秒对号入座

先问自己三个问题,决定走哪条线:

手里是 Windows 或 Mac 电脑? → 走下面的桌面版主线,最短路径。
是 Linux 桌面? → Arch 系走 AUR;Debian / Ubuntu / Fedora 等走.deb/.rpm或tar.gz便携包,都是补丁路线。
不想在电脑上装,或者想在浏览器、电视、NAS 里用? → 走Docker Compose 自托管 Web 版。
只有手机? → 部署好 Web 版后,在浏览器里「添加到主屏幕」,以 PWA 形式用(网页应用,手机上当 App 点)。

💡 仓库 README 的「快速下载」还有国内网盘镜像(夸克 / 百度云,提取码flia),但它只放 Windows 和 Apple silicon 两个包,Intel Mac 与 Linux 都不在网盘里,别找空了。

桌面版主线:Windows / macOS

Windows:双击安装器一路下一步

结论:取Folia-Setup-<版本>.exe,装完即开。

打开仓库 README.md 的「快速下载」一节或项目 Releases 页面,找最新 Windows 安装器。
双击.exe,安装器会问你装到哪里(可以改),一路下一步。
从开始菜单启动 Folia,跳过首启的两道引导弹窗(思索模式、资料库界面选择)。

最容易踩的坑:网盘链接若滞后于最新 release,装到的可能是旧版。先对一眼版本号,明显落后就改用 Releases 页面。

macOS:被系统拦截,一条命令放行

结论:取Folia-<版本>-<芯片>.dmg(Apple silicon 选arm64,Intel 选x64),首启报「已损坏」时执行一条xattr命令。

在 Releases 选对应芯片的 dmg;Apple silicon 国内网络也可以走 README 的网盘镜像。
挂载 dmg,把Folia.app拖进Applications,别直接在挂载盘里运行。
弹出「应用已损坏 / 无法验证」时,在终端执行:

xattr -dr com.apple.quarantine /Applications/Folia.app # 移除下载隔离属性, Gatekeeper 不再拦截

从 Applications 重新打开。

最容易踩的坑:当前 macOS 版没有 Apple Developer ID 签名与公证,首启被拦是正常现象;这个版本也不支持应用内自动更新,每次覆盖安装新版本后都要再跑一遍上面的 xattr 命令。完整排错见 docs/desktop/macos-app-damaged.md。

其他平台的补丁路线

Arch / Manjaro:AUR 一条命令

确认 AUR 助手可用:yay --version # 检查 yay 是否已安装。
安装:yay -S folia-major-bin # 从 AUR 构建,实际就是下载预编译 linux-x64 包(paru 用户换命令名)。
验证:command -v folia-major # 应输出 /usr/bin/folia-major。

⚠️ AUR 包目前还停在 0.1.4,而仓库当前版本是 0.7.25(见 package.json),版本差了一大截。构建过程本质是下载,卡在下载多半是网络问题,别干等——直接转下面的便携版,依赖清单见 packaging/aur/folia-major-bin/PKGBUILD。

Debian / Ubuntu / Fedora:便携版四步部署

按发行版去 Releases 取包:Debian / Ubuntu / Mint 取.deb,Fedora / RHEL / openSUSE 取.rpm,其他发行版取folia-major-<版本>-linux-x64.tar.gz。
.deb/.rpm用发行版包管理器或双击装完即可;tar.gz 用户解压到固定目录:

mkdir -p ~/Apps/Folia && tar -xzf folia-major-*-linux-x64.tar.gz -C ~/Apps/Folia # 整套程序放进便携目录

安装桌面项:cp ~/Apps/Folia/resources/linux/folia-major.desktop ~/.local/share/applications/ # 复制桌面启动项模板。
打开这个文件,把__APP_PATH__换成folia-major可执行文件绝对路径、__ICON_PATH__换成resources/linux/icon.png绝对路径;桌面环境有要求时把文件标记为可信。

便携包一共三样:可执行文件、图标和桌面项模板,说明见 packaging/linux/README-LINUX.txt。

服务器 / NAS 自托管:Docker Compose 一条线

这一节把 Folia Web 版跑在服务器或 NAS 上,要求 Docker Engine 24+ 与 Compose v2,不需要拉源码。

把仓库的deploy/docker/compose.yaml和deploy/docker/.env.example放进同一个空目录,后者改名.env(嫌麻烦也可以先 clone 仓库:git clone https://gitcode.com/GitHub_Trending/fo/folia-major)。
生成随机串填进SYNC_TOKEN(至少 8 位,是多设备同步服务的口令,必须自己生成):

openssl rand -hex 32 # 生成随机串,粘贴到 .env 的 SYNC_TOKEN

启动并等健康检查通过:

docker compose up -d --wait # 拉镜像、启动全部服务,健康检查全过才返回

访问地址:Web 首页http://<服务器IP>:18080,Sync Server 健康检查http://<服务器IP>:13000/health。对外只发布这两个端口,其余服务只在 Docker 内网互访。

安全和证书相关的三件事:

.env里 AI 配置留空不影响听歌,先用起来再配。
本地音乐目录导入依赖可信 HTTPS 安全上下文——局域网 IP 的普通 HTTP 打不开文件选择器,正式使用要用 NAS 自带的反向代理终止 HTTPS,证书得是 CA 签发的完整证书链(自签的不算),并要求代理透传X-Forwarded-*头;要求清单见 deploy/docker/README.md。
Navidrome 预置账号凭据对局域网可见,建议在 Navidrome 里单开一个账号给它。

装完怎么算成功

应用菜单里能看到 Folia(Windows 开始菜单 / macOS 应用程序 / Linux 应用菜单)
跳过首启两道引导弹窗(思索模式、资料库界面选择),首页正常渲染
首页能看到 Playlists / Radio / Albums / Folder 标签和搜索框
搜一首歌进播放,歌词能跟着出现
(Web 版)浏览器打开http://<IP>:18080能进首页,/healthz返回正常

卡住了看这里

网盘里没有自己平台的包→ 网盘只有 Windows 与 Apple silicon,Intel Mac 和 Linux 去 Releases 取对应平台的包。
macOS 提示「应用已损坏」→ 不是真坏了,是缺签名。覆盖安装新版本后重跑xattr -dr com.apple.quarantine /Applications/Folia.app,再从 Applications 启动。
AUR 构建卡在下载→ 网络问题,转便携版四步部署;也别等 AUR 追版本,它停在 0.1.4,主仓库已到 0.7.25。
桌面快捷方式不显示→ 打开.desktop文件,确认Exec/Icon都是绝对路径,且文件被标记为可信。
Linux 黑屏、透明度模糊异常或 GPU 崩溃→ 图形路径问题,不是装坏了:

FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major # 强制 swiftshader 软件渲染 FOLIA_LINUX_GRAPHICS_MODE=software ./folia-major # 仍不稳定时的最保守档位

Web 版能播歌但选不了本地音乐目录→ 你在用 HTTP,补上 HTTPS(反向代理 + CA 证书),并用桌面 Chromium 系浏览器。

企业官网建设流程全解析