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:
