Music Tag Web Docker 部署指南
Music Tag Web 是一款功能强大的网页版音乐元数据编辑器,支持 FLAC、APE、WAV、MP3 等多种主流音频格式。它允许用户通过浏览器方便地编辑歌曲的标题、专辑、艺术家、歌词及封面等信息,特别适合家庭媒体中心(如 Plex、Jellyfin)用户进行音乐库整理。
使用 Docker 部署可以实现环境隔离与快速迁移,无需在服务器上安装复杂的环境依赖,尤其适合无图形界面的服务器运行。
前置准备
硬件建议
Docker 本身资源占用较低,但处理大型音乐库时仍需一定算力:
- 最低配置:1 核 CPU,1GB 内存(小型库)。
- 推荐配置:2+ 核 CPU,2GB+ 内存(中大型库或频繁刮削)。
- 存储:预留足够空间存放镜像、应用数据及音乐文件。
软件环境
- 操作系统:Ubuntu、CentOS、Debian、Windows 10/11 Pro 或 macOS 等支持 Docker 的 64 位系统。
- Docker Engine:确保已安装并运行。
- Docker Compose:推荐使用,能简化多容器管理。
开始部署
1. 拉取镜像
打开终端执行以下命令获取官方最新镜像:
docker pull xhongc/music_tag_web:latest
2. 规划目录结构
为了持久化配置和保留音乐文件,需要在宿主机创建挂载目录。请根据实际情况替换路径:
# 创建配置文件夹
mkdir -p /path/to/your/config
# 创建音乐文件夹
mkdir -p /path/to/your/music
将您的音乐文件放入 /path/to/your/music 目录下。
3. 启动服务
您可以选择直接运行或使用 Docker Compose。
方式一:docker run 命令 适用于快速测试,注意替换路径占位符:
docker run -d \
--name=music-tag-web \
-p 8002:8002 \
-v /path/to/your/music:/app/media:rw \
-v /path/to/your/config:/app/data \
--restart=unless-stopped \
xhongc/music_tag_web:latest
参数说明:
-p 8002:8002:映射端口,默认访问地址为http://<IP>:8002。-v ...:卷挂载,分别对应音乐文件和配置文件。--restart=unless-stopped:退出后自动重启。
方式二:Docker Compose(推荐)
更利于长期维护。在项目目录下创建 docker-compose.yml:
version: '3.7'
services:
music-tag:
image:


