企业官网建设流程全解析

Folia 安装指南：5 分钟装好全屏歌词播放器，三条路径一次装对

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

Folia 是一款以全屏歌词动画为核心的音乐播放器，支持网易云、QQ 音乐、酷狗、Navidrome 和本地曲库。如果你在国内网络下从官方 Releases 拉安装包很慢，或想在 Linux 上少折腾依赖，这篇安装指南带你一次装对，全程 5 到 15 分钟。

动手前 30 秒自检

先花 30 秒确认三件事，选对路径能省一半时间：

• 系统类型：Windows、macOS（Apple silicon）走网盘；Arch / Manjaro 等 AUR 系发行版走 AUR 助手；Debian、Ubuntu 等其他 Linux 发行版用便携版
• 网络状况：国内网络访问官方 Releases 偏慢，优先选网盘镜像
• 打算装到哪里：想直接进系统菜单选 AUR；想解压即用、随时挪走选便携版；想省事就网盘

顺带一提，桌面版内置前后端运行环境，装完就能直接播放；它提供流光、浮名等多套全屏歌词主题，另有实验性 Folium 模组系统可以扩展歌词动画。

选路指南：按系统对号入座

对完号之后，直接跳到对应那一节，从第一步开始做。

Windows / macOS：网盘下载步骤

这条路径适合 Windows 和 macOS Apple silicon 用户，全程不需要命令行。

1. 打开仓库 README.md 的「快速下载」一节，里面给出夸克网盘与百度网盘两个入口（百度网盘提取码flia），只使用这里列出的官方链接，别碰来路不明的第三方转发包
2. 用夸克或百度客户端登录，把安装包转存到自己的网盘
3. 按平台挑文件：Windows 选.exe，macOS 选.dmg，macOS 用户确认是 Apple silicon 版本
4. 下载完成后双击安装，桌面版内置前后端运行环境，不需要额外配置

怎么确认装好了：打开 Folia，切一首带歌词的歌，全屏歌词动画正常滚动即说明装对了。

Arch / Manjaro：AUR 助手安装步骤

AUR 是 Arch 社区的第三方软件源，Folia 对应的包名是folia-major-bin，构建会自动解析alsa-lib、gtk3、libxss、nss等依赖。

1. 确认系统装了 yay 或 paru 等 AUR 助手，没有就先装一个
2. 执行安装命令：

yay -S folia-major-bin

应用会落在/opt/folia-major，并生成folia-major命令与系统菜单启动项，包定义细节可看 PKGBUILD。

怎么确认装好了：终端输入folia-major回车，主界面弹出来即成功；应用菜单里也能找到 Folia 启动项。

提速技巧（国内网络）：构建默认从官方 Releases 拉folia-major-<版本>-linux-x64.tar.gz，国内可能很慢甚至超时。先用网盘拿同版本压缩包放进构建源码目录（srcdir），再执行makepkg -si，就能跳过慢速下载这一步。

其他 Linux 发行版：便携版解压即用

Debian、Ubuntu 等发行版直接用tar.gz压缩包，解压就是完整便携版，不写系统目录。

1. 从官方 Releases 最新版本的folia-major-<版本>-linux-x64.tar.gz下载（国内网络慢就改用网盘），当前仓库版本为 0.7.23，见 package.json
2. 解压到自选目录，包内有folia-major可执行文件、resources/linux/icon.png图标和resources/linux/folia-major.desktop桌面启动项模板
3. 把.desktop模板复制到~/.local/share/applications/folia-major.desktop
4. 打开复制后的文件，把__APP_PATH__与__ICON_PATH__两个占位符替换成实际绝对路径，桌面环境有要求时再标记为可信

完整步骤见 README-LINUX.txt。

怎么确认装好了：在解压目录运行./folia-major，主界面弹出即部署成功。

装完之后

1. 切一首带歌词的歌，把全屏歌词动画拉满，先确认动画、字体渲染都正常
2. 进登录页配一个音乐源账号（网易云 / QQ / 酷狗 / Navidrome），再连本地曲库，之后选歌就方便了
3. 想玩点不一样的，可在「选项 → 桌面端」开启壁纸模式，把歌词动画铺到桌面上（需要 Wayland 合成器支持wlr-layer-shell，GNOME 不支持）

踩坑记录

问：AUR 构建卡在 tar.gz 下载或提示 404？答：AUR 包版本可能落后于官方最新版。先核对版本号，再用上面的预拉取技巧把 tar.gz 提前放进构建目录，再执行makepkg -si。

问：网盘里的版本比预期旧？答：镜像未必跟得上最新 release，动手前对一眼版本号，到官方 Releases 页面比对后再决定是否替换。

问：其他发行版装完应用菜单里没有启动项？答：依次核对三点——.desktop文件是否在~/.local/share/applications/下、__APP_PATH__与__ICON_PATH__两个占位符是否已替换、文件是否标记为可执行。

问：Linux 启动后黑屏、透明度/模糊异常或 GPU 崩溃？答：用软件渲染模式启动：

FOLIA_LINUX_GRAPHICS_MODE=swiftshader ./folia-major

仍不稳定则改用FOLIA_LINUX_GRAPHICS_MODE=software；恢复系统图形路径用FOLIA_LINUX_GRAPHICS_MODE=system。

问：想用 beta / alpha 通道？答：网盘只同步正式版，想体验测试通道只能走官方 Releases 页面，参考 docs/technical.md 的更新通道说明。

装好只是起点，打开 Folia 切上一首带歌词的歌，把全屏歌词动画拉满。想继续深挖，看这两份仓库内文档：deploy/docker/README.md 用 Docker Compose 自托管 Web 版，手机浏览器直接听；docs/technical.md 讲技术架构、Wayland / Hyprland 遥控窗与桌面端细节。

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