Folia 全屏歌词动画安装指南3条路径快速跑起来【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major装完的 Folia 长这样你导入一个本地文件夹或者登录网易云、QQ 音乐、酷狗随便点一首带歌词的歌整块屏幕会被歌词动画占满——字跟着节拍跳动主题跟着歌曲情绪换配色像给自己做了个文字 PV。本文带你从零走完全流程桌面党约 10 分钟终端党约 5 分钟服务器自托管约 30 分钟。先定路线你是哪种用户走哪条安装路径这节帮你 1 分钟选对路省得装到一半发现选错渠道。图形界面党装在自己日常用的 Windows 或 Mac 上只想双击就能听 → 走「桌面版」路线。终端党Linux 用户习惯命令行要 AUR 一行装完或解压即跑 → 走「命令行」路线。服务器党有 NAS 或一台闲置 Linux 机器想让全家用浏览器访问 → 走「Web 自托管」路线。图形界面党Windows / macOS 桌面版安装步骤这节帮你把安装包从下载到双击启动全程不碰命令行。挑对安装包。去项目的 Releases 页面下载Windows 选.exemacOS 选.dmg。国内网络直连慢的话走 README「快速下载」一节给的官方网盘镜像百度云提取码flia。⚠️ 网盘只同步 Windows 与 Apple silicon 两个正式版下载前先核对文件名里的版本号和 Releases 最新值一致再动手。跑完安装向导。双击安装包一路下一步即可桌面版内置前后端运行环境不需要你另装 Node.js 之类的东西。启动核对。应用列表里找到 Folia 双击打开确认能进主界面。 全程约 10 分钟装完直接可用。终端党Linux 命令行安装步骤这节帮你用一条命令或一次解压把 Folia 装进 Linux。Arch 系一行命令。确认装了 AUR Helperyay 或 paru然后执行# 从 AUR 安装二进制包paru 用户把 yay 换成 paru yay -S folia-major-bin包会自动解决alsa-lib、gtk3、nss等依赖把程序装进/opt/folia-major并生成应用菜单启动项依赖清单见 PKGBUILD。⚡ 构建时拉取 Linux 压缩包慢的话先从网盘下同版本folia-major-版本-linux-x64.tar.gz放进 AUR 源码目录再执行makepkg -si。其他发行版解压便携版。从 Releases 下载folia-major-版本-linux-x64.tar.gz解压到任意目录./folia-major直接跑可执行文件和resources/保持同目录。补一个菜单启动项可选。把resources/linux/folia-major.desktop复制到~/.local/share/applications/把里面的__APP_PATH__、__ICON_PATH__占位符替换成实际路径细节看 Linux 便携版说明。服务器党NAS Web 版自托管步骤这节帮你在 Docker 环境上起一个全家都能用浏览器访问的 Web 版。确认环境。需要 Docker Engine 24 与 Docker Compose v2。准备两个文件。把仓库里的 compose.yaml 和 compose.example 环境变量模板 拷进一个空目录模板重命名为.env。生成同步密钥。执行下面命令把输出填进.env的SYNC_TOKEN至少 8 位AI 配置留空也不影响播放# 生成 64 位随机十六进制串用作同步服务令牌 openssl rand -hex 32启动并验证。依次执行docker compose config docker compose pull docker compose up -d --wait docker compose ps浏览器打开http://NAS-IP:18080能进主界面即成功同步服务在 13000 端口。完整环境变量与 HTTPS 要求见 Docker 部署文档。⚠️ 局域网普通 HTTP 下本地音乐目录导入这类能力会受限正式用建议让 NAS 反代挂上 HTTPS。装完自检5 项逐条确认这节帮你花 2 分钟确认「真的装好了」而不是「好像能打开」。应用能正常启动进主界面且版本号与你下载文件一致AUR 包的版本可能比最新 release 落后一个小版本属正常登录一个在线音源网易云 / QQ / 酷狗或导入一个本地音乐文件夹播放一首带歌词的歌全屏歌词动画能正常亮起来想换风格时能在设置里切换主题Web 版http://NAS-IP:18080可访问docker compose ps里各服务都在运行高频卡点3 个最常见的问题怎么处理这节帮你避开 90% 的人装 Folia 时踩的坑按「现象 → 原因 → 解法」直接给答案。1. 下载一直中断或只有几 KB/s→ 原因国内网络直连 GitHub Releases 不友好。 → 解法换官方网盘镜像提取码flia下载前核对版本号Linux 包网盘不提供只能直连下载或先手动下好压缩包再本地构建 AUR 包。2. Linux 启动后黑屏、透明度异常或闪退→ 原因显卡驱动不配合导致的黑屏是兼容问题不是程序坏了。 → 解法先用软件渲染验证# 以软件渲染模式启动确认是否显卡兼容问题 FOLIA_LINUX_GRAPHICS_MODEswiftshader ./folia-major仍不稳定就换成FOLIA_LINUX_GRAPHICS_MODEsoftware ./folia-major再试。3. Linux 便携版解压后应用菜单里没有 Folia→ 原因便携版不会自动注册启动项只带一个桌面模板。 → 解法把resources/linux/folia-major.desktop复制到~/.local/share/applications/替换__APP_PATH__与__ICON_PATH__两个占位符为实际路径再按桌面环境要求标记为可信。下一步让它亮起来现在就打开刚装好的 Folia指向你那个带.lrc歌词文件的本地文件夹放第一首——全屏歌词动画马上见分晓。【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考