CloudTag 是一个面向个人音乐库的 Web 音乐标签管理工具。
支持音乐文件浏览、标签编辑、封面管理、歌词管理、音乐信息抓取以及内置音乐播放器等功能。
支持电脑、手机和平板浏览器访问，也适合部署在 Synology NAS、Linux 服务器以及其他 Docker 环境中。
Docker Hub：
tomcullen92/cloudtag
可用版本：
CloudTag 不同版本的容器内部端口有所变化。
| 版本 | CloudTag 容器内部端口 | 版本定位 |
|---|---|---|
| 1.0 | 8000 | 早期 CloudTag |
| 2.0 | 8000 | CloudTag 2.x |
| 3.0 | 5100 | CloudTag + LX Music 一体版 |
| 3.5 | 5100 | CloudTag 独立版 |
CloudTag 1.0 和 2.0 的容器内部端口为：
8000
从 CloudTag 3.0 开始，内部端口统一修改为：
5100
因此，如果以前使用 CloudTag 1.0 / 2.0，请特别注意 Docker 端口映射的变化。
旧版本：
宿主机端口:8000
3.0 / 3.5：
宿主机端口:5100
CloudTag 1.0 为早期版本。
8000
docker pull tomcullen92/cloudtag:1.0
docker run -d
--name cloudtag-1.0
--restart unless-stopped
-p 18000:8000
-v /你的音乐目录:/music
tomcullen92/cloudtag:1.0
访问：
http://你的NAS_IP:18000
CloudTag 2.0 使用的容器内部端口仍然是：
8000
docker pull tomcullen92/cloudtag:2.0
docker run -d
--name cloudtag-2.0
--restart unless-stopped
-p 18000:8000
-v /你的音乐目录:/music
tomcullen92/cloudtag:2.0
访问：
http://你的NAS_IP:18000
CloudTag 3.0 是 CloudTag 与 LX Music Server 的一体化版本。
一个 Docker 容器中同时包含：
因此 3.0 适合希望在一个 Docker 容器中同时运行 CloudTag 和 LX Music 的用户。
从 3.0 开始，CloudTag 内部端口改为：
5100
docker pull tomcullen92/cloudtag:3.0
docker run -d
--name cloudtag-3.0
--restart unless-stopped
-p 18196:5100
-v /你的音乐目录:/music
tomcullen92/cloudtag:3.0
访问：
http://你的NAS_IP:18196
CloudTag 3.5 是 CloudTag 的独立版本。
3.5 在 3.0 的 CloudTag 环境基础上制作。
主要变化：
移除 LX Music Server，只保留 CloudTag。
CloudTag 3.5 保留 CloudTag 本身的运行环境和功能，包括：
这些运行环境已经包含在 Docker 镜像中。
普通用户不需要在宿主机上另外安装 Python、FastAPI、Uvicorn、Mutagen 或 FFmpeg。
CloudTag 3.5 不再包含：
同时 CloudTag 首页中的“落雪音乐”入口已经移除。
因此：
CloudTag 3.5 启动后只运行 CloudTag。
首先拉取镜像：
docker pull tomcullen92/cloudtag:3.5
例如 Synology NAS 的音乐目录：
/volume4/硬盘3/LXMusic/music
映射到容器：
/music
运行：
docker run -d
--name cloudtag-3.5
--restart unless-stopped
-p 18196:5100
-v /volume4/硬盘3/LXMusic/music:/music
tomcullen92/cloudtag:3.5
CloudTag 3.5 容器内部端口：
5100
推荐映射：
18196:5100
含义：
宿主机 18196 ↓ 容器 5100
访问：
http://你的NAS_IP:18196
例如：
CloudTag 使用 Docker Volume 映射音乐目录。
例如：
群晖 NAS： /volume4/硬盘3/LXMusic/music
↓
Docker
↓
CloudTag 容器： /music
Docker 参数：
-v /volume4/硬盘3/LXMusic/music:/music
音乐文件仍然保存在 NAS 主机上。
删除 Docker 容器不会自动删除通过 Volume 映射的宿主机音乐文件。
如果使用 Synology Container Manager，可以按照以下方式创建容器。
tomcullen92/cloudtag:3.5
本地端口：18196 容器端口：5100 协议：TCP
本地文件夹：
/volume4/硬盘3/LXMusic/music
容器装载路径：
/music
建议开启：
自动重新启动
CloudTag + LX Music Server
3.0 是一体化版本。
镜像：
tomcullen92/cloudtag:3.0
内部端口：
5100
CloudTag
3.5 是独立 CloudTag 版本。
LX Music 已经从镜像中移除。
镜像：
tomcullen92/cloudtag:3.5
内部端口：
5100
可以同时运行。
但是两个容器必须使用不同的宿主机端口。
例如：
CloudTag 3.0 宿主机：18196 容器：5100
CloudTag 3.5 宿主机：18197 容器：5100
CloudTag 3.0：
docker run -d
--name cloudtag-3.0
--restart unless-stopped
-p 18196:5100
-v /你的音乐目录:/music
tomcullen92/cloudtag:3.0
CloudTag 3.5：
docker run -d
--name cloudtag-3.5
--restart unless-stopped
-p 18197:5100
-v /你的音乐目录:/music
tomcullen92/cloudtag:3.5
两个容器都使用内部端口 5100，但宿主机端口不同，因此可以同时运行。
如果以前使用 CloudTag 1.0 或 2.0，需要特别注意端口变化。
CloudTag 1.0：
容器内部端口：8000
CloudTag 2.0：
容器内部端口：8000
CloudTag 3.0：
容器内部端口：5100
CloudTag 3.5：
容器内部端口：5100
因此：
旧版本：
-p 18000:8000
3.x：
-p 18000:5100
不要把 CloudTag 3.x 继续按照旧版本使用 :8000。
CloudTag 使用 Web 界面。
手机、平板和电脑都可以通过浏览器访问。
例如：
http://你的NAS_IP:18196
在局域网环境下，不需要在手机上安装额外客户端。
如果需要从互联网访问 CloudTag，建议使用：
不建议直接将未经安全配置的管理后台暴露到公网。
docker ps
docker logs cloudtag-3.5
docker logs -f cloudtag-3.5
docker stop cloudtag-3.5
docker start cloudtag-3.5
docker restart cloudtag-3.5
docker rm -f cloudtag-3.5
注意：
删除 Docker 容器不会自动删除通过 -v 映射到宿主机的音乐目录。
拉取最新镜像：
docker pull tomcullen92/cloudtag:3.5
如果需要重新创建容器：
docker stop cloudtag-3.5 docker rm cloudtag-3.5
然后重新创建：
docker run -d
--name cloudtag-3.5
--restart unless-stopped
-p 18196:5100
-v /volume4/硬盘3/LXMusic/music:/music
tomcullen92/cloudtag:3.5
| 项目 | 1.0 | 2.0 | 3.0 | 3.5 |
|---|---|---|---|---|
| CloudTag | ✓ | ✓ | ✓ | ✓ |
| 容器内部端口 | 8000 | 8000 | 5100 | 5100 |
| LX Music | - | - | ✓ | - |
| CloudTag 独立版 | ✓ | ✓ | - | ✓ |
| FFmpeg | 依版本 | 依版本 | ✓ | ✓ |
| 内置播放器 | ✓ | ✓ | ✓ | ✓ |
| 手机 Web 访问 | ✓ | ✓ | ✓ | ✓ |
| Docker 部署 | ✓ | ✓ | ✓ | ✓ |
使用：
tomcullen92/cloudtag:3.0
内部端口：
5100
使用：
tomcullen92/cloudtag:3.5
内部端口：
5100
CloudTag 1.0：
tomcullen92/cloudtag:1.0
内部端口：
8000
CloudTag 2.0：
tomcullen92/cloudtag:2.0
内部端口：
8000
CloudTag 1.0 内部端口：8000
↓
CloudTag 2.0 内部端口：8000
↓
CloudTag 3.0 内部端口：5100
↓
CloudTag 3.5 内部端口：5100
从 CloudTag 3.0 开始，内部端口正式从 8000 修改为 5100。
services: cloudtag: image: tomcullen92/cloudtag:3.5 container_name: cloudtag-3.5 restart: unless-stopped
ports:
- "18196:5100"
volumes:
- ./config:/config
- ./data:/data
- ./music:/music
name: cloudtag
services: cloudtag: image: tomcullen92/cloudtag:3.0 container_name: cloudtag restart: unless-stopped
ports:
# CloudTag
- "18196:5100"
# LX Music Server
# 外部 5200 → 容器内部 5200
- "5200:5200"
volumes:
# CloudTag / LX Server 持久化数据
- ./data:/data
# CloudTag 音乐目录
- ./music:/music
# LX Music Server 使用同一套音乐目录
- ./music:/app/lxserver/music
environment:
# 时区
TZ: Asia/Shanghai
init: true
Content type
Image
Digest
sha256:e02e5c834…
Size
414.9 MB
Last updated
29 days ago
docker pull tomcullen92/cloudtag:4.0