Folia 全屏歌词播放器安装教程Windows、macOS、Linux 与 NAS 从 0 到跑通【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major受够了屏幕底下那条小歌词栏Folia 就是答案。它把歌词渲染成全屏沉浸式动画背景主题还会随歌曲自动切换。本文覆盖 Windows/macOS、Arch、其他 Linux 与 NAS Docker 四条安装路线跟着做 30 分钟内装完。先按你的机器选对安装包四条路线不用挨个试看机器直接选你的机器安装形态步骤量需要提前备好Windows / macOS 桌面官方安装包下载、装、启动浏览器与下载工具Arch LinuxAUR 包 folia-major-bin1 条命令配好的 yay 或 paruUbuntu、Debian、Fedora 等 Linux便携版解压 两条命令用户目录写权限无桌面的 NAS 或服务器Docker Web 版4 步Docker Engine 24 与 Compose v2不管走哪条安装包都从仓库 README「快速下载」小节拿。⚠️ 只认那里的官方入口第三方转包内容没法核实别冒险。Windows 与 macOS双击安装拿到全屏歌词桌面版内置前后端运行环境不编译、不碰依赖。做什么打开 README 的「快速下载」小节拿最新安装包。Windows 是.exemacOS 是.dmgApple silicon 机器选对应版本。装完直接启动。✅ 验证开始菜单或应用程序里出现 folia-major 入口点它能打开主界面。装好的主界面长这样卡住了怎么办下载慢或断流换 README 里的网盘入口夸克或百度只提供 Windows 与 Apple silicon 正式版。启动后内容像旧版回 README「快速下载」核对版本号确认拿的是最新安装包。Arch一条命令装完 FoliaAUR 包folia-major-bin从 Releases 拉预构建的 linux-x64 压缩包。alsa-lib、gtk3、libxss、nss 四个运行依赖由 AUR Helper 自动装好打包逻辑见 PKGBUILD。做什么一条命令装完yay -S folia-major-bin # paru 用户把 yay 换成 paru结束后程序落在/opt/folia-major启动项一并注册。✅ 验证终端敲folia-major能启动应用菜单出现 folia-major 图标。卡住了怎么办AUR 构建要从 Releases 下载folia-major-版本-linux-x64.tar.gz。网络差就先网盘转存同版本压缩包放进构建源码目录再手动跑makepkg -si跳过慢速下载。其他 Linux便携版解压即跑适合 Ubuntu、Debian、Fedora。便携包含三样东西folia-major可执行文件、图标、桌面启动项模板都在resources/linux/下完整说明见 README-LINUX.txt。做什么把压缩包解压到固定目录先手动确认能跑再把启动项模板复制到用户应用目录./folia-major # 首次运行确认可执行 cp resources/linux/folia-major.desktop ~/.local/share/applications/然后编辑复制出的folia-major.desktop改两处__APP_PATH__换成语句的可执行文件绝对路径__ICON_PATH__换成resources/linux/icon.png的绝对路径。桌面环境有额外要求时把这个文件标记为可信。✅ 验证应用菜单出现 folia-major 图标点它能正常拉起主界面。到这里基本就成了。卡住了怎么办启动遇到黑屏、模糊异常或 GPU 崩溃改用软件渲染启动FOLIA_LINUX_GRAPHICS_MODEswiftshader ./folia-major # 仍不稳定就改 softwareNAS 与服务器Docker 四步上线 Folia Web 版适合没有桌面环境的机器。对外只开两个端口18080 是网页13000 是同步服务。其余服务只在 Docker 网络内部互通。做什么新建一个空目录从仓库deploy/docker/拿两个文件进去compose.yaml和.env.example后者改名为.env。手上没有仓库就先克隆https://gitcode.com/GitHub_Trending/fo/folia-major生成一段随机串当同步令牌粘进.env的SYNC_TOKENopenssl rand -hex 32 # 输出即令牌要求至少 8 位接着校验配置、拉镜像、起容器并检查状态docker compose config docker compose pull docker compose up -d --wait docker compose ps # 容器应全部 running✅ 验证浏览器访问http://NAS-IP:18080能看到 Folia 主界面http://NAS-IP:13000/health返回健康。Web 版在浏览器里的界面与桌面版一致在线音乐搜索、播放都可用关键参数速查其余都在.env模板里不懂用途就别动变量必填作用SYNC_TOKEN是同步服务令牌用上面的命令生成FOLIA_IMAGE_NAMESPACE有默认值镜像命名空间默认papersmanNAVIDROME_URLNAVIDROME_USERNAMENAVIDROME_PASSWORD可选三项都填后新浏览器自动登录这个 NavidromeFOLIA_HTTP_PORT/FOLIA_SYNC_PORT有默认值Web 端口 18080、同步端口 13000⚠️ 打算用本地曲库的话裸http://NAS-IP不属于浏览器安全上下文目录导入会不可用。先让 NAS 反向代理终结 HTTPS 再访问细节见 deploy/docker/README.md。第一次播放把这几项全打勾装完之后逐项过一遍全部打勾才算装完按下播放歌词铺满整个屏幕呈沉浸式动画网易云、QQ 音乐、酷狗或 Navidrome 至少登录成功一次来回切换不报错导入本地音乐目录元数据与同名.lrc歌词自动加载桌面版应用菜单有 folia-major 入口点它程序能拉起DockerSYNC_TOKEN生效/health返回健康本地曲库导入成功后页面长这样全部打勾之后可以打开 AI 主题生成让背景跟着歌曲情绪走或试试壁纸模式用法见 技术与开发说明。本地曲库的匹配、歌单与缓存细节在 本地音乐库管理。【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/11/2 6:22:05 · 阅读 1.2k Folia 全屏歌词播放器安装教程：Windows、macOS、Linux 与 NAS 从 0 到跑通
Folia 全屏歌词播放器安装教程Windows、macOS、Linux 与 NAS 从 0 到跑通【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major受够了屏幕底下那条小歌词栏Folia 就是答案。它把歌词渲染成全屏沉浸式动画背景主题还会随歌曲自动切换。本文覆盖 Windows/macOS、Arch、其他 Linux 与 NAS Docker 四条安装路线跟着做 30 分钟内装完。先按你的机器选对安装包四条路线不用挨个试看机器直接选你的机器安装形态步骤量需要提前备好Windows / macOS 桌面官方安装包下载、装、启动浏览器与下载工具Arch LinuxAUR 包 folia-major-bin1 条命令配好的 yay 或 paruUbuntu、Debian、Fedora 等 Linux便携版解压 两条命令用户目录写权限无桌面的 NAS 或服务器Docker Web 版4 步Docker Engine 24 与 Compose v2不管走哪条安装包都从仓库 README「快速下载」小节拿。⚠️ 只认那里的官方入口第三方转包内容没法核实别冒险。Windows 与 macOS双击安装拿到全屏歌词桌面版内置前后端运行环境不编译、不碰依赖。做什么打开 README 的「快速下载」小节拿最新安装包。Windows 是.exemacOS 是.dmgApple silicon 机器选对应版本。装完直接启动。✅ 验证开始菜单或应用程序里出现 folia-major 入口点它能打开主界面。装好的主界面长这样卡住了怎么办下载慢或断流换 README 里的网盘入口夸克或百度只提供 Windows 与 Apple silicon 正式版。启动后内容像旧版回 README「快速下载」核对版本号确认拿的是最新安装包。Arch一条命令装完 FoliaAUR 包folia-major-bin从 Releases 拉预构建的 linux-x64 压缩包。alsa-lib、gtk3、libxss、nss 四个运行依赖由 AUR Helper 自动装好打包逻辑见 PKGBUILD。做什么一条命令装完yay -S folia-major-bin # paru 用户把 yay 换成 paru结束后程序落在/opt/folia-major启动项一并注册。✅ 验证终端敲folia-major能启动应用菜单出现 folia-major 图标。卡住了怎么办AUR 构建要从 Releases 下载folia-major-版本-linux-x64.tar.gz。网络差就先网盘转存同版本压缩包放进构建源码目录再手动跑makepkg -si跳过慢速下载。其他 Linux便携版解压即跑适合 Ubuntu、Debian、Fedora。便携包含三样东西folia-major可执行文件、图标、桌面启动项模板都在resources/linux/下完整说明见 README-LINUX.txt。做什么把压缩包解压到固定目录先手动确认能跑再把启动项模板复制到用户应用目录./folia-major # 首次运行确认可执行 cp resources/linux/folia-major.desktop ~/.local/share/applications/然后编辑复制出的folia-major.desktop改两处__APP_PATH__换成语句的可执行文件绝对路径__ICON_PATH__换成resources/linux/icon.png的绝对路径。桌面环境有额外要求时把这个文件标记为可信。✅ 验证应用菜单出现 folia-major 图标点它能正常拉起主界面。到这里基本就成了。卡住了怎么办启动遇到黑屏、模糊异常或 GPU 崩溃改用软件渲染启动FOLIA_LINUX_GRAPHICS_MODEswiftshader ./folia-major # 仍不稳定就改 softwareNAS 与服务器Docker 四步上线 Folia Web 版适合没有桌面环境的机器。对外只开两个端口18080 是网页13000 是同步服务。其余服务只在 Docker 网络内部互通。做什么新建一个空目录从仓库deploy/docker/拿两个文件进去compose.yaml和.env.example后者改名为.env。手上没有仓库就先克隆https://gitcode.com/GitHub_Trending/fo/folia-major生成一段随机串当同步令牌粘进.env的SYNC_TOKENopenssl rand -hex 32 # 输出即令牌要求至少 8 位接着校验配置、拉镜像、起容器并检查状态docker compose config docker compose pull docker compose up -d --wait docker compose ps # 容器应全部 running✅ 验证浏览器访问http://NAS-IP:18080能看到 Folia 主界面http://NAS-IP:13000/health返回健康。Web 版在浏览器里的界面与桌面版一致在线音乐搜索、播放都可用关键参数速查其余都在.env模板里不懂用途就别动变量必填作用SYNC_TOKEN是同步服务令牌用上面的命令生成FOLIA_IMAGE_NAMESPACE有默认值镜像命名空间默认papersmanNAVIDROME_URLNAVIDROME_USERNAMENAVIDROME_PASSWORD可选三项都填后新浏览器自动登录这个 NavidromeFOLIA_HTTP_PORT/FOLIA_SYNC_PORT有默认值Web 端口 18080、同步端口 13000⚠️ 打算用本地曲库的话裸http://NAS-IP不属于浏览器安全上下文目录导入会不可用。先让 NAS 反向代理终结 HTTPS 再访问细节见 deploy/docker/README.md。第一次播放把这几项全打勾装完之后逐项过一遍全部打勾才算装完按下播放歌词铺满整个屏幕呈沉浸式动画网易云、QQ 音乐、酷狗或 Navidrome 至少登录成功一次来回切换不报错导入本地音乐目录元数据与同名.lrc歌词自动加载桌面版应用菜单有 folia-major 入口点它程序能拉起DockerSYNC_TOKEN生效/health返回健康本地曲库导入成功后页面长这样全部打勾之后可以打开 AI 主题生成让背景跟着歌曲情绪走或试试壁纸模式用法见 技术与开发说明。本地曲库的匹配、歌单与缓存细节在 本地音乐库管理。【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考