ss -ltn | grep ':8140' || echo "PORT FREE"
# PORT FREE                      ← 无输出即未占用

mkdir -p /opt/meelo/config /opt/meelo/data
cd /opt/meelo

cd /opt/meelo
V=v3.13.1
BASE=https://raw.githubusercontent.com/Arthi-chaud/Meelo/$V
for f in docker-compose.yml nginx.conf.template env.example settings.json; do
  curl -fsSLO "$BASE/$f"
done
mv env.example .env
ls -la

-rw-r--r-- 1 root root  4563 Oct 29 19:57 docker-compose.yml
-rw-r--r-- 1 root root   780 Oct 29 19:57 nginx.conf.template
-rw-r--r-- 1 root root  2104 Oct 29 19:57 .env
-rw-r--r-- 1 root root   557 Oct 29 19:57 settings.json

#################### Version
TAG=v3.13.1
#################### Network
PORT=8140
# 对外访问地址（不带末尾斜杠），用于拼装前端请求的 API 地址
PUBLIC_URL=http://192.168.146.128:8140
#################### Config
CONFIG_DIR=/opt/meelo/config
DATA_DIR=/opt/meelo/data
#################### Anonymous Access
ALLOW_ANONYMOUS=0
ENABLE_USER_REGISTRATION=1
#################### Scrobblers（可选，留空即可）
LASTFM_API_KEY=
LASTFM_API_SECRET=
#################### Database
POSTGRES_USER=meelo
POSTGRES_PASSWORD=q1w2e3r4
POSTGRES_DB=meelo
RABBITMQ_USER=meelo
RABBITMQ_PASSWORD=q1w2e3r4
#################### Security（三个密钥都要用随机值，生成方式见下方命令）
JWT_SIGNATURE=<替换为: openssl rand -hex 32 的输出>
MEILI_MASTER_KEY=<替换为: openssl rand -hex 16 的输出（至少 16 字节）>
API_KEYS=<替换为: openssl rand -hex 16 的输出>
#################### Internal（官方注释：Do not change this）
INTERNAL_DATA_DIR=/data
INTERNAL_CONFIG_DIR=/config

openssl rand -hex 32   # 生成 JWT_SIGNATURE
openssl rand -hex 16   # 生成 MEILI_MASTER_KEY 与 API_KEYS

{
	"trackRegex": [
		"^([\\/\\\\]+.*)*[\\/\\\\]+(?P<AlbumArtist>.+)[\\/\\\\]+Unknown Album[\\/\\\\]+(?P<Track>.*)\\..*$",
		"^([\\/\\\\]+.*)*[\\/\\\\]+(?P<AlbumArtist>.+)[\\/\\\\]+(?P<Album>.+)(\\s+\\((?P<Year>\\d{4})\\))?[\\/\\\\]+((?P<Disc>[0-9]+)-)?(?P<Index>[0-9]+)\\s+(?P<Track>.*)\\..*$"
	],
	"metadata": {
		"source": "embedded",
		"order": "only",
		"useExternalProviderGenres": true
	},
	"providers": {
		"musicbrainz": {}
	},
	"compilations": {
		"useID3CompTag": true,
		"artists": [
			"Various Artists"
		]
	},
	"useEmbeddedThumbnails": false
}

cd /opt/meelo
docker compose up -d

[+] Running 12/12
 ✔ Network meelo-stack_meelo-net          Created
 ✔ Volume "meelo-stack_db"                Created
 ✔ Volume "meelo-stack_search"            Created
 ✔ Volume "meelo-stack_transcoder_cache"  Created
 ✔ Volume "meelo-stack_rabbitmq_data"     Created
 ✔ Container meelo-v3.13.1-mq             Healthy
 ✔ Container meelo-v3.13.1-db             Healthy
 ✔ Container meelo-v3.13.1-meilisearch    Healthy
 ✔ Container meelo-v3.13.1-server         Healthy
 ✔ Container meelo-v3.13.1-scanner        Healthy
 ✔ Container meelo-v3.13.1-front          Started
 ✔ Container meelo-v3.13.1-nginx          Started

docker compose ps

NAME                        STATUS
meelo-v3.13.1-db            Up 12 minutes (healthy)
meelo-v3.13.1-front         Up 20 minutes
meelo-v3.13.1-matcher       Up 20 minutes
meelo-v3.13.1-meilisearch   Up 20 minutes (healthy)
meelo-v3.13.1-mq            Up 20 minutes (healthy)
meelo-v3.13.1-nginx         Up 20 minutes
meelo-v3.13.1-scanner        Up 20 minutes (healthy)
meelo-v3.13.1-server        Up 12 minutes (healthy)
meelo-v3.13.1-transcoder    Up 18 minutes

curl -s http://localhost:8140/api/settings
# {"transcoderAvailable":true,"allowAnonymous":false,"enableUserRegistration":true,"version":"v3.13.1"}
curl -s -o /dev/null -w 'front HTTP %{http_code}\n' http://localhost:8140/
# front HTTP 200

TOKEN=$(curl -s -X POST http://localhost:8140/api/auth/login \
  -H 'Content-Type: application/json' \
  -d '{"username":"root","password":"q1w2e3r4"}' | sed -E 's/.*"access_token":"([^"]+)".*/\1/')
curl -s -H "Authorization: Bearer $TOKEN" http://localhost:8140/api/libraries
# {"metadata":{"count":1,"this":"/libraries","next":null,"previous":null,"page":1},
#  "items":[{"id":1,"name":"Demo Library","slug":"demo-library","path":"."}]}

docker run --rm -v /opt/meelo/data:/out jrottenberg/ffmpeg:5-alpine -y \
  -f lavfi -i "sine=frequency=440:duration=25" \
  -f lavfi -i "sine=frequency=660:duration=25" \
  -filter_complex "[0:a][1:a]amix=inputs=2:duration=longest,aformat=channel_layouts=stereo[a]" \
  -map "[a]" -codec:a libmp3lame -b:a 128k -ar 44100 \
  -id3v2_version 3 -write_id3v1 1 \
  -metadata "title=Neon Skyline" -metadata "artist=Aiko Taylor" \
  -metadata "album_artist=Aiko Taylor" -metadata "album=Neon Skyline" \
  -metadata "track=1" -metadata "date=2024" -metadata "genre=Electronic" \
  "out/Aiko Taylor/Neon Skyline (2024)/1 - Neon Skyline.mp3"

size=     412kB time=00:00:25.01 bitrate= 134.9kbits/s speed=61.3x
video:0kB audio:410kB subtitle:0kB other streams:0kB global headers:0kB

# 触发 1 号曲库扫描
curl -s -w '\nHTTP %{http_code}\n' -X POST \
  -H "Authorization: Bearer $TOKEN" http://localhost:8140/scanner/scan/1
# {"message":"Task added to queue","version":""}
# HTTP 202

# 轮询任务状态（扫描完 current_task 回到 null）
curl -s -H "Authorization: Bearer $TOKEN" http://localhost:8140/scanner/tasks
# {"current_task":"Scan library 'demo-library'","progress":0,"pending_tasks":[]}
# {"current_task":null,"progress":null,"pending_tasks":[]}

# 验证歌曲已注册
curl -s -H "Authorization: Bearer $TOKEN" "http://localhost:8140/api/songs?query=Neon"
# count: 1
# - Neon Skyline | aiko-taylor-neon-skyline | artistId 1

# 取歌曲的数字 ID（song id 与 master track id 一致时可直接用）
curl -s -H "Authorization: Bearer $TOKEN" \
  "http://localhost:8140/api/songs/aiko-taylor-neon-skyline" | head -c 200
# {"id": 2, "name": "Neon Skyline", ... "masterId": 2 ...}

# 原始流 direct：字节级校验
curl -s -o /tmp/neon.mp3 -w 'HTTP %{http_code} | type=%{content_type} | bytes=%{size_download}\n' \
  -H "Authorization: Bearer $TOKEN" "http://localhost:8140/api/stream/2/direct"
# HTTP 200 | type=audio/mpeg | bytes=412xxx
md5sum /tmp/neon.mp3 "/opt/meelo/data/Aiko Taylor/Neon Skyline (2024)/1 - Neon Skyline.mp3"
# 两行 MD5 完全一致（实测 3a19aa15e801908451616ddda88c7fb3 形态）→ 原始流无损透传

curl -s -H "Authorization: Bearer $TOKEN" \
  -H "X-CLIENT-ID: 7f3a9c2e-51b4-4d8e-9a21-6c5f0e8d3b17" \
  "http://localhost:8140/api/stream/2/master.m3u8"

#EXTM3U
#EXT-X-VERSION:7
#EXT-X-MEDIA:TYPE=AUDIO,GROUP-ID="a-original",NAME="Audio 0",DEFAULT=YES,CHANNELS="2",URI="audio/0/original/index.m3u8?clientId=7f3a9c2e-..."
#EXT-X-MEDIA:TYPE=AUDIO,GROUP-ID="a-128k",NAME="Audio 0",DEFAULT=YES,CHANNELS="2",URI="audio/0/128k/index.m3u8?clientId=7f3a9c2e-..."

#EXT-X-TARGETDURATION:4
#EXT-X-MEDIA-SEQUENCE:0
#EXT-X-INDEPENDENT-SEGMENTS
#EXT-X-MAP:URI="init.mp4?clientId=7f3a9c2e-..."
#EXTINF:3.996735
segment-0.mp4?clientId=7f3a9c2e-...

level=INFO msg="creating an audio stream" idx=0 path="/data/Aiko Taylor/Neon Skyline (2024)/1 - Neon Skyline.mp3"
level=INFO msg="finished ffprobe keyframe analysis for /data/Aiko Taylor/Neon Skyline (2024)/1 - Neon Skyline.mp3 audio n0" duration=41.466982ms

# 1. 数据库
docker run -d --name meelo-db --network meelo-net \
  -e POSTGRES_USER=meelo -e POSTGRES_PASSWORD=q1w2e3r4 -e POSTGRES_DB=meelo \
  -v meelo_db:/var/lib/postgresql/data postgres:alpine3.14

# 2. 消息队列
docker run -d --name meelo-mq --hostname meelo-mq --network meelo-net \
  -e RABBITMQ_DEFAULT_USER=meelo -e RABBITMQ_PASSWORD=q1w2e3r4 \
  -v meelo_rabbitmq_data:/var/lib/rabbitmq rabbitmq:4.3-alpine

# 3. 搜索引擎
docker run -d --name meelo-meilisearch --network meelo-net \
  -e MEILI_ENV=production -e MEILI_MASTER_KEY=<同 .env 取值> -e MEILI_LOG_LEVEL=WARN \
  -v meelo_search:/meili_data getmeili/meilisearch:v1.5

# 4. 核心 API
docker run -d --name meelo-server --network meelo-net --init \
  -v /opt/meelo/data:/data -v /opt/meelo/config:/config \
  --env-file /opt/meelo/.env \
  -e TRANSCODER_URL=http://meelo-transcoder:7666 \
  -e MEILI_HOST=http://meelo-meilisearch:7700 \
  -e RABBITMQ_URL=amqp://meelo:q1w2e3r4@meelo-mq:5672 \
  -e DATABASE_URL=postgresql://meelo:q1w2e3r4@meelo-db:5432/meelo?schema=public \
  arthichaud/meelo-server:v3.13.1

# 5. 转码器
docker run -d --name meelo-transcoder --network meelo-net --cpus 1 \
  -v /opt/meelo/data:/data:ro -v meelo_transcoder_cache:/cache \
  -e GOCODER_SAFE_PATH=/data \
  -e PGUSER=meelo -e PGPASSWORD=q1w2e3r4 -e PGDATABASE=meelo \
  -e PGHOST=meelo-db -e PGPORT=5432 \
  ghcr.io/zoriya/kyoo_transcoder:5.2.1

# 6. 扫描器
docker run -d --name meelo-scanner --network meelo-net \
  -v /opt/meelo/data:/data:ro -v /opt/meelo/config:/config:ro \
  -e API_URL=http://meelo-server:4000 -e INTERNAL_CONFIG_DIR=/config \
  -e INTERNAL_DATA_DIR=/data -e API_KEYS=<同 .env 取值> \
  arthichaud/meelo-scanner:v3.13.1

# 7. 匹配器
docker run -d --name meelo-matcher --network meelo-net \
  -v /opt/meelo/config:/config:ro \
  -e API_URL=http://meelo-server:4000 -e INTERNAL_CONFIG_DIR=/config \
  -e API_KEYS=<同 .env 取值> \
  -e RABBITMQ_URL=amqp://meelo:q1w2e3r4@meelo-mq:5672 \
  arthichaud/meelo-matcher:v3.13.1

# 8. 前端
docker run -d --name meelo-front --network meelo-net \
  -e PUBLIC_SERVER_URL=http://192.168.146.128:8140/api \
  -e SSR_SERVER_URL=http://meelo-server:4000 \
  -e PUBLIC_SCANNER_URL=http://192.168.146.128:8140/scanner \
  -e SSR_SCANNER_URL=http://meelo-scanner:8133 \
  -e PUBLIC_MATCHER_URL=http://192.168.146.128:8140/matcher \
  -e SSR_MATCHER_URL=http://meelo-matcher:6789 \
  arthichaud/meelo-front:v3.13.1

# 9. 入口网关
docker run -d --name meelo-nginx --network meelo-net -p 8140:5000 \
  -e PORT=5000 -e FRONT_URL=http://meelo-front:3000 \
  -e SERVER_URL=http://meelo-server:4000 \
  -e SCANNER_URL=http://meelo-scanner:8133 \
  -e MATCHER_URL=http://meelo-matcher:6789 \
  -v /opt/meelo/nginx.conf.template:/etc/nginx/templates/meelo.conf.template:ro \
  nginx:1.31.3-alpine

docker compose ps                        # 查看全部服务状态与健康检查结果
docker compose logs -f server            # 跟踪 API 日志（scanner/matcher/nginx 同理）
docker compose restart server            # 重启单个服务（改环境变量后需要）
docker compose stop                      # 停止全栈（保留容器与数据）
docker compose start                     # 恢复全栈
docker compose down                      # 移除容器与网络（保留卷数据）
docker compose down -v                   # ⚠️ 同时删除卷（数据库内容全清，勿在生产执行）
docker compose pull                      # 拉取新版本镜像（配合修改 .env 的 TAG 后 up -d 升级）
docker compose exec db pg_dumpall -U meelo > backup.sql   # 备份元数据库
docker compose exec server wget -qO- localhost:4000       # 直接探测 API 存活

Error: Error when performing the request to https://repo.yarnpkg.com/4.18.0/packages/yarnpkg-cli/bin/yarn.js; ...
    at async Engine.ensurePackageManager (/usr/local/lib/node_modules/corepack/dist/lib/corepack.cjs:14111:25)
  [cause]: [TypeError: fetch failed] {
    [cause]: AggregateError [ETIMEDOUT]: ...
        code: 'ETIMEDOUT',
        syscall: 'connect',
        address: '104.16.169.120',
        port: 443,

ERR Polling libraries failed. Request to API failed:
Get "http://server:4000/libraries": dial tcp 10.89.56.8:4000: connect: connection refused

DBG Library has 1 new files  library=demo-library
ERR failed to compute fingerprint  file="3 - Upload Probe.mp3"
ERR Parsing failed  file="3 - Upload Probe.mp3"
TRC error running ffprobe [] exit status 1
INF Library has registered 0 new files

{"statusCode":400,"message":"Identifier: expected a number, got aiko-taylor-upload-probe"}