Alisten

一个音乐播放和房间管理系统，支持从 Bilibili、网易云音乐、QQ音乐等平台获取音乐。

Config

put config.json in the root directory of your project.

{
    "addr": ":80",
    "token": "your-auth-token-here",
    "music": {
        "netease": "...",
        "cookie": "...",
        "qq": "..."
    },
    "debug": true,
    "pgsql": "...",
    "persist": [
        {
            "id": "room1",
            "name": "音乐房间1",
            "desc": "这是一个持久化的音乐房间",
            "password": "123456"
        },
        {
            "id": "room2", 
            "name": "音乐房间2",
            "desc": "另一个持久化房间",
            "password": ""
        }
    ]
}

配置说明

• addr: 服务器监听地址
• token: 认证令牌
• music.netease: 网易云音乐 API 地址
• music.cookie: 音乐平台 Cookie
• music.qq: QQ音乐 API 地址
• debug: 调试模式开关
• pgsql: PostgreSQL 数据库连接字符串
• persist: 持久化房间配置数组
  • id: 房间唯一标识符
  • name: 房间显示名称
  • desc: 房间描述
  • password: 房间密码（可选，为空表示无密码）

Musiclet Config

Musiclet 是一个独立的音乐服务客户端，需要单独的配置文件。请在项目根目录创建 musiclet-config.json 文件：

{
    "server_url": "https://your-server-url",
    "token": "your-token",
    "qiniu_ak": "your-qiniu-access-key",
    "qiniu_sk": "your-qiniu-secret-key"
}

Musiclet 配置说明

• server_url: 主服务器地址
• token: 认证令牌
• qiniu_ak: 七牛云 Access Key（可选）
• qiniu_sk: 七牛云 Secret Key（可选）

Features

• 🎵 支持多平台音乐源（Bilibili、网易云音乐、QQ音乐）
• 🏠 房间管理系统，支持持久化房间配置
• 🎶 HTTP API 点歌功能，支持通过 REST API 进行点歌

API 接口

点歌接口

POST /music/pick

通过 HTTP POST 请求为指定房间点歌。

请求体:

{
    "houseId": "房间ID",
    "password": "房间密码",
    "id": "音乐ID（可选）",
    "name": "音乐名称",
    "source": "音乐源（wy/qq/db）"
}

请求参数说明:

• houseId: 要点歌的房间ID
• password: 房间密码
• id: 音乐的唯一标识符（可选，如果未提供则会根据name和source搜索）
• name: 音乐名称或搜索关键词
• source: 音乐平台来源
  • wy 或 netease: 网易云音乐
  • qq: QQ音乐
  • db: Bilibili（支持 BV 号）

响应示例:

成功时:

{
    "name": "音乐名称",
    "source": "wy",
    "id": "音乐ID"
}

错误时:

{
    "error": "错误信息"
}

Build and run

go build && ./alisten

部署指南

详细的部署说明请参考 部署指南，包含：

• Docker/Podman 容器化部署
• 完整的配置文件说明
• 生产环境建议
• 故障排除指南

Docker 快速启动

使用 Docker Compose 一键启动所有服务：

# 克隆项目
git clone https://github.com/bihua-university/alisten.git
cd alisten

# 准备配置文件
cp config.json.example config.json
cp musiclet-config.json.example musiclet-config.json

# 启动服务
docker compose up -d