影音与下载

Music Tag Web:音乐标签与封面整理

  • 2 次阅读
  • 0 条评论
文章摘要

Music Tag Web 通过网页整理音乐文件的标题、歌手、专辑、封面等标签。标签会影响音乐服务器如何组织曲库,因此应先在副本上处理,区分文件名、文件夹名称与音频文件内部的元数据。

项目介绍

Music Tag Web 提供网页音乐标签编辑功能,可用于整理歌曲名、专辑、歌手和封面。下文介绍容器配置、V2 部署与群晖目录准备。批量修改前先用少量文件测试,确认写入结果后再处理整个曲库。

version: '3'
services:
  music-tag:
    image: xhongc/music_tag_web:latest
    container_name: music-tag-web
    ports:
      - "8001:8001"
    volumes:
      - /volume1/docker/music_tag_web/config:/app/data
      - /volume1/music:/app/media:rw
    command: /start
    restart: unless-stopped

默认用户名 admin 密码admin

补充:部署与使用

配置与操作示例

V2 Compose 部署

准备一份专门用于测试的音乐副本。下方准备命令会创建目录并将随机密钥自动保存到私有 .env:

无需手动复制密钥,完成下方目录准备后保存 compose.yaml:

群晖目录准备

在群晖 SSH 终端执行下面这一段,再将下方配置保存为 /volume1/docker/music-tag-web/compose.yaml。也可在 Container Manager 中新建项目,选择该目录并粘贴配置。

sudo sh <<'HALO_PREPARE'
set -eu
mkdir -p /volume1/docker/music-tag-web /volume1/docker/music-tag-web/data /volume1/docker/music-tag-web/test-music
cd /volume1/docker/music-tag-web
umask 077
touch .env
if ! grep -q "^DJANGO_SECRET_KEY=." .env; then
  generated_secret=$(openssl rand -hex 32)
  printf 'DJANGO_SECRET_KEY=%s\n' "$generated_secret" >> .env
fi
chmod 600 .env
HALO_PREPARE
cd /volume1/docker/music-tag-web

所需密码和密钥已自动生成到项目目录的 .env,已有非空值会保留。查看初始化密码可在自己的终端执行 sudo cat /volume1/docker/music-tag-web/.env;该文件只保留在本机。

services:
  music-tag:
    image: xhongc/music_tag_web:latest
    ports:
      - "8002:8002"
    environment:
      DJANGO_SECRET_KEY: "${DJANGO_SECRET_KEY}"
    volumes:
      - /volume1/docker/music-tag-web/test-music:/app/media:rw
      - /volume1/docker/music-tag-web/data:/app/data
    restart: unless-stopped

V2 使用容器端口 8002,无需 V1 的 command: /start。启动后访问 http://NAS_IP:8002/admin,按官方手册完成管理员登录并立即修改初始凭据。测试音乐在程序内对应 /app/media。

标签整理顺序

先核对「专辑歌手、专辑名、光盘号、曲目号」,再处理标题、歌词和封面。同一张专辑被拆成多个条目时,优先比较专辑歌手与专辑名是否一致。自动识别后先预览,保存一首并用其他播放器验证,再处理整张专辑。

启动与状态检查

在保存 compose.yaml 和所需 .env 的项目目录执行:

docker compose config --quiet
docker compose up -d
docker compose ps
docker compose logs --tail=100

config 用于检查配置,不会启动服务。示例使用上游浮动发行通道;长期运行可改为项目实际发布的固定标签或已记录的镜像摘要,不猜写版本号。日志中出现的初始密码和访问凭据仅在自己的终端查看。

常见问题

  • 中文乱码要区分标签编码和文件名编码
  • 先比较原文件与另一个播放器,不直接批量转换全部文件。
  • 匹配到封面不代表曲目版本正确,尤其检查同名专辑、发行年份与曲目数量。

更新与备份

保留原音乐文件、处理记录与应用配置;只有导出的歌曲清单不能恢复被改写的标签。

更新前记录当前镜像或仓库提交,停止会写入的任务并备份持久化数据;阅读版本迁移说明后再拉取并重建。数据库已经迁移时,回退还需要匹配的数据副本。需要暂时停服务可用 docker compose stop,不要把删除卷或清空数据目录当作更新步骤。

官方资料