Docker 部署 music-tag-web 音乐标签编辑器
一、music-tag-web 介绍
1.1 简介
Music-Tag-Web 是一款功能全面的音乐标签编辑工具，专为管理和优化本地音乐库设计。它支持查看和编辑大部分音频格式的元数据，提供批量处理、整理和转换功能，让管理大量音乐文件变得简单高效。
1.2 主要特点
- 广泛的音频格式支持：支持查看、编辑和修改大多数音频格式的元数据。
- 批量自动修改（刮削）：自动批量更新音乐标签，提升信息完整性。
- 音乐指纹识别：即使缺少元数据，也能通过指纹技术识别。
- 智能文件整理：根据艺术家、专辑分组，支持自定义多级分组。
- 灵活的排序选项：按文件名、大小或更新时间排序。
- 繁简体转换：支持音乐元数据在繁体中文与简体中文之间的批量转换。
- 元数据补充：从文件名拆解并补充缺失的元数据信息。
- 文本替换功能：批量替换音乐元数据中的脏数据。
- 音乐格式转换：集成 ffmpeg 支持多种音乐格式之间的转换。
- 整轨切割：支持将整轨音乐文件分割成多个独立的曲目。
- 多源标签获取：可以从不同的来源获取音乐标签信息。
- 歌词翻译：内置歌词翻译功能。
- 操作记录显示：方便用户追踪和回顾所有执行过的操作。
- 专辑封面管理：支持导出专辑封面，并允许上传自定义封面。
- 移动端适配：界面友好地适应移动设备。
- 小爱同学兼容：支持使用小爱同学语音助手播放本地音乐及 NAS 上的音乐。
二、环境规划与检查
本次实践基于个人测试环境，操作系统为 Ubuntu 22.04.1 LTS。
| hostname | IP 地址 | 操作系统版本 | Docker 版本 | 镜像版本 |
|---|---|---|---|---|
| jeven01 | 192.168.3.88 | Ubuntu 22.04.1 LTS | 27.1.1 | latest |
2.1 环境检查
确保 Docker 服务正常运行且版本符合要求。
检查 Docker 服务状态
systemctl status docker
预期输出应显示 Active: active (running)。
检查 Docker 版本
docker -v
建议版本不低于 27.x。
检查 Docker Compose 版本 确保使用 2.0 以上版本。
docker compose version
预期输出类似 Docker Compose version v2.19.1。
三、下载镜像
拉取官方镜像 xhongc/music_tag_web:latest。
docker pull xhongc/music_tag_web:latest
等待下载完成，看到 Status: Downloaded newer image 提示即可。
四、部署应用
4.1 创建目录
在宿主机上创建部署目录并进入。
mkdir -p /data/music-tag-web && cd /data/music-tag-web
4.2 编写配置文件
创建 docker-compose.yaml 文件。宿主机映射端口等可根据实际需求调整。
version: '3'
services:
music-tag:
image: xhongc/music_tag_web:latest
container_name: music-tag-web
ports:
- "8001:8001"
volumes:
- /data/music-tag-web/music:/app/media:rw
- /data/music-tag-web/config:/app/data
command: /start
restart: unless-stopped
这里配置了容器名称、端口映射以及数据卷挂载。/app/media 用于存放音乐文件，/app/data 用于存储配置。
4.3 启动容器
执行以下命令后台启动服务。
docker compose up -d
若看到 Container music-tag-web Started 表示启动成功。
4.4 验证状态
检查容器运行状态。
docker compose ps
确认 STATUS 为 Up，端口映射正确。
查看日志确保无报错。
docker compose logs
五、访问服务
浏览器访问 http://<服务器 IP>:8001（请将 IP 替换为实际地址）。如果无法访问，请检查防火墙是否放行 8001 端口，云服务器还需配置安全组规则。
默认账号密码为 admin/admin，首次登录后建议立即修改密码。
六、总结
通过 Docker 部署 Music-Tag-Web，利用容器化技术简化了应用依赖和环境一致性。只需几条命令即可完成封装，便于跨平台迁移。配合 Docker Compose 管理多容器应用，服务的启停和更新更加直观高效。
