Folia 手机安装完全指南10 分钟把 PWA 装进主屏幕全屏跑歌词动画播放器【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-majorFolia 是支持在线音乐与私有曲库的歌词动画播放器。它没有官方手机 App但 Folia PWA 开箱即用把 Web 版部署上线在手机浏览器里「添加到主屏幕」就能得到一个全屏独立窗口运行的歌词动画播放器。从部署到点开图标全程约 10 分钟。装之前先搞懂一件事PWA 说白了就是浏览器「当成 App 注册」的网页它能在主屏幕生成独立图标点图标启动的是脱离浏览器的独立窗口而不是一个网页标签页。但注册机制有一条硬性前提——站点地址必须是 HTTPS 安全地址。浏览器只对安全站点开放 PWA 安装资格离线能力同样建立在安全上下文之上。⚠️HTTPS是唯一绕不开的前置条件。地址是普通 HTTP 的话手机上大概率看不到安装入口离线预缓存也不生效。所以选部署方式时先问一句这个方案带不带 HTTPS。拿到手机能打开的地址Folia PWA 部署的三条路线你的情况做法大概耗时没有服务器Vercel / Cloudflare 一键部署约 5 分钟有 NAS / 自建服务器Docker 全栈部署几步配置想全程自己掌控克隆仓库部署到任意 Node.js 平台视环境而定路线一一键部署。仓库 README 自带 Vercel 与 Cloudflare 的部署按钮点击直达平台全程不碰服务器平台自带 HTTPS。如果还要接 QQ 音乐配置细节见 docs/qq-music-deployment.md。这条路大约 5 分钟走完。路线二Docker。把 deploy/docker 下的 compose 文件和.env模板拷到目标机器在.env里给SYNC_TOKEN填一个至少八位的随机字符串然后执行docker compose up -d。默认访问地址是http://NAS-IP:18080完整步骤与环境变量说明在 deploy/docker/README.md。路线三全程自持。克隆仓库https://gitcode.com/GitHub_Trending/fo/folia-major部署到任意支持 Node.js 的平台环境变量按 docs/technical.md 的说明逐项配置即可自由度和可控性最高。Folia 手机安装添加到主屏幕只要 3 步安卓用 Chrome 安装用 Chrome 打开 Folia 网页点右上角菜单⋮选**「添加到主屏幕」或「安装应用」**确认名称为 Folia点**「添加」**iPhone / iPad用 Safari 添加用 Safari 打开 Folia 网页点底部分享按钮⬆️上滑找到**「添加到主屏幕」**确认名称点**「添加」**主屏幕会出现一枚独立的 Folia 图标。点它启动的是全屏独立窗口没有地址栏没有标签页整块屏幕都交给歌词动画。两条路径加起来约 1 分钟。Folia 在手机上能做什么能 / 不能✅ 能在线搜索与播放网易云音乐、QQ 音乐、酷狗三个曲库都支持歌词动画主题响应式布局自动适配竖屏动画不截断私有曲库可接入自己部署的 Navidrome 实例❌ 不能导入本地音乐文件目录选择依赖桌面端的 File System Access API手机浏览器没有选本地目录的能力这条边界短期内绕不开为什么装完之后体验接近原生应用是四层机制叠出来的独立图标直接启动standalone显示模式跑全屏独立窗口Service Worker 预缓存核心资源弱网也能快速启动autoUpdate策略让部署新版后下次打开自动生效。这些设置写在 vite.config.ts 的 PWA manifest 里standalone、主题色#09090b、512×512 图标index.html 还内置了apple-mobile-web-app-capable等 iOS 全屏元标签——安卓和 iPhone 拿到的体验是对等的。两种真实用法竖屏歌词动画与自己的曲库竖屏歌词动画换个窗口尺寸排版自动重排每种风格有独立排版和可调参数并且随窗口尺寸重新计算。手机竖着拿布局自己重排动画不缩水、不截断。拿两款风格感受一下流光Lumière深色底叠加流动光效逐字入场、光晕强调OLED 屏上观感突出群唱Cappella对话气泡式排布多人轮流「开口」适合合唱向曲目主题配色还支持 AI 根据歌曲情绪与歌词自动生成——前提是部署时配置了 AI 密钥没配置也不影响正常播放。自己的曲库Navidrome 三步接入在 NAS 上用 Docker 部署 Navidrome挂载你的音乐目录在 Folia 的账户页接入你的 Navidrome 实例Folia 拉取曲库、封面与歌词歌词动画照常驱动音频文件始终留在 NAS手机只是通过 PWA 远程播放不占手机存储。桌面端本地曲库的导入与管理细节可参考 docs/local-library-management.md。遇到问题先试这几招如果找不到**「添加到主屏幕 / 安装应用」**入口 → 先检查地址栏是不是 HTTPS再试试安卓改用 Chrome、iOS 改用 Safari其他浏览器可能不显示入口最后重新加载一次页面。如果部署更新了、手机上还是旧版 → 先知道 Service Worker 更新有延迟autoUpdate策略下下次打开通常就生效长时间没变再清除一次站点数据或删掉图标重新添加。如果想导入手机里的音乐文件 → 本地导入仅桌面端 Chromium 系浏览器可用手机端走上面 Navidrome 的路线。如果在地铁、弱网里打不开 → 核心资源首次加载后已预缓存弱网下可以较快启动但音乐流本身仍要联网拉取音频。部署约 5 分钟打开地址 10 秒添加主屏幕 1 分钟——算下来全程不超过 10 分钟。在线曲库、私有曲库、全屏歌词动画往后都收在手机主屏幕的同一枚图标里。【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考