如何快速装好 Folia?三条路线 10 分钟搞定歌词动画播放器安装部署完整指南【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major照做完,你能在 10 分钟内跑起一台全屏歌词动画播放器,接入本地曲库、Navidrome 或网易云、酷狗等在线音源。Folia 是专注沉浸式歌词动画的本地/在线多平台音乐播放器,提供桌面与 Web 两种形态,覆盖 PC、NAS 自托管和浏览器使用场景。先看运行效果Folia 把歌词做成全屏视觉:文字随多种动画排版浮在背景上,可配合 AI 生成的配色主题。主界面支持歌单轮播、搜索与本地库管理:按你的情况选方案使用场景前置条件耗时推荐方案Windows / macOS 听歌网盘账号,或网络能直连 Releases约 5 分钟下载桌面安装包Arch 以外的 Linux终端和一个可运行目录约 10 分钟Linux 便携版 tar.gzArch Linuxyay 或 paru约 5 分钟AUR 包 folia-major-bin移动端 / 浏览器 Web 版Vercel 或 Cloudflare 账号,或 Docker 主机10~20 分钟一键 Web 部署安全提示只使用 README.md 给出的官方入口Releases 页面、夸克网盘、提取码flia的百度云勿下载第三方转发包。方案一桌面安装包Windows / macOS准备工作确认系统版本Windows 拿.exe安装包macOSApple silicon拿.dmg核对版本号当前发布版本为 0.7.20下载后看安装包文件名是否与之一致操作步骤打开 README.md在「快速下载」与「直接下载」小节复制官方夸克网盘或百度云入口网络顺畅时也可直接去 Releases 页面登录网盘客户端先把安装包转存到自己的网盘再开始下载网盘仅提供 Windows 与 Apple silicon 正式版双击安装包按提示完成安装全程不超过 3 步桌面版内置前后端运行环境装完即用怎么算装好了从开始菜单或 Launchpad 双击图标弹出全屏歌词界面即算装好。macOS 可用下面的命令确认应用入口存在# 验证 Folia 应用可被启动 open -a Folia方案二Linux 便携版tar.gz 解压即用准备工作到 Releases 页面拿到folia-major-0.7.20-linux-x64.tar.gz准备一个长期固定的目录存放应用例如~/Apps/Folia操作步骤解压便携版到目标目录# 解压到固定目录 tar -xzf folia-major-0.7.20-linux-x64.tar.gz -C ~/Apps/Folia直接运行目录里的可执行文件# 文件管理器里双击,或终端直接运行 ./folia-major可选创建桌面启动项把包内模板复制到用户应用目录再把__APP_PATH__、__ICON_PATH__两个占位符替换成实际路径改法见 packaging/linux/README-LINUX.txt# 复制桌面启动项模板 cp resources/linux/folia-major.desktop ~/.local/share/applications/Linux 端接入网易云后的主界面长这样怎么算装好了终端执行./folia-major能弹出窗口且应用菜单中出现 Folia 启动项即算完成。方案三Arch Linux 一条命令装 AUR 包准备工作确认装有 yay 或 paru 等 AUR Helper没有就先装一个# 安装 yay yay -S yay操作步骤安装 AUR 包命令里的 yay 换成 paru 也行alsa-lib、gtk3、nss等依赖会自动处理程序装进/opt/folia-major# 通过 AUR 安装 folia-major-bin yay -S folia-major-bin若构建卡住拉不到压缩包先手动备好同版本 tar.gz 放进 AUR 构建的源码目录再到构建目录执行# 在构建目录中手动构建并安装 makepkg -si构建逻辑在 packaging/aur/folia-major-bin/PKGBUILD版本同步脚本见 update.sh。怎么算装好了# 查看已安装的包条目与版本号 pacman -Qs folia-major输出里出现folia-major-bin且版本与 AUR 页面一致应用菜单里也有folia-major启动项即算装好。方案四Web 版一键部署浏览器 / 移动端准备工作备好 Vercel 或 Cloudflare 账号有能跑 Docker 的主机也可以打算接 QQ 音乐的话提前记下需要配置的两个环境变量名操作步骤打开 README.md 的「一键部署」小节点 Deploy 按钮创建项目部署完成后得到一个可访问地址接入 QQ 音乐把VITE_QQ_API_BASE填成/api/qq再配服务端密钥QQ_SESSION_SECRET不加VITE_前缀平台差异与排错方法见 docs/qq-music-deployment.md走 Docker 全栈部署本地音乐目录依赖可信 HTTPS 环境按 deploy/docker/README.md 执行自托管 Web 版接入 Navidrome 后的主页效果怎么算装好了# 替换成你自己的域名,验证部署地址可访问 curl -I 你的部署域名返回 HTTP 200、浏览器里看到 Folia 界面即算就绪还可以把网页安装成 PWA 放到手机桌面。排障速查症状常见原因立即动作Linux 启动黑屏、透明度/模糊异常、GPU 崩溃显卡渲染兼容问题用FOLIA_LINUX_GRAPHICS_MODEswiftshader ./folia-major启动仍不稳就改softwareAUR 构建卡在下载压缩包从 Releases 拉包速度慢提前把同版本 tar.gz 放进构建源码目录再执行makepkg -si网盘里的包和最新版对不上网盘镜像更新有延迟到 Releases 页面核对版本号后重新下载Web 版 QQ 音乐无法播放QQ API 环境变量缺失补配VITE_QQ_API_BASE/api/qq与QQ_SESSION_SECRET见 docs/qq-music-deployment.md装完之后换歌词动画主题README「部分主题预览」列出了浮名、流光、心象、云阶等排版的氛围与可调参数在播放器内切换即可开启模组系统桌面用户在「设置 → 实验室 → 模组系统」打开后可从模组市场装官方认证模组规范见 mods/README.md导入本地曲库docs/local-library-management.md 覆盖导入、重扫、在线歌词匹配与实体编辑部署与环境变量细节看 docs/technical.md选定一条匹配你系统的路线装完后下一步就是导入本地曲库或登录在线音源播一首歌全屏歌词动画才算真正开始 【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考