Music Tag Web
Music Tag Web简介
Music Tag Web是什么
Music Tag Web 是一款开源的 Web 音乐标签编辑器,能直接编辑服务器或本机上的音频元数据,适用于管理 Navidrome 等音乐服务器的场景。它支持包括 FLAC、APE、WAV、aiFF、WV、TTA、MP3、M4A、OGG、MPC、OPUS、WMA、DSF、DFF、MP4 等多种格式,具备批量编辑、音乐指纹识别、歌词与封面管理、格式转换、整轨切割、简繁转换、文本替换、操作记录以及移动端适配等功能。该项目后端采用 Python + Django,前端使用 Vue,其镜像托管在 Docker Hub(xhongc/music_tag_web:latest)。

Music Tag Web核心功能
标签编辑
基础标签:涵盖歌曲名、歌手、专辑、发行年份、流派、曲目序号、封面图片。
高级标签:包含歌词嵌入、作曲家、编曲、版权信息、唱片公司。
批量处理:支持批量导入多个音频文件,统一修改标签规则,比如批量添加专辑名、统一封面,从而提高效率。
格式兼容性:支持常见的音频格式,如 MP3、FLAC、AAC、WAV、OGG、APE 等。部分工具能够读取和写入不同格式的标签标准,例如 ID3v1、ID3v2、Vorbis Comment。
封面管理:可以上传本地图片作为专辑封面,还能进行裁剪、缩放操作,保证封面与音频匹配。
导出与保存:编辑完成后,能直接下载修改后的音频文件,也可以将标签信息导出为文本(如 CSV)进行备份。
Music Tag Web使用方法
先上传音乐,接着在左侧目录树勾选文件夹。然后在右侧点击“自动刮削”,选择“宽松模式”“全部源”“覆盖旧标签”,最后保存。对于红色显示的失败条目,需要手动修改,输入正确的专辑或歌手,进行搜索,点击匹配结果后保存。还可以一键整理,点击顶部“整理文件”,选择模板 artist/{album}/track{title} 后执行。
快速部署
# 1. 创建目录(音乐库+配置) mkdir -p /volume1/music /volume1/docker/music-tag # 2. 启动容器(端口 8002,镜像约 300 MB) docker run -d --name music-tag-web \ -p 8002:8002 \ -v /volume1/music:/app/media:rw \ -v /volume1/docker/music-tag:/app/data \ --restart unless-stopped \ xhongc/music_tag_web:latest
浏览器访问 http://NAS-IP:8002,默认账号/密码 admin/admin 即可开始刮削。
想升级或回滚,直接 docker pull xhongc/music_tag_web:latest 然后重新创建容器即可;配置与音乐文件都在宿主机映射目录,不会丢失。
Music Tag Web应用场景
个人音乐库整理:把零散下载的歌曲统一编辑标签,便于播放器分类检索。
自媒体 / 播客制作:为原创音频添加标题、作者、封面,满足平台上传要求。
音乐爱好者分享:整理无损音乐专辑时,完善标签信息,提升分享体验。
常见问题
端口冲突:修改参数为 -p 8011:8002 即可。
中文乱码:先“清除所有标签”,再重新刮削;或者把 ID3 编码设为 UTF - 8。
整轨无法分轨:确认同目录下有对应的 .cue 文件,上传后点击“分割”按钮。
外网访问:在路由器上做 8002 端口映射,或者采用反向代理、内网穿透的方式。
Music Tag Web相关资源
源码/文档/更新日志:https://github.com/xhongc/music-tag-web
在线 Demo:https://xiers-organization.gitbook.io/music-tag-web-v2
提交您的产品
Ai应用
Ai资讯
AI生图
AI生视频
开源AI应用平台


