Folia 手机安装完整指南：15 分钟把全屏歌词动画播放器装进主屏幕-育师

Folia 手机安装完整指南：15 分钟把全屏歌词动画播放器装进主屏幕

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

你在电脑上天天看的全屏歌词动画，手机上却找不到入口。Folia 是一款支持网易云、酷狗、QQ 音乐等在线音源，也能接 NAS（网络附属存储，局域网里的存储设备）自建曲库的全屏歌词动画播放器。本文面向零基础新手：任选一条路部署 Web 版，再把它以 PWA（Progressive Web App，可像应用一样“安装”进手机、独立全屏打开的网页）的形式加到主屏幕，全程约 15 分钟。装完手机多一个独立图标，点进去直接全屏，没有地址栏。

✅ 能力核对：能做什么不能做什么

✅在线搜索与串流：部署好 Web 版后，手机上直接搜网易云、酷狗、QQ 音乐并播放
✅装成独立应用：Web 版本就内置 PWA 机制，全屏窗口模式与自动更新策略在 vite.config.ts 里配置好了，手机端什么都不用改
✅弱网也能开界面：Service Worker（浏览器里的缓存小插件，把核心文件留一份在本地）在首次正常加载后预缓存主页面
✅听自己的曲库：播放器原生支持接 Navidrome（把 NAS 上的音乐文件夹发布成在线曲库的开源媒体服务器）
❌手机导入本地音频：做不了，手机浏览器不提供 File System Access API（浏览器里的目录选择能力），这是桌面端专属
❌把手机当曲库源：做不了，音频文件必须能在网络上访问到，手机只当纯播放终端

🧭 选一条路：三种安装方式任选其一

不想碰服务器，选 Vercel 或 Cloudflare 一键部署：按提示接入仓库，约 5 分钟拿到带域名的地址，入口是仓库 README 顶部的一键部署按钮
家里有 NAS，选 Docker（把服务打包成镜像、一条命令启动的容器工具）Compose（Docker 里用一份配置文件拉起多个服务的功能）全栈：仓库自带 Compose 文件与环境变量模板，拉取镜像后执行docker compose up -d启动，首次部署约 10 分钟（大头是下载镜像），默认访问地址 http://NAS-IP:18080，细节见 deploy/docker/README.md
想完全自己掌控，选源码部署：git clone https://gitcode.com/GitHub_Trending/fo/folia-major，Web 版要求 Node.js（运行 JavaScript 的环境）24 或更高，照 docs/technical.md 的环境变量表填好网易云 API 地址、AI 服务商密钥等，约 20 分钟

⚠️ HTTPS（地址栏带小锁的加密连接）是 PWA 可靠安装与离线使用的前提；免费托管默认就有，NAS 自建要配好反向代理（把外部请求转发给内部服务并处理加密的中转）与可信证书。

📲 安装并验证：三步装进主屏幕

用手机浏览器（安卓用 Chrome，iPhone 用 Safari）打开部署好的地址，等主界面出现（约 30 秒）。看到顶部出现 Folia 首页、带搜索框和分类标签，即成功
找安装入口：安卓在右上角菜单 ⋮，iPhone 在底部分享按钮，选「添加到主屏幕」（安卓可能显示为「安装应用」），确认名称是 Folia（约 1 分钟）。看到手机主屏幕多出一个 Folia 图标，即成功
点一下这个新图标，确认它直接打开全屏独立窗口（约 30 秒）。看到画面整个是播放器界面、没有地址栏和标签页，即成功

自查三条：

图标名称：图标文字显示 Folia，而不是「添加到主屏幕」或一串数字
窗口模式：打开后直接全屏、无地址栏（窗口模式是 standalone，独立窗口，构建时已配好）
缓存生效：首次正常加载后开一次飞行模式重新打开，主界面仍能加载（此时播不了歌属正常）

🎧 装完先用起来：登录与换主题

登录音源（约 1 分钟）：打开账户页，登录网易云、酷狗、QQ 音乐任一个，登录态存在手机浏览器里，下次打开不必重登。接通网易云后首页长这样：

切一个主题（约 30 秒）：歌词动画有 Fume、Lumi、Cappella 等多种风格，排版氛围各不相同，设置页的主题速编入口点一下就能换；部署时填过 AI 密钥（让 AI 服务商读取歌曲并生成配色的凭证）的话，背景配色会按歌曲情绪自动生成
放一首试试（约 1 分钟）：搜一首歌点开，播放开始后歌词铺满整块屏幕，不同动画风格节奏感不一样，可以挑一个顺眼的固定下来

📂 进阶玩法：接上自己的 Navidrome 曲库

在 NAS 上用 Docker 装一个 Navidrome，把它的目录指向存放音乐文件的位置（约 5 分钟）
在 Folia 账户页填上服务器地址与账号（约 1 分钟）；如果你的 Folia 就是 Docker 栈部署的，在 .env（环境变量配置文件）里补上NAVIDROME_*三项即可开启「预置账号」，新打开的浏览器不用填写、自动登录
接通后曲库、封面、歌词从 NAS 拉取，播放走纯串流（播放器通过网络按小块请求音频数据，不在本地存文件），不占手机存储

🛠️ 排障速查表：四个常见问题与一步动作

现象	最可能原因	一步动作
手机上找不到安装入口	地址不是 HTTPS，或浏览器不是 Chrome / Safari	换 Chrome（安卓）或 Safari（iPhone）打开带小锁的地址，重新加载
打开后还是旧界面	Service Worker 里存着旧版本缓存	清一次站点数据；正常情况下次打开会自动更新
找不到导入本地文件的入口	File System Access API 只在桌面浏览器提供	自己的曲库走 Navidrome 路线，手机只负责播放
界面能开但歌放不出来	音频流依赖网络，弱网时中断	切到 Wi-Fi 重试