Folia 全屏歌词播放器完整安装教程10 分钟从下载文件到首次播放【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-majorFolia 是一款全屏沉浸式歌词播放器支持网易云、QQ 音乐、酷狗、Navidrome 与本地音乐库桌面端另接波点音乐、YouTube Music、Spotify 与汽水音乐。按下面的步骤操作约 10 分钟可以完成下载安装并播放第一首带歌词的歌。使用场景速配先找到你该看的步骤使用场景推荐方式预计耗时Windows 64 位桌面官方网盘或 Releases 下载.exe安装包约 10 分钟macOSApple silicon官方网盘或 Releases 下载.dmg镜像约 10 分钟macOSIntelReleases 下载.dmg镜像网盘无此包约 15 分钟Arch LinuxAUR 预构建包folia-major-bin约 5 分钟其他 Linux 发行版Releases 下载.tar.gz便携包命令行运行约 15 分钟NAS / 手机浏览器Docker Compose 全栈容器约 20 分钟主流程从下载文件到首次启动步骤一获取正确安装包的方法先确认当前版本号是0.7.23再按平台挑文件。文件命名有固定规律下载前逐字核对平台与架构标识x86_64 与 ARM 的包不通用WindowsFolia-Setup-0.7.23.exemacOS.dmg镜像Linuxfolia-major-0.7.23-linux-x64.tar.gz下载渠道只有两种按网络情况选官方网盘夸克网盘 / 百度百度提取码flia适合国内网络。⚠️ 网盘只提供Windows 与 Apple silicon的正式版安装包Intel Mac 和 Linux 包没有镜像必须回 Releases 页面找。Releases 页面Windows / macOS / Linux 全平台安装包都在这里国内直连容易慢或断流建议开断点续传。Arch Linux 用户两条渠道都不用走直接用 AUR 包。入口细节见 README.md 的「快速下载」与「获取方式」两节。通过标准✅ 本地文件不是 0 字节、未截断文件名里的版本号0.7.23与平台标识和你的机器一致。步骤二安装或部署Windows / macOS 桌面版全程不碰命令行Windows双击Folia-Setup-0.7.23.exe按向导走完安装目录可自选。macOS打开.dmg把 Folia 拖进 Applications 文件夹在应用列表里确认出现 Folia 图标。桌面版把前后端运行环境都打包进了安装程序不用预装 Node.js 或任何开发工具装完即用。Arch 用户额外需要 AUR Helperyay 或 paru。Arch Linux命令行打开终端输入下面这一条依赖alsa-lib、gtk3等会自动解决程序落到/opt/folia-major并生成应用菜单项yay -S folia-major-bin依赖清单与安装位置可对照 PKGBUILD 核对。其他 Linux 发行版Debian、Ubuntu 等把folia-major-0.7.23-linux-x64.tar.gz解压到任意目录即可运行。想让应用菜单出现入口把包内resources/linux/folia-major.desktop模板复制到~/.local/share/applications/将__APP_PATH__、__ICON_PATH__两个占位符替换为实际路径再按桌面环境要求标记为可信步骤细节见 README-LINUX.txt。NAS / WebDocker 部署要求 Docker Engine 24 与 Compose v2。把 deploy/docker/ 里的 Compose 全栈放到 NAS 上编辑.env填入SYNC_TOKEN至少八位随机字符串例如openssl rand -hex 32的输出然后执行docker compose up -d端口规划与环境变量见 deploy/docker/README.md。通过标准✅ Windows/macOS 在应用列表看到 Folia 图标Arch 在应用菜单出现新入口其他 Linux 的tar.gz目录完整解压出folia-major可执行文件NAS 上容器状态为运行中。步骤三首次启动的验收标准Windows / macOS双击启动 Folia。主界面正常加载、歌曲搜索框可以点即启动成功。Linux在解压目录的终端执行./folia-major命令行窗口跑起来、界面正常渲染即通过。NAS / Web浏览器打开http://NAS-IP:18080能加载页面即通过把网页添加为主屏幕 PWA 后手机上就能当 App 用。通过标准✅ 应用或页面可以打开主界面正常显示。首次体验三步确认装对了核对版本号进入「关于」页面显示的版本应与刚下载的包一致当前为0.7.23网盘镜像偶尔比 Releases 晚一拍对不上直接重新下载。完成一次最小体验登录一个在线音源或导入一个本地音乐文件夹播一首带歌词的歌全屏歌词动画会自动亮起来。切换主题进设置切两三个主题每个主题的排版氛围都不一样。故障排查常见现象与解决办法现象可能原因解决办法下载慢、反复中断国内到 GitHub Releases 链路差换官方网盘镜像以 README「快速下载」入口为准Linux 包没有镜像只能走 Releases 并开断点续传Linux 黑屏、透明度/模糊异常或闪退GPU 兼容问题不是装坏了先软件渲染验证FOLIA_LINUX_GRAPHICS_MODEswiftshader ./folia-major仍不稳定就换最保守的software模式确认无碍后可再用system值恢复系统图形路径打不开或启动报架构错误Intel Mac 误用 Apple silicon 包或 Linux 选错架构回 Releases 按系统重选一次文件名里的平台标识逐字看一遍下一步把播放器变成你的装完后的第一件事是去设置里挑一个喜欢的主题每个动画的排版氛围都不同。桌面版还可以打开「设置 → 模组」里的 Folium 模组系统默认关闭从模组市场安装官方认证的歌词动画与新背景玩法详见 mods/README.md。【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考