项目介绍
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,不要把删除卷或清空数据目录当作更新步骤。