panda62/music-tag-web

音乐标签web版 Docker镜像文档

镜像概述

音乐标签web版是一个基于Web界面的音乐标签管理工具，用于便捷地管理和编辑本地音乐文件的元数据。本镜像基于原作者https://github.com/xhongc/music-tag-web%E9%A1%B9%E7%9B%AE%E8%BF%9B%E8%A1%8C%E4%BF%AE%E6%94%B9%EF%BC%8C%E4%BF%AE%E6%94%B9%E5%90%8E%E7%9A%84%E4%BB%A3%E7%A0%81%E4%BB%93%E5%BA%93%E5%9C%B0%E5%9D%80%E4%B8%BAhttps://github.com/diaodeng/music-tag-web/tree/dev_1.0_diaodeng%E3%80%82

核心功能与特性

主要改进内容

1. 左侧目录树优化：

   • 增加滚动条，提升长目录浏览体验
   • 固定搜索栏，方便快速定位文件
   • 增加显示内容切换功能

2. 性能优化：

   • 通过异步方式获取文件元数据，解决因读取原数据导致的加载缓慢问题

3. 功能增强：

   • 歌曲信息编辑页面增加播放功能，支持编辑时预览音乐

使用场景

适用于需要管理本地音乐库元数据的用户，可通过Web界面直观地查看、编辑音乐文件的标签信息（如标题、艺术家、专辑等），尤其适合音乐收藏者、DJ或需要整理大量音乐文件的用户。

使用方法

Docker Compose部署（推荐）

创建docker-compose.yml文件，内容如下：

yaml
version: '3'

services:
  music-tag:
    image: panda62/music-tag-web:latest
    container_name: music-tag-web
    ports:
      - "8001:8001"  # 主机端口:容器端口，可根据需要修改主机端口
    volumes:
      - /path/to/your/music:/app/media:rw  # 本地音乐文件目录，需替换为实际路径
      - /path/to/your/config:/app/data     # 配置文件存储目录，需替换为实际路径
    command: /start
    restart: always  # 容器退出时自动重启

启动服务：

bash
docker-compose up -d

Docker Run部署

直接使用docker run命令启动：

bash
docker run -d \
  --name music-tag-web \
  -p 8001:8001 \
  -v /path/to/your/music:/app/media:rw \
  -v /path/to/your/config:/app/data \
  --restart always \
  panda62/music-tag-web:latest \
  /start

配置说明

• 端口映射：默认使用容器内8001端口，可通过-p参数映射到主机其他端口
• 数据卷挂载：
  • /app/media：挂载本地音乐文件目录，容器需要读写权限（rw）
  • /app/data：挂载配置文件存储目录，用于保存应用设置和状态
• 启动命令：固定使用/start命令启动应用
• 重启策略：建议设置为always，确保服务持续运行

详细使用说明可参考项目GitHub仓库：https://github.com/diaodeng/music-tag-web/tree/dev_1.0_diaodeng