3步把Folia歌词动画装进手机免费部署PWA安装完整指南【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-majorFolia 是一个主打全屏歌词动画的音乐播放器曲库覆盖网易云音乐、QQ 音乐、酷狗与 Navidrome这些动画在手机上能完整跑起来。本文帮你做完三件事把 Web 版部署到手机能访问的地址、以 PWAProgressive Web App一种装进手机主屏的网页应用的方式安装、再用 Navidrome 把自己的歌接进来。不需要服务器也不需要 Docker 经验。先弄懂手机端能干什么、不能干什么结论手机上就是「歌词动画播放器 在线/Navidrome 曲库」其余能力与桌面版一致。各主题的排版会响应式自动适配竖屏不裁剪也不拥挤上面是真实渲染效果。能用的在线搜索播放、歌词动画、Navidrome 曲库、主题速编风格和参数随时可调以及部署时配了 AI 密钥时的主题配色自动生成。不能用的导入手机存储里的本地音频文件。原因写在明处——本地目录导入依赖 File System Access API一套只被桌面端 Chromium 系浏览器支持的选目录接口手机端没有这个能力这部分留给桌面版做。部署前的三道核验地址、浏览器、预期结论地址不是 HTTPS后面全部白费这三道门先过安装一次成型。核验项达标标准不达标怎么办访问地址HTTPS地址栏有锁标志换免费托管平台或给 NAS 配反向代理替你终结 HTTPS 的转发层与可信证书手机浏览器安卓用 ChromeiOS 用 Safari换对应浏览器再打开功能预期在线播放、歌词动画、Navidrome 可用本地导入不可用本地导入留给桌面版三种一键部署方法按你的条件挑一条结论先选对路线再动手每条路线的细节都在部署文档里。路线适合谁入口与关键命令一键托管Vercel / Cloudflare没有服务器想几分钟上线项目内置的一键部署按钮自带 HTTPS 与域名Docker 全栈有 NAS 或自建服务器编辑.env后执行docker compose up -d默认地址NAS-IP:18080克隆仓库自行部署想完全控制环境变量git clone https://gitcode.com/GitHub_Trending/fo/folia-major再按部署文档配置一键托管最省事HTTPS 和域名都不用管。Docker 面向 NAS 用户编排文件在 deploy/docker/compose.yaml.env里要填一个至少 8 位的SYNC_TOKEN缺了容器起不来。QQ 音乐的 serverless 配置另见 QQ 音乐部署指南。手机安装 PWA 步骤安卓与 iPhone 分开看结论部署完成后用浏览器打开地址、添加到主屏即可验证方式比步骤更重要。安卓Chrome用 Chrome 打开 Folia 地址。点右上角菜单⋮。选「安装应用」或「添加到主屏幕」。确认名称为 Folia点添加。iPhoneSafari用 Safari 打开 Folia 地址。点底部分享按钮。上滑找到「添加到主屏幕」点击。确认名称点添加。验证装对了没有点主屏图标应用直接以独立全屏窗口启动没有地址栏和标签页就是装对了iPhone 上状态栏与应用融为一体看不到任何浏览器痕迹。网易云、QQ 音乐、酷狗的登录态存在手机浏览器里登录一次之后很长一段时间不用重复登。进阶用 Navidrome 在手机上听自己的歌结论文件留在 NAS手机只拉流式播放省空间也省流量。原理一句话歌放在 NAS 上Navidrome 扫描后以流媒体曲库对外服务手机 PWA 只负责拉曲库、封面和歌词。在 NAS 上用 Docker 部署 Navidrome挂载你的音乐目录。在 Folia 的账户页接入 Navidrome 服务。地址必须是每台设备都够得到的地址Web 版走 HTTPS 时它也得是 HTTPS否则浏览器会拦截混合内容HTTPS 页面里出现的 HTTP 资源。曲库与封面同步完成后直接播放。缺失的歌词可以通过智能匹配自动补齐歌词动画照常驱动。桌面端本地曲库的管理方式可参考本地曲库管理文档。常见故障排查5 个高频问题对照表结论五个问题都只对应一类原因按下表先对现象再动手。现象原因处理菜单里没有「添加到主屏幕」访问的是 HTTP 地址或没用 Chrome/Safari换成 HTTPS 地址免费托管自带NAS 用户按 Docker 部署说明 配反向代理与可信证书再重载页面更新后还是旧版本Service Worker浏览器里替网页做缓存更新的后台脚本的 autoUpdate 一般下次打开才生效偶尔卡住清除一次站点数据或删掉图标重新添加到主屏手机端找不到本地导入入口入口本来就不存在File System Access API 仅桌面端 Chromium 系浏览器支持「自己的歌」走 Navidrome 路线本地导入留在桌面版Navidrome 连上却加载失败地址是 Docker 内部主机名手机够不到或页面 HTTPS 而地址 HTTP改成各设备可达的地址需要时对齐到 HTTPS换 HTTPS 后登录态消失HTTP 与 HTTPS 属于不同 origin数据不会自动迁移重新登录并配置一遍上线后不要来回切换地址给新手的最短上手路径结论先跑通动画再接曲库不要一开始就全都要。顺序固定先用一键托管把 Folia 跑起来接一个在线曲库把歌词动画流程走通稳定之后再上 Navidrome把「自己的歌」补进来。走完这条路径手机上就有一个免费、全屏、能播自己曲库的歌词动画播放器。【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考