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-majorTL;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 / macOSWindows:双击安装器一路下一步结论:取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_MODEswiftshader ./folia-major # 强制 swiftshader 软件渲染 FOLIA_LINUX_GRAPHICS_MODEsoftware ./folia-major # 仍不稳定时的最保守档位Web 版能播歌但选不了本地音乐目录→ 你在用 HTTP,补上 HTTPS(反向代理 CA 证书),并用桌面 Chromium 系浏览器。延伸阅读deploy/docker/README.md:Docker 全栈的环境变量、NAS 反向代理与 HTTPS 证书要求。docs/desktop/macos-app-damaged.md:macOS 拦截的完整排错流程。packaging/linux/README-LINUX.txt:FOLIA_LINUX_GRAPHICS_MODE图形变量与壁纸模式细节。【免费下载链接】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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考