banksiae/alger-music-player

alger-music-player

基于AlgerMusicPlayer的Docker镜像。

使用方法

基础运行（官方url，非会员的，可能会出现部分音乐无法正常播放的情况）

bash
# 运行容器（需要映射8080端口）
docker run -d -p 8080:8080 banksiae/alger-music-player:latest

# 如果本地8080端口被占用，可以映射到其他端口（如8081）
docker run -d -p 8081:8080 banksiae/alger-music-player:latest

配置外部音乐API（推荐）

基础配置 - 使用默认响应路径 data.url

bash
docker run -d -p 8080:8080 \
  -e MUSIC_API_URL="https://your-music-api.com/api/getMusicUrl?level=high" \
  banksiae/alger-music-player:latest

高级配置 - 自定义响应路径

bash
# 嵌套响应格式
docker run -d -p 8080:8080 \
  -e MUSIC_API_URL="https://music-api.example.com/get?format=json&quality=320k" \
  -e MUSIC_RESPONSE_PATH="data.data.url" \
  banksiae/alger-music-player:latest

# 自定义字段名
docker run -d -p 8080:8080 \
  -e MUSIC_API_URL="https://api.example.com/music" \
  -e MUSIC_RESPONSE_PATH="result.url" \
  banksiae/alger-music-player:latest

# 数组格式
docker run -d -p 8080:8080 \
  -e MUSIC_API_URL="https://api.example.com/music" \
  -e MUSIC_RESPONSE_PATH="songs[0].url" \
  banksiae/alger-music-player:latest

实际使用示例

bash
# 网易云API示例
docker run -d -p 8080:8080 \
  -e MUSIC_API_URL="https://your-netease-api.com/?level=exhigh" \
  banksiae/alger-music-player:latest

# 高级API示例
docker run -d -p 8080:8080 \
  -e MUSIC_API_URL="https://api.example.com/music?quality=high" \
  -e MUSIC_RESPONSE_PATH="result.data.url" \
  banksiae/alger-music-player:latest

访问方式

• 前端应用：http://localhost:8080
• 后端API：http://localhost:8080/api/ (内部netease-cloud-music-api，通过nginx代理)
• 音乐API：http://localhost:8080/api_music/ (外部音乐API，通过nginx代理)

环境变量配置

API接口要求：

• MUSIC_API_URL 应该是完整的API地址，包含所有必要的参数
• 系统会自动从原始请求中提取 id 参数并追加到配置的URL后面
• 例如：访问 /api_music/music?id=1374527538 会转发到 MUSIC_API_URL&id=1374527538
• 系统会根据 MUSIC_RESPONSE_PATH 从API响应中提取音乐URL，并标准化为 {"code":200,"msg":"success","data":{"url":"music_url"}} 格式，因源码仅支持通过此结构获取 JSON 中的 URL：res?.data?.data?.url || null
• 支持任意嵌套的JSON路径，如 data.data.url、result.url、songs[0].url 等
• 建议使用支持CORS的音乐API服务

响应路径配置示例：

bash
# 示例1：标准响应格式 {"data":{"url":"music_url"}}
MUSIC_RESPONSE_PATH="data.url"

# 示例2：嵌套响应格式 {"data":{"data":{"url":"music_url"}}}
MUSIC_RESPONSE_PATH="data.data.url"

# 示例3：不同字段名 {"result":{"url":"music_url"}}
MUSIC_RESPONSE_PATH="result.url"

# 示例4：数组中的URL {"songs":[{"url":"music_url"}]}
MUSIC_RESPONSE_PATH="songs[0].url"

常见API格式适配示例

格式1：标准格式

json
{"data":{"url":"https://music.example.com/song.mp3"}}

配置：MUSIC_RESPONSE_PATH="data.url"

格式2：嵌套格式

json
{"data":{"data":{"url":"https://music.example.com/song.mp3"}}}

配置：MUSIC_RESPONSE_PATH="data.data.url"

格式3：自定义字段

json
{"result":{"url":"https://music.example.com/song.mp3"}}

配置：MUSIC_RESPONSE_PATH="result.url"

格式4：数组格式

json
{"songs":[{"url":"https://music.example.com/song.mp3"}]}

配置：MUSIC_RESPONSE_PATH="songs[0].url"

端口说明

• 容器暴露端口：8080
• 前端服务：nginx在8080端口提供静态文件服务
• 后端API：内部3000端口，通过nginx代理到/api/路径
• 音乐API：通过nginx代理到/api_music/路径，转发到MUSIC_API_URL

源码

基于 https://github.com/algerkong/AlgerMusicPlayer 构建