all-in-aigc/melodisco · 上手攻略

  • 仓库：all-in-aigc/melodisco
  • 链接：https://github.com/all-in-aigc/melodisco
  • 分类：academic-writing
  • 作者：Tom
  • 更新：2026-08-27

是什么

Melodisco 是一款开源的 AI 音乐播放器，由独立开发者 idoubi 构建，所属组织 all-in-aigc。与传统音乐播放器不同，Melodisco 的核心能力是探索和播放 AI 生成的音轨，并提供音乐生成功能（通过 Suno 合作/集成），帮助用户在 AI 音乐快速崛起的大背景下发现和体验 AI 生成的音乐内容。

该项目托管于 GitHub（Stars 514，周增 0），配套在线平台 melodis.co，支持自托管部署。

技术栈： Next.js（App Router）+ TypeScript + Tailwind CSS + Shadcn/ui + NextAuth + Stripe + node-postgres + PostgreSQL。

解决什么问题

AI 音乐生成在 2025-2026 年快速爆发（Suno、Udio 等平台崛起），但普通用户缺少一个统一的 AI 音乐发现和播放工具：

  1. 发现门槛高：AI 生成的音乐散布在不同平台，缺乏聚合播放器。
  2. 体验不统一：无法在一个界面内浏览、搜索、播放 AI 音乐，缺乏歌单管理。
  3. 版权灰度：AI 音乐的版权状态尚不清晰，商业使用存在风险，Melodisco 的探索属性让用户先体验再决定。
  4. 二次创作灵感：音乐制作人、创作者可以借助播放器发现 AI 生成的不同风格，作为创作参考。

快速安装

前提

  • Node.js 18+
  • pnpm（推荐）或 npm
  • PostgreSQL（本地或云端，如 Supabase、Vercel Postgres）

步骤

# 1. 克隆仓库
git clone https://github.com/all-in-aigc/melodisco
cd melodisco

# 2. 安装依赖
pnpm install

# 3. 初始化数据库
# 创建 PostgreSQL 数据库（本地或 Supabase/Vercel Postgres）
# 从 data/install.sql 导入表结构
psql -U postgres -d melodisco -f data/install.sql

# 4. 配置环境变量，创建 .env.local
SENSITIVE_KEYWORDS=xxx,xxx,xxx
POSTGRES_URL=postgres://USERNAME:PASSWORD@HOST:PORT/melodisco
STRIPE_PUBLIC_KEY=pk_test_xxx
STRIPE_PRIVATE_KEY=sk_test_xxx
NEXT_PUBLIC_SHARE_BASE_URL=http://localhost:8023
NEXT_PUBLIC_GOOGLE_CLIENT_ID=xxx.apps.googleusercontent.com
GOOGLE_CLIENT_SECRET=GOCSPX-xxx
NEXTAUTH_URL=http://localhost:8023
NEXTAUTH_SECRET=xxx
NEXT_PUBLIC_WEB_BASE_URL=http://localhost:8023

# 5. 启动开发服务器
pnpm dev --port 8023
# 访问 http://localhost:8023

Docker 方式

# 构建镜像
sudo docker build -f deploy/Dockerfile -t melodisco:latest .

# 运行容器
sudo docker run -itd -p 127.0.0.1:8023:8080 --restart=always melodisco:latest

配合 Nginx 反向代理（示例配置见仓库 README）：

server {
    listen 80;
    location / {
        proxy_pass http://127.0.0.1:8023/;
        proxy_set_header Host $http_host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

Vercel 一键部署

仓库 README 提供 Vercel 克隆按钮，会引导填写必要的环境变量（POSTGRES_URL、STRIPE_*、GOOGLE_CLIENT_*、NEXTAUTH_* 等）。

核心用法

1. 探索 AI 生成音乐

启动后在 Web UI 中浏览 AI 音乐库，包含以下功能： - 列表视图：展示 AI 生成的音乐曲目，支持播放控制 - 详情页：查看曲目信息（风格、生成时间等） - 深色/浅色主题：界面右上角切换

2. 音乐生成（部分功能依赖外部 AI 音乐 API）

Melodisco 内置音乐生成能力，可通过 AI 生成不同风格的音乐片段（具体生成能力版本可能有差异，建议参考在线版 melodis.co 的实际功能）。

3. 用户系统与歌单

  • Google OAuth 登录（NextAuth）
  • 创建个人歌单、管理喜欢的曲目
  • 分享功能

4. 支付功能（Stripe）

可选付费功能（推测为高级音色、解锁更多生成次数等），Stripe 集成完整。

5. 多语言支持

内置 next-intl 支持多语言切换，适合国际化部署。

典型适用场景

场景 说明
AI 音乐发现与体验 集中体验来自不同 AI 生成平台的音乐，无需逐一注册
创作灵感收集 制作人探索 AI 生成的不同风格，为创作提供参考
个人音乐库管理 将喜欢的 AI 音轨整理成歌单
自托管 AI 音乐平台 不想用第三方服务，在自有服务器上运行完整音乐体验
AI 音乐生态研究 追踪 AI 音乐生成平台的能力演变

坑与注意

⚠️ Stars 514、周增 0，活跃度偏弱：仓库更新频率较低（末次 commit 约 2025 年中），项目可能处于维护状态，新功能跟进较慢。

⚠️ 自托管需要多个付费服务：PostgreSQL（云端如 Supabase 有免费额度，但生产环境需付费）、Stripe 账号（需商户资质）、Google OAuth（需 GCP 项目），全自托管有一定配置门槛。

⚠️ 音乐来源不明确：仓库 README 未明确说明 AI 音乐的来源（Suno API？自建模型？），实际可用性需自行验证。

⚠️ 生产环境数据库性能：PostgreSQL 单表音乐记录量大时需注意索引优化，install.sql 表结构未在 README 中展示，建议部署前检查 schema。

⚠️ Stripe 集成需要真实商户：测试模式 key 可以跑通支付测试，但支付功能在个人项目中使用需注意 Stripe 的使用条款。

⚠️ 前端依赖较多：Next.js + Shadcn/ui + NextAuth + Stripe + next-intl 组合完整但升级维护成本较高，遇到依赖冲突时建议用 pnpm 锁定版本。

⚠️ Vercel 部署需要企业资质：Vercel + Stripe 组合在某些地区/场景下有合规要求。

与同类对比

工具 类型 特点 适合谁
Melodisco 开源 Web 应用 AI 音乐播放 + 生成、自托管、Next.js 想自托管 AI 音乐体验的开发者
Suno 商业 SaaS 顶尖 AI 音乐生成、网页播放器 普通用户直接生成和听音乐
Udio 商业 SaaS AI 音乐生成、社交功能 音乐爱好者与创作者
Sora.fm / Sorafm 开源 AI 视频/音乐探索，类似定位 AI 内容发现
gpts-works（all-in-aigc） 开源 第三方 GPTs Store AI 应用发现（非音乐）

Melodisco 在同类中最大优势是开源 + 自托管；但相比 Suno/Udio 这些 AI 音乐生成平台，自身并不生成音乐（部分依赖集成），更接近"AI 音乐发现播放器"而非"AI 音乐生成器"。

一句话推荐结论

想自托管一个 AI 音乐发现和播放平台，或者作为独立开发者参考 all-in-aigc 组织的 AI 应用开发范式（Next.js 全栈 + 多服务集成），Melodisco 是值得研究的开源样本；如只需直接使用 AI 音乐生成，优先选择 Suno/Udio 等成熟平台。