Music Tag Web 基于 Docker 的部署与管理指南

请确保将您的音乐文件存放在您指定的音乐文件夹中。

3.3. 选择部署方式

您可以根据个人偏好选择以下任一方式进行部署。

方式 A: 使用 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

方式 B: 使用 docker-compose (推荐)

Docker Compose 是管理复杂应用的首选方案。它通过一个 YAML 文件来定义所有服务、网络和卷，使部署和维护更加清晰、可复现。

创建一个名为 docker-compose.yml 的文件：

version: '3.7'
services:
  music-tag:
    image: xhongc/music_tag_web:latest
    container_name: music-tag-web
    environment:
      - PUID=1000 # 替换为您的 UID
      - PGID=1000 # 替换为您的 GID
      - TZ=Asia/Shanghai # 可选：设置时区
    ports:
      - "8002:8002"
    volumes:
      - /path/to/your/music:/app/media:rw
      - /path/to/your/config:/app/data
    restart: unless-stopped

在包含 docker-compose.yml 文件的目录中，执行以下命令启动服务：

docker-compose up -d

同样，请务必替换路径部分。

4. 配置与访问

部署成功后，您可以通过浏览器访问和配置 Music Tag Web。

4.1. 访问 Web UI

在浏览器地址栏输入 http://<您的服务器 IP>:8002，即可打开 Music Tag Web 的主界面。

4.2. 初始设置

首次使用时，建议访问后台管理页面进行必要的安全设置。

1. 访问管理后台：http://<您的服务器 IP>:8002/admin
2. 使用默认凭据登录：
   • 用户名：admin
   • 密码：admin
3. 立即修改密码：登录后，请第一时间在管理后台修改默认的管理员密码，以确保系统安全。

5. 高级配置与管理

5.1. 管理文件权限 (PUID/PGID)

在 Linux 系统上，为了避免容器内应用因权限问题无法读写挂载的音乐文件，推荐使用 PUID 和 PGID 环境变量来指定运行应用的用户和组。

保存文件后，重新创建容器以应用更改：

docker-compose down
docker-compose up -d

修改您的 docker-compose.yml 文件，添加 environment 部分（参考上文）。

注意：虽然 xhongc/music_tag_web 镜像目前可能未直接内置 PUID/PGID 支持，但这是 Docker 社区处理权限问题的最佳实践。您可以关注其官方更新或使用支持此功能的其他基础镜像进行自定义构建。

首先，获取您当前用户的 UID 和 GID。在终端中执行：

id $(whoami)

您会看到类似 uid=1000(user) gid=1000(user) 的输出。

5.2. 更新容器

保持软件最新是获取新功能和安全修复的关键。更新 Music Tag Web 非常简单：

如果您使用 docker run，则需要手动停止并移除旧容器，然后使用相同的 docker run 命令启动新容器：

# 停止旧容器
docker stop music-tag-web
# 移除旧容器
docker rm music-tag-web
# 使用之前的 `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

如果您使用 Docker Compose，只需在 docker-compose.yml 文件所在目录执行：

docker-compose down
docker-compose up -d

Compose 会自动使用新镜像重新创建容器，由于数据已通过卷挂载，您的所有配置和音乐库信息都会保留。

拉取最新的 Docker 镜像：

docker pull xhongc/music_tag_web:latest

6. 总结

通过本指南，您已经成功地使用 Docker 部署了 Music Tag Web。您不仅学会了基本的部署流程，还了解了数据持久化、权限管理和容器更新等关键维护操作。现在，您可以开始享受通过 Web 界面高效管理和丰富您的音乐收藏所带来的便利了。

Docker 化的部署方式为您提供了一个稳定、可移植且易于管理的应用环境。建议定期关注 Music Tag Web 的 Docker Hub 页面和其 GitHub 仓库，以获取最新的版本信息和功能更新。

参考资料

• xhongc/music-tag-web
• xhongc/music_tag_web - Docker Image