CVAT 数据标注平台 Docker 快速部署指南-平芜编程栈

CVAT 数据标注平台 Docker 快速部署指南

【免费下载链接】cvatComputer Vision Annotation Tool (CVAT) is a leading platform for building high-quality visual datasets for vision AI. It offers open-source, cloud, and enterprise products, as well as labeling services, for image, video, and 3D annotation with AI-assisted labeling, quality assurance, team collaboration, analytics, and developer APIs.项目地址: https://gitcode.com/GitHub_Trending/cvat/cvat

CVAT（Computer Vision Annotation Tool）是一款开源的计算机视觉数据标注工具，提供 Web 端标注界面、AI 辅助标注、多人协作与数据集导出等能力，免费自托管，适合需要独立部署的算法工程师和数据团队。本文带你用 Docker 把整套标注平台跑起来，从拉代码到登录界面只需几条命令。

CVAT Docker 部署：三步跑起全部服务

先确认环境满足两点：Docker 20.10.0 及以上版本、Docker Compose 1.29.0 及以上版本。内存建议至少 8GB（推荐 16GB），磁盘预留 20GB 以上。用下面两条命令验证：

docker --version docker-compose --version

第二步，克隆仓库并进入目录：

git clone https://gitcode.com/GitHub_Trending/cvat/cvat cd cvat

第三步，一条命令拉起全部服务。CVAT 基于 Docker 容器化部署，这条命令会自动下载镜像并启动后端 API（Django）、React 前端、PostgreSQL 数据库和 Redis 缓存：

docker-compose up -d

上图是 CVAT 的三维标注画布，支持 Top / Side / Front 三视图同步操作，点云数据也能在同一个界面里标注。

启动后首次拉镜像需要 2~5 分钟。随时用下面的命令跟踪各容器状态：

docker-compose logs -f

看到 web 与 worker 日志正常滚动、没有持续报错，就说明服务就绪了。

CVAT 首次登录与管理员账户创建

服务起来之后，第一件事是初始化数据库和账户。在cvat_server容器里执行一次数据库迁移：

docker exec -it cvat_server bash -ic 'python3 manage.py migrate'

接着创建管理员账户，按提示输入用户名、邮箱和密码：

docker exec -it cvat_server bash -ic 'python3 manage.py createsuperuser'

最后打开浏览器访问http://localhost:8080，用刚才创建的账户登录，就能看到 Projects、Tasks、Jobs 三个主入口。至此 CVAT 安装完成，可以开始建项目、上传数据了。

CVAT AI 辅助标注：从逐帧手标到模型预标

人工标注最贵的地方在于重复劳动。CVAT 内置了多种深度学习的模型服务，你在创建任务时可以直接选一个模型（例如人体姿态估计），系统会对上传图片或视频自动产出标注结果，你只做校验和微调。

界面里先选模型，确认自动带出的标签，再上传文件即可触发自动标注。

仓库里的 serverless/ 目录提供了一批可参考的模型部署配置，覆盖 PyTorch、TensorFlow、OpenVINO、ONNX 等运行时，想接入自己的模型时可以直接照着这些示例改。

另一类高频场景是像素级抠图。CVAT 的刷选工具（Brushing Tools）可以像画涂一样圈出前景，再用 AI 边缘算法自动收紧成多边形，比手绘轮廓快得多：

团队协作与质量管控

当标注人员超过两个人，冲突和漏标就开始出现。CVAT 的 quality_control 模块提供交叉标注比对、冲突检测和按任务维度出具质量报告的能力；engine 模块负责任务、作业与权限的核心逻辑，项目可以按角色分配给不同成员并行推进。

标注进度也不再靠口头同步。内置的 Analytics 面板统计对象数量、总工时与平均标注速度，管理者随时能看出谁在瓶颈上：

CVAT 安装常见问题解答

Q：8080 端口被占用怎么办？A：修改 docker-compose.yml 中的端口映射（8080:8080行），把宿主机端口改成空闲值，然后docker-compose up -d重启。

Q：镜像下载很慢或失败？A：给 Docker 配置国内镜像加速器后重试；若只失败在个别组件，单独docker-compose pull拉取该服务再启动。

Q：服务异常，页面打不开？A：先docker-compose logs -f定位报错容器，再执行下面的命令全量重启：

docker-compose down docker-compose up -d

Q：Docker 命令提示权限不足？A：把当前用户加入docker用户组后重新登录，或临时使用sudo执行。

下一步建议

创建一个任务，上传一批图片或视频，走一遍从标注到数据集导出的完整流程，dataset_manager 目录列出了所有受支持的导出格式。
在 Models 页面注册一个 AI 模型，用自动标注验证预标效果。
拉上至少一位同事，体验多人并发标注与质量报告。
更多配置与进阶用法（云存储、认证、Serverless 模型服务），查阅 site/content/en/ 下的官方文档。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

CVAT 数据标注平台 Docker 快速部署指南