suitux/Tagr

这是什么？

核心功能

• 01编辑 40 多个元数据字段，包括自定义标签和专辑封面
• 02完整的修改历史，支持单条或批量撤销
• 03内置带波形显示的播放器，支持收听记录和 ListenBrainz 同步
• 04三栏式曲库浏览，支持筛选、排序和自定义列
• 05基于角色的用户权限（管理员、编辑者、听众）
• 06适配手机和平板的响应式界面

适用场景

• 整理和统一大型个人音乐库的标签
• 通过浏览器编辑部署在 NAS 上的曲库元数据
• 查看并撤销过去的标签修改
• 为家人创建 Listener 账户，只允许浏览和播放

快速上手

1. 1

   下载 docker-compose.yml 文件

   wget https://raw.githubusercontent.com/suitux/Tagr/main/docker-compose.yml
2. 2

   生成密钥，并在 docker-compose.yml 中设置密钥、管理员账户和音乐目录

   openssl rand -hex 32
3. 3

   构建并运行容器

   docker compose up -d
4. 4

   打开 http://localhost:3000，登录并扫描音乐库

使用前须知

• !需要自行托管服务器，并手动配置环境变量和存储卷。
• !采用 AGPL-3.0 许可证，这是一种强制开源的 Copyleft 许可证，修改后通过网络提供服务同样适用。

收录于专题

标签

常见问题

Tagr 是什么？

自托管的网页应用，用于浏览、播放和编辑音频文件标签，修改会直接写回音乐文件。 Tagr 是一个在浏览器中使用的自托管音乐元数据编辑器。指定一个或多个音乐目录后，它会将曲库索引到由文件夹树、歌曲列表和详情编辑区组成的三栏界面中。用户可以编辑 40 多个标签字段，包括自定义标签、专辑封面、星级评分、曲目和碟片编号，修改会直接写回磁盘上的音频文件。

Tagr 可以免费使用吗？用的什么许可证？

Tagr 以 AGPL-3.0 许可证开源。用于商业产品前，请先确认许可证条款。

Tagr 还在维护吗？

活跃维护中。Tagr 最近一次提交是在 2026年10月28日。

Tagr 适合用来做什么？

整理和统一大型个人音乐库的标签 通过浏览器编辑部署在 NAS 上的曲库元数据 查看并撤销过去的标签修改 为家人创建 Listener 账户，只允许浏览和播放

Tagr 怎么安装和运行？

下载 docker-compose.yml 文件: wget https://raw.githubusercontent.com/suitux/Tagr/main/docker-compose.yml 生成密钥，并在 docker-compose.yml 中设置密钥、管理员账户和音乐目录: openssl rand -hex 32 构建并运行容器: docker compose up -d 打开 http://localhost:3000，登录并扫描音乐库

在哪里获取 Tagr？

源代码和安装说明在 GitHub 上：https://github.com/suitux/Tagr