HYW & Koneko 音源管理后台
多平台音源聚合服务
支持 LX Music、澜音、QZ Music 格式
📖 项目简介
HYW & Koneko 音源管理后台是一个功能强大的多平台音源聚合服务，支持多种音源格式，提供完善的音源管理、卡密系统、频率限制、主题定制等功能。
🎯 核心特性
- 多格式支持：支持 LX Music、澜音、QZ Music 三种主流音源格式
- 多平台覆盖：支持酷我、酷狗、QQ音乐、网易云、咪咕五大音乐平台
- 多音质选择：从 128kbps 到 Master 臻品音质，满足不同需求
- 智能调度：5种调度策略，自动选择最优音源
- 主题系统：8种预设主题 + 自定义主题编辑器
- 卡密系统：完善的卡密生成、验证、统计功能
- 频率限制：全局 QPS、单 IP 限制、自动封禁
- 鉴权系统：支持本地登录和第三方认证（预留）
👥 开发团队
合作开发
MistAperio Studio × Macrohard Studio
编写人
- 雾启工作室@云汀 (Cloudwhisper / Miao-moe)
- Macrohard Studio@Ryn磷熠 (Macrohard0001)
致谢
旧版后台由 Macrohard Studio 开发，编写人 @Macrohard0001
🚀 快速开始
环境要求
- Node.js >= 18.0.0
- npm >= 9.0.0 或 pnpm >= 8.0.0
安装依赖
npm install
# 或
pnpm install
配置环境变量
cp .env.example .env
# 编辑 .env 文件配置你的环境变量
初始化数据库
npm run db:push
# 或
npm run db:migrate
启动开发服务器
npm run dev
访问 http://localhost:3000 查看效果。
📁 项目结构
hyw-koneko-source-admin/
├── prisma/ # 数据库模型
│ └── schema.prisma
├── public/ # 静态资源
├── src/
│ ├── app/ # Next.js App Router
│ │ ├── api/ # API 路由
│ │ ├── login/ # 登录页面
│ │ ├── sources/ # 音源管理
│ │ ├── settings/ # 系统设置
│ │ ├── card-keys/ # 卡密管理
│ │ ├── ip-rules/ # IP 规则
│ │ ├── logs/ # 日志查询
│ │ ├── theme/ # 主题设置
│ │ └── ...
│ ├── components/ # React 组件
│ ├── hooks/ # 自定义 Hooks
│ ├── lib/ # 核心库
│ │ ├── auth/ # 鉴权模块
│ │ ├── music/ # 音乐业务模块
│ │ └── theme/ # 主题系统
│ └── types/ # 类型定义
├── package.json
├── tsconfig.json
└── next.config.ts
🎨 主题系统
预设主题
| 主题 | 描述 |
|---|---|
| 默认主题 | Ant Design 经典蓝色主题 |
| 深色模式 | 护眼深色主题 |
| 二次元 | 可爱的粉色调主题 |
| 福瑞 | 温暖的橙棕色调主题 |
| 樱花 | 浪漫的樱花粉色主题 |
| 海洋 | 清新的海洋蓝色主题 |
| 森林 | 自然的森林绿色主题 |
| 午夜 | 深邃的紫色调深色主题 |
自定义主题
支持通过主题编辑器自定义：
- 主题色、背景色、文字色、边框色
- 圆角大小
- 背景图片（支持模糊、透明度）
- 自定义 CSS
📡 API 文档
获取音乐 URL
GET /api/music/url?platform=kw&songId=123456&quality=320k
批量获取
POST /api/music/url
Content-Type: application/json
{
"items": [
{ "platform": "kw", "songId": "123", "quality": "320k" },
{ "platform": "tx", "songId": "456", "quality": "flac" }
]
}
音源管理
GET /api/music/source # 获取音源列表
POST /api/music/source # 上传音源
PUT /api/music/source # 更新音源
DELETE /api/music/source # 删除音源
🔐 鉴权系统
支持的认证方式
- 本地登录：用户名/邮箱 + 密码
- 第三方认证：auth.shiqianjiang.cn（预留）
权限等级
| 角色 | 权限 |
|---|---|
| user | 基础音质访问 |
| vip | 全部音质访问 |
| admin | 完全控制权限 |
📊 支持的平台与音质
平台
| 代码 | 平台 | ID 字段 |
|---|---|---|
| kw | 酷我音乐 | songId / rid |
| kg | 酷狗音乐 | hash |
| tx | QQ音乐 | songmid / strMediaMid |
| wy | 网易云音乐 | songId |
| mg | 咪咕音乐 | copyrightId |
音质
| 代码 | 名称 |
|---|---|
| 128k | 128kbps |
| 320k | 320kbps |
| flac | FLAC 无损 |
| flac24bit | FLAC 24bit |
| hires | Hi-Res |
| dolby | Dolby Atmos |
| atmos_plus | Dolby Atmos Plus |
| master | Master 臻品 |
📝 开发命令
# 开发
npm run dev
# 构建
npm run build
# 启动生产服务器
npm run start
# 数据库操作
npm run db:generate # 生成 Prisma Client
npm run db:push # 推送数据库结构
npm run db:migrate # 创建迁移
npm run db:studio # 打开 Prisma Studio
# 代码检查
npm run lint
📄 许可证
ISC License
🙏 致谢
Made with ❤️ by MistAperio Studio × Macrohard Studio