重新认识 Music Tag Web：V2 版本内置 Subsonic 服务端，刮完就能听

# 重新认识 Music Tag Web：V2 版本内置 Subsonic 服务端，刮完就能听

## 大家对它的误解，我有点无语

这几天在 网上 上刷到不少人讨论 Music Tag Web，我点进去一看——

「就是个标签管理工具吧？」
「刮完还得导到播放器，太麻烦」
「有没有刮完就能直接听的推荐啊？」

说实话，这谁顶得住？

我自己做的项目，居然被人当成"只能刮的工具"，这种感觉，真的有点麻了。

Music Tag Web V2 版本，从设计之初就是「管理 + 播放」一体的。

## 不是标签管理器，是 Subsonic 服务端

让我重新介绍一下它——

**第一，它能刮**

这个大家都知道。拖拽文件夹，点刮削，标签、封面、歌词全部补全。

**第二，V2 内置 Subsonic 服务端**

这才是重点。

Music Tag Web V2 提供了完整的 Subsonic API 兼容服务端。

这意味着什么？

你只需要刮完音乐，然后打开任何支持 Subsonic 协议的播放器——

DSub、Symfonium、Substreamer、Sonix... 随便选一个。

连接到 Music Tag Web，直接播放。

## 我为什么这么设计？

因为我是实用主义者。

你想想传统流程：

1. 用 Picard 刮音乐标签
2. 启动 Subsonic 服务端（如 Airsonic、Navidrome）
3. 把音乐库配置到 Subsonic
4. 用客户端连接 Subsonic 播放

这什么鬼流程？

三个软件换来换去，配置了一遍又一遍。

我的思路很简单：一个服务搞定。

Music Tag Web V2 = 刮削工具 + Subsonic 服务端。

## 具体能干啥？

**1. Web 界面管理**

用浏览器访问 Music Tag Web，浏览你的音乐库。

按艺术家、专辑、流派、年份查看，封面图展示，该有的都有。

拖拽文件夹刮削，批量修改标签，创建播放列表，全在这里搞定。

**2. Subsonic 客户端播放**

打开手机上的 DSub 或 Symfonium，连接到 Music Tag Web。

浏览、搜索、播放、创建歌单——跟 Spotify 一样顺手。

而且音乐是本地的，不需要联网，不用流量。

**3. 随听随刮**

这是我最喜欢的功能。

你在客户端上播放，发现某首歌标签不对？

打开 Web 管理界面，点一下刮削，立即更新。

客户端刷新一下，信息同步过来了。

边听边改，很丝滑。

**4. 全平台支持**

Subsonic 协议有无数客户端：

- Android：DSub、Symfonium、Subsonic
- iOS：Substreamer、play:Sub
- 桌面：Sublime Music、DSub Desktop
- Web：Subsonic 官方界面

不管你用什么设备，总有适配的客户端。

**5. 后台运行**

Music Tag Web 作为一个服务端运行在后台，客户端随时连接。

关掉浏览器？没关系，服务还在。

NAS 部署后，全家都能用。

## 对比其他工具

| 特性 | Music Tag Web V2 | Picard + Airsonic | Navidrome | 网易云音乐 |
|------|-----------------|------------------|-----------|------------|
| 刮标签 | ✅ Web 界面 | ✅ 需切换 | ❌ | ❌ |
| Subsonic 服务端 | ✅ 内置 | ✅（需单独部署） | ✅ | ❌ |
| 一个工具 | ✅ | ❌ 两个 | ❌ 需要刮削工具 | ❌ 需要下载 |
| 本地播放 | ✅ 任意客户端 | ✅ 任意客户端 | ✅ 任意客户端 | ❌ 在线 |
| 随听随刮 | ✅ | ❌ 需切换工具 | ❌ | ❌ |

看到重点了吗？

传统方案是「刮削工具 + Subsonic 服务端」两个软件组合。

Music Tag Web V2 是一个工具，两份能力。

## 真实使用场景

**场景一：整理老歌单 + 手机听**

你有一个 10 年前攒的 MP3 文件夹，几百首歌，全是乱码和空封面。

拖进 Music Tag Web，点刮削，等 3 分钟。

打开手机上的 Symfonium，连接到服务器。

刮好的音乐全在这里，直接点播放，从头听到尾。

不用导出，不用配置第二个软件。

**场景二：NAS 家庭音乐库**

你的 NAS 上部署了 Music Tag Web V2。

你想刮歌，打开 Web 管理界面，拖拽文件夹。

你想听歌，打开手机上的 DSub，连接服务器。

老婆想听她收藏的周杰伦，女儿想听她的儿歌——同一个服务，各自收藏。

全家人一个账号，各取所需。

**场景三：发现新歌 + 立即试听**

你在某个小众音乐社区看到推荐，下载了几张 EP。

刮一下，把标签补全。

打开客户端，立即试听。

喜欢？留着。不喜欢？删除。

一解决，不用切换工具。

## 技术实现

Subsonic API 是个开源协议，Music Tag Web V2 完整实现了核心接口。

用户认证、音乐浏览、搜索、播放列表、随机播放... 该有的都有。

支持流式播放，支持不同码率，支持封面图传输。

客户端兼容性测试过 DSub、Symfonium、Substreamer，都没问题。

## 写在最后

说实话，做 Subsonic 服务端的时候我没想太多。

就是觉得「刮完能通过标准协议播放」是很自然的需求。

但后来发现，市场上居然没有产品这么做。

刮削工具就只做刮削，Subsonic 服务端就只做服务端。

大家都这么干，我就跟着这么干？

不，我不想。

我觉得用户的体验应该是一体的、顺畅的。

不需要在两个软件之间切换，不需要配置两套系统。

一个服务，Web 管理界面 + Subsonic 协议支持，搞定所有事情。

这就是我做 Music Tag Web V2 的初衷。

## 怎么用？

项目开源，直接部署：
Docker Compose 部署
DockerCompose命令

```bash
version: '3'

services:
  music-tag:
    image: xhongc/music_tag_web:latest
    container_name: music-tag-web
    ports:
      - "8002:8002"
    volumes:
      - /path/to/your/music:/app/media
      - /path/to/your/config:/app/data
      - /path/to/your/download:/app/download
    restart: always
```
将 /path/to/your/music 替换为你的 NAS 上音乐文件夹的绝对路径。

将 /path/to/your/config 替换为你新建的一个目录路径，用于存放应用程序的配置文件。

/path/to/your/download 替换为你新下载音乐的目录，不与媒体库重复和重合，用于后台刮削监控目录
打开浏览器访问 `http://localhost:8002`，刮完音乐。

然后打开任何 Subsonic 客户端，连接服务器。

10 分钟上手，再也不用换工具了。

## 项目地址

https://github.com/xhongc/music-tag-web

**「如果你也觉得刮完能直接听是刚需，Star 一下让更多人知道！」**

太ai了宝...

为啥我刮太阳之子专辑，一个歌词都没刮到啊