Folia 手机 PWA 完整指南把全屏歌词动画免费装进手机【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-majorFolia 是一款 Web 版音乐播放器核心卖点就是全屏歌词动画曲库覆盖网易云、QQ 音乐、酷狗与 Navidrome。商店没有现成 App但把 Web 版以 PWA 加到手机主屏就能当独立全屏应用跑。 Folia 手机端能力速览能干什么不能干什么手机端不是桌面版的完整复制能力被切成了两半装之前值得先看清楚。能做的全屏歌词动画各主题排版自动适配竖屏不裁剪也不拥挤搜索播放网易云、QQ 音乐、酷狗在线曲库登录态存在浏览器里登录一次管很久接入 Navidrome 个人曲库流式播放自己的歌随时切换主题AI 自动给歌曲生成配色部署时配好 AI 密钥即可不能做的把手机存储里的音频文件导入曲库——本地目录导入依赖 File System Access API只有桌面端 Chromium 系浏览器支持使用桌面版的本地曲库管理功能手机本地导入这件事留给桌面版手机上听「在云里的歌」就够了。 Folia 部署最快的方式三条路线选一条没有服务器照样能拿到一个几分钟内上线、手机随时能打开的地址。手机要装成应用前提就是有一个稳定可达的地址选哪条路线取决于你有没有服务器。路线一一键托管Vercel / Cloudflare。适合没有服务器的你。项目带一键部署按钮HTTPS 和域名都自带几分钟上线零配置细节在 docs/technical.md。路线二Docker 全栈。适合 NAS 或自建服务器用户。编辑.env后执行docker compose up -d默认地址是NAS-IP:18080。记得.env里要填至少 8 位的SYNC_TOKEN编排文件是deploy/docker/compose.yaml部署说明见 deploy/docker/README.md。路线三克隆仓库自行部署。自由度最高环境变量和 HTTPS 全由你掌握。执行git clone https://gitcode.com/GitHub_Trending/fo/folia-major后按文档配置即可QQ 音乐的 serverless 配置可查 docs/qq-music-deployment.md。新手直接走一键托管不用管服务器、域名和证书部署完的地址手机直接能打开。 Folia 怎么装到手机主屏四步走通装到手机主屏只要四步安卓和 iPhone 流程一致用浏览器打开 Folia 的访问地址。打开浏览器菜单安卓或分享面板iPhone。选中「安装应用」或「添加到主屏幕」。确认名称显示为 Folia保存。安卓用 Chrome点页面右上角的菜单选「安装应用」或「添加到主屏幕」。iPhone 用 Safari点页面底部的分享图标上滑找到「添加到主屏幕」确认后添加。怎么确认装对了点开主屏上的图标直接以独立全屏窗口启动没有地址栏没有标签页看不到任何浏览器痕迹就是装对了。️ Folia 进阶用 Navidrome 把 NAS 上的歌搬进手机想听自己存的音乐路已经铺好歌放在 NAS 上Navidrome 扫描后以流媒体曲库对外服务手机 PWA 只负责拉曲库、封面和歌词。在 NAS 上用 Docker 部署 Navidrome挂载你的音乐目录。在 Folia 的账户页接入 Navidrome 服务。曲库与封面同步完成后直接播放缺失的歌词可以由智能匹配自动补齐歌词动画照常驱动。一个注意点Navidrome 的地址必须每台设备都够得到Folia 页面是 HTTPS 时它也得是 HTTPS否则浏览器会直接拦截混合内容。桌面端本地曲库的管理方式可以看 docs/local-library-management.md手机端则统一走 Navidrome 这条路。️ Folia 手机端问题速查五个高频坑出问题时先对号入座这五处十次里有九次能命中。菜单里找不到「添加到主屏幕」入口原因打开的是 HTTP 地址或者没用 Chrome / Safari。处理换成 HTTPS 地址一键托管自带NAS 用户配反向代理和可信证书再重载一次页面。更新后打开还是旧界面原因Service Worker 缓存更新一般下次打开生效偶尔会卡住。处理清除一次站点数据或者把主屏图标删掉重新添加。Navidrome 连上了曲库和封面却拉不下来原因填了 Docker 内部主机名手机够不到或页面是 HTTPS 而地址是 HTTP。处理改成每台设备都能访问的地址需要时对齐到 HTTPS。换 HTTPS 后登录态和设置都空了原因两个地址属于不同 origin数据不会自动迁移。处理重新登录并配置一遍上线后不要来回切换协议。手机上没有本地导入入口原因本地目录导入依赖 File System Access API只在桌面 Chromium 浏览器可用。处理手机端的「自己的歌」走 Navidrome 路线本地导入留在桌面版做。 收尾建议这样体验 Folia 手机端别急着一次把功能全跑满。先用一键托管上线接一个在线曲库把全屏歌词动画的流程完整走一遍等这套组合稳定了再接上 Navidrome把 NAS 里的歌搬进手机。按这个顺序一天之内你就能在手机上拿到完整的 Folia 体验还不占手机空间。【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考