{"repo":"joeseesun/qiaomu-music-player-web","free":true,"listed":false,"github":"https://github.com/joeseesun/qiaomu-music-player-web","clone":"git clone https://github.com/joeseesun/qiaomu-music-player-web.git","description":"自托管 AI 音乐电台、公开播放 API 和 SwiftUI iOS 客户端 | Self-hosted AI music radio with public playback API and SwiftUI iOS app.","language":"TypeScript","stars":11,"topics":["ai-music","ios","music-player","public-api","react","self-hosted","swiftui","vite","web-component"],"license":"MIT","category":"mobile-apps","readme_excerpt":"Qiaomu Music Player Web 给 AI 生成音乐一个可自托管的电台前台和后台曲库。 A self-hosted web radio and admin shelf for AI-generated music. Live Demo · iOS App · Public API · License 中文 English --- 中文 你用 Suno、Udio 或其他 AI 音乐工具生成了一堆歌，最后常常散落在下载目录、聊天记录和临时脚本里。 Qiaomu Music Player Web 把它们放进一个可以自托管的网页电台：前台负责播放、队列、歌词和视觉动效，后台负责上传、编辑、试听、发布和下架。 如果你只想听歌，也可以用仓库里的 SwiftUI iPhone 客户端读取公开播放 API，像 Apple Music 一样浏览、搜索和播放自己的 AI 歌曲库。 核心功能 - 电台前台：播放队列、封面、歌词滚动、主题配色和声纹动效。 - 后台曲库：上传音频、封面、歌词和元数据。 - iOS 客户端：SwiftUI、AVPlayer、锁屏控制、后台播放、歌词点按跳转。 - 公开播放 API：已发布歌曲可被其他网站、移动客户端和嵌入组件读取。 - 草稿试听：后台未发布歌曲也可以试听，不影响前台电台。 - 发布控制：一键发布或取消发布，并给出明确反馈。 - 本地存储：音频在 data/music ，封面在 data/covers ，元数据在 data/tracks.json 。 - 自托管友好：Node 服务、Docker Compose 和静态前端构建都在仓库里。 快速开始 前置条件： - [ ] 安装 Node.js 20 或更高版本： node --version - [ ] 安装 npm： npm --version - [ ] 准备一个后台密码，设置为 ADMIN PASSWORD 本地运行： 开发模式： 打开 http://127.0.0.1:5173 。点击设置里的后台入口，用你设置的 ADMIN PASSWORD 登录。 Docker 部署 默认服务监听 127.0.0.1:3068 。如果你要公开到互联网，建议放在 Caddy、Nginx 或 Cloudflare Tunnel 后面，并启用 HTTPS。 环境变量 复制 .env.example 作为本地参考，但不要提交真实 .env 。 变量 必填 说明 --- --- --- ADMIN PASSWORD 是 后台登录密码，也用于 legacy upload token。 SESSION SECRET 否 Cookie 签名密钥。生产环境建议显式设置。 PORT 否 HTTP 端口，默认 3068 。 DATA DIR 否 数据目录，默认 ./data 。 MAX UPLOAD BYTES 否 最大上传体积，默认 120MB 。 截图更新 README 截图使用模拟曲库生成，不会读取你的真实歌曲数据。 输出文件在 docs/assets/product-screenshot.png 。 数据和隐私 公开仓库不会包含上传的歌曲、封面、真实曲库、 .env 、 suno-jobs/ 或 cover-redesigns/ 生成任务目录。 默认 .gitignore 已排除： - data/music/ - data/covers/ - data/tracks.json - .env 和 .env. - suno-jobs/ - cover-redesigns/ Legacy","default_branch":null,"files":null,"tree":[],"storefront":"/r/joeseesun","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/joeseesun/qiaomu-music-player-web/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}