liuloktar/musix repository overview

mkdir -p musix-stack
cd musix-stack
mkdir -p ~/musix-media      # 入库音乐存储位置（容器内 /media）
# 保存下方 compose.yaml 与 .env 后再执行：
docker compose config -q
docker compose pull
docker compose up -d

TZ=Asia/Shanghai
PUID=1000
PGID=1000

MUSIX_IMAGE=liuloktar/musix:0.7.8
QQMUSIC_IMAGE=liuloktar/musix:qqmusic-api-0.7.8
KUGOU_IMAGE=liuloktar/musix:kugou-api-0.7.8
NETEASE_IMAGE=moefurina/ncm-api:latest

POSTGRES_PASSWORD=请替换为数据库强密码
MUSIX_SECRET=请替换为至少32位且部署后保持不变的随机字符串
# FLAC/.flc 播放兼容需要使用内置 ffmpeg 的新镜像；原始文件不会被覆盖。
MUSIX_PLAYBACK_TRANSCODE_FLAC=1
MUSIX_PLAYBACK_AAC_BITRATE=192k
MUSIX_PLAYBACK_CACHE_MAX_AGE_MS=604800000
MUSIX_PLAYBACK_CACHE_MAX_BYTES=2147483648
MUSIX_FFMPEG_TIMEOUT_MS=120000

# 新版 QQ / 微信扫码使用；两个容器共用，不写入镜像
QQMUSIC_LOGIN_SECRET=请替换为至少32位随机字符串
MUSIX_AUTH=请填写有效的Musix授权Token
MUSIX_AUTH_RPC=
MUSIX_AUTH_PROXY=

MUSIX_PLUGINS=navidrome,apple,netease,qqmusic,kugou,youtube
NAVIDROME_USERNAME=demo
NAVIDROME_PASSWORD=demo
COOKIECLOUD_PORT=8088

name: musix

services:
  postgres:
    image: postgres:17-alpine
    restart: unless-stopped
    environment:
      POSTGRES_USER: musix
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
      POSTGRES_DB: musix
    volumes:
      - ./data/postgres:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U musix -d musix"]
      interval: 10s
      timeout: 5s
      start_period: 20s
      retries: 10

  redis:
    image: redis:7-alpine
    restart: unless-stopped
    command: ["redis-server", "--appendonly", "yes"]
    volumes:
      - ./data/redis:/data

  navidrome:
    image: deluan/navidrome:latest
    restart: unless-stopped
    user: "${PUID:-1000}:${PGID:-1000}"
    ports:
      - "4533:4533"
    environment:
      ND_SCANSCHEDULE: 1h
      ND_LOGLEVEL: info
      ND_SESSIONTIMEOUT: 24h
    volumes:
      - ./data/navidrome:/data
      - ./music:/music:ro

  netease-api:
    image: ${NETEASE_IMAGE:-moefurina/ncm-api:latest}
    restart: unless-stopped
    environment:
      PORT: 3000
      CORS_ALLOW_ORIGIN: "*"
      ENABLE_PROXY: "false"
      ENABLE_GENERAL_UNBLOCK: "false"
      ENABLE_FLAC: "false"

  qqmusic-api:
    image: ${QQMUSIC_IMAGE:-liuloktar/musix:qqmusic-api-0.7.8}
    restart: unless-stopped
    environment:
      PORT: 3300
      NODE_ENV: production
      QQMUSIC_LOGIN_SECRET: ${QQMUSIC_LOGIN_SECRET:-}

  kugou-api:
    image: ${KUGOU_IMAGE:-liuloktar/musix:kugou-api-0.7.8}
    restart: unless-stopped
    environment:
      PORT: 3400
      NODE_ENV: production

  cookiecloud:
    image: easychen/cookiecloud:latest
    restart: unless-stopped
    ports:
      - "${COOKIECLOUD_PORT:-8088}:8088"
    volumes:
      - ./data/cookiecloud:/data/api/data

  musix:
    image: ${MUSIX_IMAGE:-liuloktar/musix:0.7.8}
    restart: unless-stopped
    ports:
      - "8080:8080"
    environment:
      TZ: ${TZ:-Asia/Shanghai}
      PORT: 8080
      NODE_ENV: production
      DATABASE_URL: postgresql://musix:${POSTGRES_PASSWORD}@postgres:5432/musix?schema=public
      REDIS_URL: redis://redis:6379
      MUSIX_SECRET: ${MUSIX_SECRET}
      MUSIX_AUTH: ${MUSIX_AUTH}
      MUSIX_AUTH_RPC: ${MUSIX_AUTH_RPC:-}
      MUSIX_AUTH_PROXY: ${MUSIX_AUTH_PROXY:-}
      MUSIX_PLUGINS: ${MUSIX_PLUGINS:-navidrome,apple,netease,qqmusic,kugou,youtube}
      MUSIX_LOG_LEVEL: info
      MUSIX_PLAYBACK_TRANSCODE_FLAC: ${MUSIX_PLAYBACK_TRANSCODE_FLAC:-1}
      MUSIX_PLAYBACK_AAC_BITRATE: ${MUSIX_PLAYBACK_AAC_BITRATE:-192k}
      MUSIX_PLAYBACK_CACHE_MAX_AGE_MS: ${MUSIX_PLAYBACK_CACHE_MAX_AGE_MS:-604800000}
      MUSIX_PLAYBACK_CACHE_MAX_BYTES: ${MUSIX_PLAYBACK_CACHE_MAX_BYTES:-2147483648}
      MUSIX_FFMPEG_TIMEOUT_MS: ${MUSIX_FFMPEG_TIMEOUT_MS:-120000}
      MUSIX_FFMPEG_PATH: ${MUSIX_FFMPEG_PATH:-/usr/bin/ffmpeg}
      MUSIX_DATA_DIR: /app/data
      NAVIDROME_URL: http://navidrome:4533
      NAVIDROME_USERNAME: ${NAVIDROME_USERNAME:-demo}
      NAVIDROME_PASSWORD: ${NAVIDROME_PASSWORD:-demo}
      NETEASE_API_URL: http://netease-api:3000
      NETEASE_CHART_ID: 19723756
      QQMUSIC_API_URL: http://qqmusic-api:3300
      QQMUSIC_CHART_ID: 4
      QQMUSIC_LOGIN_SECRET: ${QQMUSIC_LOGIN_SECRET:-}
      KUGOU_API_URL: http://kugou-api:3400
      KUGOU_CHART_ID: 8888
      YTDLP_API_URL: http://127.0.0.1:3500
      YTDLP_EMBEDDED: 1
      YTDLP_JS_RUNTIME: node
      YTDLP_COOKIES_FILE: /app/data/youtube-cookies.txt
      COOKIECLOUD_URL: http://cookiecloud:8088
      APPLE_CONFIG_DIR: /app/data/apple
      P8_PATH: /app/p8
      MUSIX_LIBRARY_DIR: /media
    volumes:
      - ./data/musix:/app/data
      - ./data/musix/apple:/app/p8
      - ~/musix-media:/media
    depends_on:
      postgres:
        condition: service_healthy
      redis:
        condition: service_started
      navidrome:
        condition: service_started
      netease-api:
        condition: service_started
      qqmusic-api:
        condition: service_started
      kugou-api:
        condition: service_started
      cookiecloud:
        condition: service_started

# .env：把三个 tag 一起改成 0.7.8（或其它固定版本）
docker compose config -q
docker compose pull
docker compose up -d --no-deps musix qqmusic-api kugou-api
docker compose ps
docker compose logs --tail=200 musix