AI服务器机箱铝材焊接变形怎么控制 三个来源
2026/11/4 2:29:18
Folia 全屏歌词动画播放器安装指南：4 条路径从 0 到出声
【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major
Folia 是一个把歌词渲染成全屏动画的开源音乐播放器，接网易云、QQ 音乐、酷狗、Navidrome 和本地曲库。这篇 Folia 安装指南只做一件事：把它装进你的电脑或 NAS，并亲手验证它能出声。
选路
| 环境 / 场景 | 走哪条 | 预估耗时 |
|---|---|---|
| Windows / macOS 桌面 | 官方安装包一键装 | 约 5 分钟 |
| Arch / Manjaro | AUR 一行装 | 约 10 分钟（含构建） |
| Debian / Ubuntu / Fedora 等无 AUR 发行版 | Linux 便携版手动部署 | 约 10 分钟 |
| 手机 / 电视 / NAS 多设备 | Docker 部署 Web 版 | 约 15 分钟 |
国内网络从 GitHub Releases 拉包慢时，可用 README「快速下载」一节的网盘镜像，但它只覆盖 Windows 与 Apple silicon 的正式版，下完对一眼版本号。macOS 按芯片选包：Apple silicon 选 arm64，Intel 选 x64。便携版必须保留resources/与可执行文件同目录，别只拷folia-major一个文件。
官方安装包一键装（Windows / macOS）
前提：项目 Releases 页面能打开；当前桌面端版本0.7.23。
- 打开项目 Releases 页面，取最新版。
- Windows：下载
.exe安装包，双击运行，向导一路下一步。 - macOS：按芯片下载
.dmg（arm64 或 x64），把 Folia 拖进Applications。 - 从
Applications启动应用，别在挂载的 dmg 窗口里直接运行。
怎么算装对了：主窗口标题栏出现Folia，右下角播放球出现，搜一首歌能出声。
AUR 一行装（Arch / Manjaro）
前提：装好yay或paru任一 AUR helper。
- 确认 helper 可用：
yay --version- 构建安装（用
paru就把命令里换成它）：
yay -S folia-major-bin- 构建阶段它会拉取 release 的
linux-x64包，解到/opt/folia-major，并在/usr/bin建folia-major链接。依赖alsa-lib、gtk3、libxss、nss四条，可对照 packaging/aur/folia-major-bin/PKGBUILD：依赖与安装路径逐条可核。 - 构建长时间卡在下载步骤，就是国内直连 GitHub 慢，别干等，改用便携版手动部署。
怎么算装对了：应用菜单出现 Folia 入口，终端敲folia-major能弹出主窗口。
Linux 便携版手动部署（Debian / Ubuntu / Fedora）
前提：从 Releases 取到linux-x64.tar.gz（Debian 也可直接取.deb，Fedora 取.rpm）。
- 解压压缩包，目录里保留三件套：
folia-major可执行文件、resources/linux/icon.png、resources/linux/folia-major.desktop，三者同目录，缺一不可。 - 先确认能启动：
./folia-major- 把桌面项模板复制进应用菜单：
cp resources/linux/folia-major.desktop ~/.local/share/applications/folia-major.desktop- 打开复制出的文件，把
__APP_PATH__、__ICON_PATH__两个占位符替换为可执行文件和图标的绝对路径。 - 桌面环境弹提示时，给这个
.desktop文件标记为可信。 - 占位符写法与图形变量细节见 packaging/linux/README-LINUX.txt：桌面项模板与排障说明。
怎么算装对了：应用菜单出现 Folia 且图标正常，终端再跑一次./folia-major，主窗口照常弹出。
Docker 部署 Web 版（手机 / 电视 / NAS）
前提：Docker Engine 24+ 与 Docker Compose v2；部署不需要 clone 源码。
- 建工作目录：
mkdir folia-docker && cd folia-docker- 从仓库
deploy/docker/目录取compose.yaml与.env.example两个文件放进目录，把.env.example改名为.env。 - 生成同步令牌：
openssl rand -hex 32- 把输出写入
.env的SYNC_TOKEN（至少 8 位）；AI 相关配置留空，不影响播放。 - 校验配置：
docker compose config- 拉取镜像并启动：
docker compose up -d --wait- 看容器状态：
docker compose ps怎么算装对了：浏览器访问http://NAS-IP:18080出页面，http://NAS-IP:13000/health返回健康检查通过，docker compose ps里所有容器状态为 running。网易云、酷狗、QQ 音乐 API 都收在 gateway 后面，不单独暴露端口。
首跑清单
- 版本→「帮助」里的版本更新弹窗显示当前版本号，应与你下载的一致，桌面端基线是
0.7.23。 - 界面→ 主窗口加载出标题与播放球，本地曲库能列出已导入文件。
- 歌词动画→ 搜一首带逐字歌词的歌，全屏动画正常出字。
- 日志→ 桌面端在「设置 → 开发者」面板读日志，勾「写入本地文件」后落盘到
logs/runtime/；启动报错时这里是第一现场。
排障
| 现象 | 大概率原因 | 处理 |
|---|---|---|
| macOS 弹「应用已损坏」 | 未做签名公证，浏览器下载带隔离属性 | 终端执行xattr -dr com.apple.quarantine /Applications/Folia.app后重开 |
| macOS 每次更新后又被拦 | 应用不支持自动更新，新包装了隔离属性 | 每次覆盖安装后再执行一次上面的xattr命令 |
| Linux 启动黑屏、透明度或模糊异常 | 当前显卡上 GPU 渲染路径不稳 | FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major，仍闪再换software |
| X11 提示没有可用的 WebGPU | Electron 默认关闭了 Vulkan | FOLIA_LINUX_VULKAN=1 ./folia-major --ozone-platform=x11，常见于 X11 / XWayland，Wayland 下别开 |
| AUR 构建长时间卡在下载 | 国内直连 GitHub Releases 慢 | 转便携版路线，用tar.gz手动部署 |
docker compose up起不来 | SYNC_TOKEN未填或少于 8 位 | 填入openssl rand -hex 32的输出，再执行docker compose up -d --wait |
延伸阅读
- docs/technical.md：桌面项细节、Wayland 与遥控窗
- deploy/docker/README.md：Web 版环境变量表与 NAS 反代
- docs/local-library-management.md：本地曲库导入、重扫与在线匹配
- docs/desktop/macos-app-damaged.md：macOS 首开拦截弹窗的完整处理
四条路径走通任意一条，丢一首带逐字歌词的歌进去，剩下的交给歌词。
【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考