Folia 全屏歌词播放器:四条路线装完-尧图网站建设

Folia 全屏歌词播放器:四条路线装完

【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major

从海外发布页拖一个播放器安装包,200KB/s 慢得发指。这篇 Folia 全屏歌词播放器部署教程覆盖四条路线:Windows/macOS 免配置安装、Arch 一条命令、其他 Linux 便携版、Docker 部署 Web 版。每条路线花几分钟,照做即用。

Folia 安装路线怎么选:10 秒判断

四条路线只分一个变量:装在哪台机器上。对照下面列表直接跳到对应章节即可:

桌面是 Windows 或 macOS,想开箱即用 → 路线一
桌面是 Arch Linux,会用终端 → 路线二
桌面是其他 Linux(Ubuntu、Debian、Fedora 等)→ 路线三
机器是服务器或 NAS,靠浏览器访问(手机可装 PWA)→ 路线四

三条桌面路线只是分发渠道不同,程序本体一致;只有 Web 版需要一台能常驻的机器。

路线一:Windows/macOS 下载并安装 Folia 安装包

桌面版内置前后端运行环境,装完免配置,只需选对渠道和架构。

第一步:从项目 README 的"直接下载"小节取入口:海外网络走 Releases 最新版,国内网络走官方给出的夸克或百度网盘(百度提取码flia)。第二步:下载对应平台的安装包:Windows 是.exe,macOS 是.dmg。第三步:直接运行。Windows 双击走完向导;macOS 把应用拖进 Applications 目录即可。

⚠️ 网盘镜像只收录 Windows 与 Apple silicon 的正式版;Intel Mac 或 ARM Windows 用户请从 Releases 入口取对应版本,第三方转发包一律不碰。

装完后系统菜单会出现 Folia 入口,双击即可拉起。

路线二:Arch Linux 一条命令 AUR 安装 Folia

预编译包folia-major-bin已收录进 AUR,前提是装好任意 AUR Helper(yay 或 paru)。

第一步:在终端执行:

yay -S folia-major-bin # paru 用户把 yay 换成 paru

执行后终端会自动解决alsa-lib、gtk3、libxss、nss四个依赖,无需手动处理。

第二步:等构建结束后验证:

which folia-major

执行后看到/usr/bin/folia-major输出,说明程序本体已落在/opt/folia-major,菜单入口也同步生成。

💡 构建会从发布页拉取 Linux 便携包,这一步慢的话,可先把同版本压缩包放进 AUR 构建目录的源码位置,再用makepkg -si续构建以跳过慢速下载。

路线三:其他 Linux 发行版便携版部署三步走

第一步:获取folia-major-<版本>-linux-x64.tar.gz便携包(入口在项目 README 的"直接下载"小节),解压到不会再挪动的目录,如~/Apps/Folia/。目录里有两个关键内容:folia-major可执行文件与resources/linux/资源目录。第二步:把桌面启动项模板复制到用户应用目录:

cp resources/linux/folia-major.desktop ~/.local/share/applications/

执行后无输出即复制成功;再打开这个文件,把__APP_PATH__替换为可执行文件绝对路径,__ICON_PATH__替换为resources/linux/icon.png的绝对路径。第三步:如果你的桌面环境有要求,把该.desktop文件标记为可信或可执行,之后即可从菜单或folia-major命令启动。

⚠️ 可执行文件与resources/必须留在同一便携目录,这是启动黑屏、图标丢失的常见原因。

路线四:服务器或 NAS 用 Docker 部署 Folia Web 版

想用浏览器或手机访问 Folia,就部署 Web 版。整个过程不需要源码,只需要两个文件。

第一步:准备 Docker Engine 24+ 与 Compose v2。新建空目录,从项目 deploy/docker/ 目录取compose.yaml与.env.example放入,并把后者改名为.env。第二步:生成同步令牌:

openssl rand -hex 32

执行后输出一串 64 位十六进制字符串,粘贴进.env的SYNC_TOKEN。FOLIA_IMAGE_NAMESPACE保留模板默认的papersman,AI 相关配置留空不影响播放。第三步:验证并启动:

docker compose config docker compose pull docker compose up -d --wait docker compose ps

执行后ps里各服务均为运行状态;浏览器打开http://<服务器IP>:18080即进入 Folia Web 版。

💡 对外只暴露两个端口:Web 网关18080与 Sync Server13000,在线音乐接口全部经网关转发,无需逐个放行。

Folia 安装验证:按顺序确认 3 项

播放任意歌曲,歌词被渲染为全屏动画,而不是一行滚动的文字
登录后能在网易云、QQ 音乐、酷狗、Navidrome 与本地音乐库之间正常切换
启动入口稳定:桌面路线用菜单里的folia-major;Web 路线用http://<服务器IP>:18080

三项全勾,部署完成,可以直接开始选歌。

Folia 安装排障:4 个高频问题

症状:Linux 启动后黑屏、透明度异常或闪退。原因:默认图形路径与显示栈不匹配。处理:改用软件渲染路径启动:

FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major

执行后窗口应正常显示、歌词动画能渲染;仍不稳定再降到最保守的FOLIA_LINUX_GRAPHICS_MODE=software。

症状:X11 桌面提示智能动感模式没有可用的 WebGPU。原因:X11 下未手动开启 Vulkan。处理:

FOLIA_LINUX_VULKAN=1 ./folia-major --ozone-platform=x11

执行后 WebGPU 提示应消失;该变量只在 X11(含 XWayland)生效,Wayland 下会被忽略。

症状:macOS 装完行为异常,或网盘下到的版本与机器不符。原因:网盘镜像只收录 Windows 与 Apple silicon 正式版。处理:回 README"直接下载"入口重下,Intel Mac 取 Intel 版,M 系列芯片取 Apple silicon 版。

症状:Docker 部署后浏览器打不开 18080。原因:端口未放行,或.env未填全。处理:看docker compose ps的输出,确认FOLIA_IMAGE_NAMESPACE与SYNC_TOKEN两个变量非空,镜像命名空间缺失时 Compose 会直接拒绝启动。

资讯详情

Folia 全屏歌词播放器:四条路线装完