4 步把 Folia 装进手机：PWA 手机安装完整指南

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

Folia 是一款把整块屏幕交给歌词动画的音乐播放器，能接网易云、QQ 音乐、酷狗、Navidrome 和本地曲库。它没有官方手机 App，但 Web 版原生支持 PWA（浏览器能「安装」成应用的网页），装进手机主屏幕只要几分钟。

先看效果：手机上能体验什么

结论先行：手机上就是「全屏歌词动画 + 在线搜索播放」，竖屏拿手机时布局会自动重排一遍，动画不打折。

• 多种歌词动画风格各有一套排版和可调参数，窗口尺寸变化时响应式重排
• 主题速编入口里随手换风格，比如「流光」：深色底叠加流动光效，OLED 屏手机上尤其好看
• 主题配色还能由 AI 按歌曲情绪与歌词内容自动生成（前提是部署时配置了 AI 密钥）

一条边界线：你的手机能不能用

只有一条边界：从本地文件夹导入音频文件，手机上做不了；其余全部可用。

三条地址路线怎么选

PWA 本质还是网页，前提是你有一个稳定、带 HTTPS（带加密证书的安全网址，浏览器判定「可信」的依据）的地址。三条路线对号入座：

具体做法：

1. 一键部署：走 Vercel 或 Cloudflare 的一键部署入口，全程不用自己的服务器。QQ 音乐相关的环境变量配置见 QQ 音乐部署指南。
2. Docker 全栈：新建一个空目录，放入 compose.yaml 与环境变量模板，编辑.env填入SYNC_TOKEN（至少八位的随机字符串）等配置，执行docker compose up -d启动，默认访问地址是http://NAS-IP:18080。完整步骤见 Docker 部署文档。
3. 自行部署：git clone https://gitcode.com/GitHub_Trending/fo/folia-major，再照 技术文档 里的环境变量说明部署到任意支持 Node.js 的平台。

⚠️ HTTPS 是 PWA 可靠安装与离线运行的前提。免费托管平台自带证书最省心；NAS 自部署请务必配好反向代理与可信证书，否则手机上可能找不到安装入口。

四步装进手机主屏幕

地址到手后，用手机浏览器打开它，然后四步完成。

安卓（Chrome）

1. 用 Chrome 打开 Folia 网页
2. 点右上角菜单（⋮）
3. 选**「添加到主屏幕」或「安装应用」**
4. 确认名称显示为 Folia，点**「添加」**

iPhone / iPad（Safari）

1. 用 Safari 打开 Folia 网页
2. 点底部分享按钮（⬆️）
3. 上滑找到**「添加到主屏幕」**并点击
4. 确认名称，点**「添加」**

装完你会得到什么：一个独立图标，点它直接以全屏独立窗口启动——没有地址栏、没有标签页。这种接近原生的观感在源码里可以逐条对到：vite.config.ts 中的 PWA manifest（声明图标、窗口模式等启动行为的应用信息清单）设置了standalone独立窗口模式、#09090b主题色与 512×512 图标；index.html 内置了apple-mobile-web-app-capable等 iOS 全屏元标签。核心界面资源在首次加载后被 Service Worker（浏览器里拦截请求、缓存文件的小程序）预缓存，弱网也启得快；autoUpdate自动更新策略生效，服务端发新版后下次打开就是最新版。

接上 Navidrome：播自己的曲库

手机不能直接导入音频文件，Navidrome（跑在 NAS 上的自建曲库服务）恰好补上这一环，三步接完：

1. 在 NAS 上用 Docker 部署 Navidrome，挂载你的音乐目录
2. 在 Folia 的账户页中接入 Navidrome 服务
3. Folia 拉取曲库、封面与歌词，歌词动画照常驱动；缺失歌词可凭智能匹配自动补齐

好处很直接：音频文件留在 NAS，手机只通过 PWA 远程播放，不占手机存储。本地曲库的管理细节可参考 本地曲库管理文档（该文档主要面向桌面端导入流程）。

卡住了？对照自查

• 备一个稳定的 HTTPS 地址，四步把图标装进手机主屏幕。
• 在线搜索、全屏歌词动画、Navidrome 曲库在手机上全部可用，本地文件导入是唯一边界。
• 出问题先对照上面四行自查表，多数情况一步就能解决。

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