music-tag-web

Music Tag Web 是一款面向 NAS、远程影音服务器及 Homelab 自建玩家的开源自托管 Docker 音乐标签编辑器。项目旨在解决本地 MP3Tag、MusicBrainz Picard 等工具无法远程修改服务器无损曲库元数据的痛点，通过 Docker 容器一键部署，作为 Navidrome、Jellyfin 等影音服务的配套边车应用，使用户可通过浏览器远程管理本地私有曲库。 核心功能涵盖全格式音频文件（FLAC、APE、WAV、AIFF、WV、TTA、MP3、M4A、OGG、MPC、OPUS、WMA、DSF、MP4）的元数据查看、单条与批量编辑、ID3 标签修复。支持批量自动刮削，自动匹配专辑信息、艺术家、歌词与封面；内置音乐指纹识别，可自动识别无标签或文件名混乱的歌曲并补全元数据。此外还提供智能曲库整理（按艺术家、专辑自动分组）、多维度文件排序、批量繁简转换、文件名拆分解包提取缺失信息、批量文本替换清理脏标签、集成 ffmpeg 无损格式批量转换、整轨 APE/FLAC/CUE 文件自动切割分轨并补全独立标签、多源音乐元数据接口兜底刮削、内嵌歌词翻译批量写入、完整操作日志追溯、批量导出与自定义上传替换专辑封面等功能。 部署方面，项目提供 V1 与 V2 两种 Docker 部署方式，V2 为当前推荐版本，容器内部服务端口为 8002，Docker Compose 配置更简洁，兼容性更好。镜像已上传至 Docker Hub，支持 amd64 与 arm64 架构，适配群晖、威联通、树莓派等设备。用户只需挂载本地音乐目录与配置目录即可运行，默认访问地址为 127.0.0.1:8002/admin，默认账号密码为 admin/admin。 界面采用全响应式移动端 UI 设计，支持手机浏览器远程访问 NAS 曲库进行标签编辑。项目还兼容小爱同学本地曲库播放，可直接读取 NAS 无损音乐文件，并支持各类私人网盘挂载曲库的在线播放与标签编辑。播放数据统计功能提供柱形图、折线图可视化曲库播放记录。 项目基于 GPL V3.0 许可证发行，所有曲库文件本地存储不上传第三方，注重隐私安全。项目完全免费，仅供个人私下研究学习技术使用，禁止任何形式的商业用途。