Music Tag Web 怎么用 Docker Compose 部署从目录挂载到首次登录如果你的音乐库放在 NAS 或 Linux 主机里Music Tag Web这类带Web UI的工具会比本地桌面标签工具更适合长期维护。官方文档已经给了Docker Compose的最小示例本文把它补成一篇可直接照做的部署教程重点讲目录挂载、首次访问和常见报错。这篇文章默认建议用Docker Compose。原因很简单后续改路径、迁移机器、重建容器时Compose 文件比一次性的启动命令更好维护而且官方 V2 文档本身也把Docker Compose 部署单独列出来。部署前先准备 3 件事先把 3 个目录分开音乐库挂到/app/media配置目录挂到/app/data下载目录挂到/app/download。官方文档特别提醒下载目录不要和正式媒体库重合这样后面做后台刮削或整理时不容易把待处理文件和正式曲库混在一起。然后确认两件事你的 Docker 环境能正常起容器宿主机的8002端口可用。官方 V2 文档默认就是这个端口。直接写好docker-compose.yml先建一个目录比如~/apps/music-tag-web/把下面这份最小配置保存成docker-compose.ymlversion:3services:music-tag:image:xhongc/music_tag_web:latestcontainer_name:music-tag-webports:-8002:8002volumes:-/path/to/your/music:/app/media-/path/to/your/config:/app/data-/path/to/your/download:/app/downloadrestart:always这里最重要的是把 3 个路径换成你机器上的绝对路径。/path/to/your/music指向正式音乐库/path/to/your/config用来持久化配置/path/to/your/download放下载或待整理文件不要和正式曲库共用。8002:8002表示宿主机通过8002提供访问。文件保存后在这个目录执行dockercompose up-d如果你用的是带栈管理的 NAS 面板也可以直接粘贴这份 YAML。核心原则不变镜像、端口和 3 个挂载目录要一致。启动容器后先做 4 个检查第 1 个检查是页面能不能打开。浏览器访问http://你的NAS-IP:8002第一次先用局域网地址不要急着套反向代理。如果打不开先查容器状态、端口占用和宿主机防火墙。第 2 个检查是登录是否正常。官方Docker部署页面写明默认账号密码是admin/admin。第一次登录后先把管理密码改掉。第 3 个检查是音乐目录有没有被正确识别。最稳的办法不是一上来全库开刮而是先拿一张专辑试一下。看不到文件多半是路径或权限问题能看到但写不回去通常也是权限没给够。第 4 个检查是配置有没有持久化。改一次设置后重启容器再看设置是否还在。如果重启后丢失通常说明/app/data没有正确挂载。遇到问题时优先排查这 4 类1. 页面打不开先执行docker ps看容器是不是还在运行再看宿主机上的8002是否真的对外监听。很多“部署失败”其实只是端口冲突、容器没起来或者访问了错误的 IP。2. 反向代理后出现csrf错误官方文档的建议很直接先用局域网地址进入。也就是说先确认服务本体可用再回头调反向代理规则。3. 音乐目录读不到或者下载目录和曲库重叠这类问题通常和路径规划有关。正式音乐库、配置目录、下载目录各管各的最省心。尤其是下载目录官方文档已经强调不要和媒体库重复。4. 要不要一开始就上 MySQL不用。官方Mysql 部署页面说明默认数据库是 Sqlite只有在并发写入时才比较容易出现sqlite database is locked。更合理的顺序是先把部署跑通真遇到瓶颈再升级。FAQDocker Compose 和docker run该选哪个如果你只想临时试一下docker run也能用官方同样给了示例。但只要你准备长期放在 NAS 或 Homelab 里跑Compose 更适合后面迁移、修改、备份都更顺。群晖用户可以直接照着本文做吗可以先照着本文理解目录和端口逻辑但群晖用户最好再看一眼官方的群晖部署页面。不同 NAS 面板对目录授权和容器入口的处理并不完全一样。为什么能打开页面却看不到音乐文件大概率不是程序“没扫到”而是挂载路径不对或者容器没有拿到对应目录权限。先检查宿主机绝对路径再确认 NAS 共享目录是否授权给了容器。官网地址http://www.musictagweb.com
Music Tag Web 怎么用 Docker Compose 部署：从目录挂载到首次登录
发布时间：2026/7/26 8:57:16
Music Tag Web 怎么用 Docker Compose 部署从目录挂载到首次登录如果你的音乐库放在 NAS 或 Linux 主机里Music Tag Web这类带Web UI的工具会比本地桌面标签工具更适合长期维护。官方文档已经给了Docker Compose的最小示例本文把它补成一篇可直接照做的部署教程重点讲目录挂载、首次访问和常见报错。这篇文章默认建议用Docker Compose。原因很简单后续改路径、迁移机器、重建容器时Compose 文件比一次性的启动命令更好维护而且官方 V2 文档本身也把Docker Compose 部署单独列出来。部署前先准备 3 件事先把 3 个目录分开音乐库挂到/app/media配置目录挂到/app/data下载目录挂到/app/download。官方文档特别提醒下载目录不要和正式媒体库重合这样后面做后台刮削或整理时不容易把待处理文件和正式曲库混在一起。然后确认两件事你的 Docker 环境能正常起容器宿主机的8002端口可用。官方 V2 文档默认就是这个端口。直接写好docker-compose.yml先建一个目录比如~/apps/music-tag-web/把下面这份最小配置保存成docker-compose.ymlversion:3services:music-tag:image:xhongc/music_tag_web:latestcontainer_name:music-tag-webports:-8002:8002volumes:-/path/to/your/music:/app/media-/path/to/your/config:/app/data-/path/to/your/download:/app/downloadrestart:always这里最重要的是把 3 个路径换成你机器上的绝对路径。/path/to/your/music指向正式音乐库/path/to/your/config用来持久化配置/path/to/your/download放下载或待整理文件不要和正式曲库共用。8002:8002表示宿主机通过8002提供访问。文件保存后在这个目录执行dockercompose up-d如果你用的是带栈管理的 NAS 面板也可以直接粘贴这份 YAML。核心原则不变镜像、端口和 3 个挂载目录要一致。启动容器后先做 4 个检查第 1 个检查是页面能不能打开。浏览器访问http://你的NAS-IP:8002第一次先用局域网地址不要急着套反向代理。如果打不开先查容器状态、端口占用和宿主机防火墙。第 2 个检查是登录是否正常。官方Docker部署页面写明默认账号密码是admin/admin。第一次登录后先把管理密码改掉。第 3 个检查是音乐目录有没有被正确识别。最稳的办法不是一上来全库开刮而是先拿一张专辑试一下。看不到文件多半是路径或权限问题能看到但写不回去通常也是权限没给够。第 4 个检查是配置有没有持久化。改一次设置后重启容器再看设置是否还在。如果重启后丢失通常说明/app/data没有正确挂载。遇到问题时优先排查这 4 类1. 页面打不开先执行docker ps看容器是不是还在运行再看宿主机上的8002是否真的对外监听。很多“部署失败”其实只是端口冲突、容器没起来或者访问了错误的 IP。2. 反向代理后出现csrf错误官方文档的建议很直接先用局域网地址进入。也就是说先确认服务本体可用再回头调反向代理规则。3. 音乐目录读不到或者下载目录和曲库重叠这类问题通常和路径规划有关。正式音乐库、配置目录、下载目录各管各的最省心。尤其是下载目录官方文档已经强调不要和媒体库重复。4. 要不要一开始就上 MySQL不用。官方Mysql 部署页面说明默认数据库是 Sqlite只有在并发写入时才比较容易出现sqlite database is locked。更合理的顺序是先把部署跑通真遇到瓶颈再升级。FAQDocker Compose 和docker run该选哪个如果你只想临时试一下docker run也能用官方同样给了示例。但只要你准备长期放在 NAS 或 Homelab 里跑Compose 更适合后面迁移、修改、备份都更顺。群晖用户可以直接照着本文做吗可以先照着本文理解目录和端口逻辑但群晖用户最好再看一眼官方的群晖部署页面。不同 NAS 面板对目录授权和容器入口的处理并不完全一样。为什么能打开页面却看不到音乐文件大概率不是程序“没扫到”而是挂载路径不对或者容器没有拿到对应目录权限。先检查宿主机绝对路径再确认 NAS 共享目录是否授权给了容器。官网地址http://www.musictagweb.com
