Folia歌词代理lyric-proxy详解如何安全获取在线歌词的完整指南【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-majorFolia是一款专注于绚丽歌词动画效果的本地音乐 / Navidrome / 多平台在线音乐播放器。当你在线试听歌曲时歌词需要从 QQ音乐、酷狗等接口拉取而浏览器出于安全策略会拦截跨域请求。Folia 用一套轻量的歌词代理 lyric-proxy机制优雅地解决了这个问题Web 端经云端 Worker 转发、桌面端由 Electron 主进程直连全程受域名白名单管控实现安全又稳定的在线歌词获取。一、为什么前端需要歌词代理浏览器有一条经典防线同源策略CORS。前端页面运行在你的域名下直接请求kugou.com或u.y.qq.com的歌词接口会被浏览器以跨域为由拒之门外。Folia 的解法很直接——在请求链路上架一个中转站运行环境代理位置实现方式Web 端线上部署Cloudflare Worker/api/lyric-proxy 路由桌面端Electron主进程 Node 环境lyric-proxy-fetchIPC 通道本地开发Vite 开发服务器中间件模拟 Worker 行为前端永远只面对自己跨域问题就此消失。二、三条链路一次看懂数据流 1. Web 端Cloudflare Worker 转发入口在 worker/index.ts命中/api/lyric-proxy路径即交给handleLyricProxy处理。核心逻辑在 worker/lyric-proxy.ts前端把真实歌词接口地址编码进?url参数发给 WorkerWorker 代为请求目标域名并给响应补上Access-Control-Allow-Origin: *头OPTIONS预检请求直接返回 200让浏览器放行后续请求2. 桌面端Electron 主进程直连桌面版没有跨域限制但仍保留统一接口。渲染进程通过 electron/preload.cjs 暴露的fetchLyricProxy调用 electron/main.cjs 中的 IPC 处理器由主进程用 Node 的fetch直接访问歌词源——不绕路、零延迟。3. 开发环境Vite 中间件兜底vite.config.ts 内置了一个dev-lyric-proxy插件让本地npm run dev时的行为与线上 Worker 完全一致开发者无需额外部署即可调试歌词功能。三、安全设计域名白名单是核心锁 能转发请求不等于想转发谁就转发谁。lyric-proxy 采用严格白名单这是它安全性的基石防护点策略域名校验仅放行qq.com、kugou.com及其子域外加歌词数据源amll-ttml-db.stevexmh.net白名单外请求直接返回403 Forbidden绝不代发缺少 url 参数返回400提示参数缺失请求头过滤丢弃host、origin、referer等逐跳头部只转发业务所需头部桌面端调用方校验IPC 处理器先验证调用来源是受信任的主窗口渲染进程拒绝未知页面发起请求异常兜底转发失败返回500及错误详情不会让前端拿到半截数据这种白名单 头过滤 调用方校验的组合让代理只服务于歌词获取这一件事既防住了开放重定向类滥用也避免把浏览器身份特征泄露给第三方接口。四、前端如何使用三个歌词 Provider 各显神通前端歌词模块按音乐平台拆分 Provider它们共享同一套代理 or 直连的决策逻辑是 Electron 环境就直连否则走/api/lyric-proxy?url...。QQ音乐qqLyricProvider.ts 以 POST 方式请求musicu.fcg歌词接口酷狗kugouLyricProvider.ts 构造带签名的请求签名算法、mid、客户端时间戳拿到 Base64 内容后自动识别 KRC 加密格式并解密AMLL TTML 库amllDbProvider.ts 拉取逐字时间轴数据带 5 秒超时与 200 条内存缓存并兼容桌面端 IPC 通道此外桌面后端 deploy/docker/backend/server.mjs 也实现了同款代理逻辑供 Docker 部署场景下的 Web 前端使用保证各部署形态体验一致。五、关键要点速记 ⭐一个代理三种形态Worker / Electron 主进程 / Vite 中间件对上层 Provider 完全透明白名单是唯一入口不在名单里的域名连请求都不会发出响应原样透传状态码、响应体、内容类型全部保留只追加 CORS 头特殊处理细节AMLL 数据源的 404 会被改写为 204避免前端把无歌词误判为故障桌面端更安全主进程校验调用来源 Node 环境无跨域限制天然优于浏览器方案理解 lyric-proxy 后你会发现复杂的跨域问题往往只需要一个边界清晰的中转站就能化繁为简——这正是 Folia 歌词管线顺滑可靠的幕后功臣。【免费下载链接】folia-major专注于绚丽的歌词动画效果的本地音乐/navidrome/第三方多平台在线音乐播放器项目地址: https://gitcode.com/GitHub_Trending/fo/folia-major创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考