CVAT标注工具部署指南:5分钟从零到可访问
【免费下载链接】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)是一个开源的视觉数据集构建平台,支持图像、视频与3D点云标注、AI辅助标注和质量管理。跟完下面的流程,你会在5分钟内让一台CVAT实例跑在本地,并能创建第一个标注任务、邀请团队协作。
📦 动手之前:自检环境与依赖
| 项目 | 要求 |
|---|---|
| 操作系统 | Ubuntu 20.04 / 22.04、CentOS 7/8 等主流 Linux |
| Docker | 20.10.0 或更高 |
| Docker Compose | 1.29.0 或更高 |
| 内存 | 至少 8GB(建议 16GB) |
| 磁盘 | 预留 20GB 以上空间 |
先做自检再动手:
docker --version docker compose version第一条命令会打印 Docker 引擎版本,第二条会显示 Compose 插件版本。都达到表格要求就可以继续,否则先升级。
🚀 部署全记录:从克隆到访问
先拉取源码:
git clone https://gitcode.com/GitHub_Trending/cvat/cvat cd cvat第一条命令会克隆 CVAT 仓库,第二条会进入项目目录。后续命令都在这个目录执行。
然后启动服务:
docker-compose up -d这条命令会按 docker-compose.yml 拉取全部组件的镜像,后台启动所有容器。首次运行要下载镜像,耐心等它完成。
启动后可以实时跟踪初始化进度:
docker-compose logs -f这条命令会持续滚动输出各容器日志。首次启动一般需要 2-5 分钟,看到 cvat_server 日志里出现服务就绪的信息,就说明部署完成了。
启动后涉及的核心组件:
- cvat_server:后端 API,基于 Django
- cvat_ui:前端界面,基于 React
- cvat_worker:处理导入导出、统计等重任务的后台工作者
- postgres:数据存储,PostgreSQL 15
- redis:任务队列与缓存,Redis 7
- kvrocks:Redis 兼容的分布式缓存
- traefik:HTTP 路由网关
🔐 登录后第一站:初始化与验证
建表和创建管理员账号都在容器内完成。
先确认数据库迁移:
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,用刚设置的凭据登录。→ 应看到:任务列表页,首次部署时列表为空。
🧩 能力速览:核心功能与AI辅助
多形状与属性标注
2D 画布支持矩形、多边形、折线、点、刷选等工具;开启 track 模式后,标注会沿视频帧自动延续。每个目标还能挂属性,例如对 FACE 逐一填写性别、年龄段、是否戴眼镜这类离散值:
CVAT属性标注模式:为FACE目标填写性别、年龄、眼镜属性
AI自动标注
内置模型库包含 YOLO 系列检测模型和 Human pose estimation(人体姿态估计)模型。用法是先选模型,把模型输出的标签映射到任务标签,设定置信度阈值,点击 Annotate 批量处理。模型的调用入口在 serverless/ 目录:
3D点云标注
除图像和视频外,CVAT 也支持激光雷达点云任务。3D 画布按 Top/Side/Front 三个视图渲染点云,放置的 cuboid(立方体框)会同步投影到三个视图,方便核对:
🛠️ 排错手册:常见问题速查
症状:浏览器访问 8080 提示拒绝连接,或提示端口被占用。可能原因:其他服务占用了 8080,或容器还没完成启动。解法:修改 docker-compose.yml 中 cvat_server 的端口映射,再用docker-compose down和docker-compose up -d重启。
症状:运行命令时出现 permission denied,连不上 Docker daemon。可能原因:当前用户不在 docker 组内。解法:执行sudo usermod -aG docker $USER后重新登录生效,或者临时加 sudo 执行。
症状:启动时镜像拉取很慢或超时中断。可能原因:到镜像仓库的网络质量差。解法:为 Docker daemon 配置国内镜像源并重启 Docker,再重新执行docker-compose up -d。
🤝 进阶与协作
上手之后,可以往这几个方向延伸:
- 组织与角色:创建 organization 划分成员权限,按项目分配任务归属。
- 质量控制:cvat/apps/quality_control/ 模块提供质量报告,两人独立标注同一任务后可生成对比结果,快速定位分歧。
- 进度统计:analytics 模块按任务汇总对象数量、总工时和标注速度,结果可导出:
✅ 结语与行动清单
部署完成后,按顺序完成这份清单:
- ✅ 建一个任务,上传一个图片 zip 包或短视频
- ✅ 选一个内置检测模型,跑通第一次自动标注
- ✅ 把标注导出为 COCO 或 VOC 格式
- ✅ 建一个组织,邀请同事做双人标注对比
- ✅ 打开一次质量报告或 analytics 统计页
想继续深入标注操作、快捷键与术语,可以从官方文档 site/content/en/docs/getting_started/ 开始读起。
【免费下载链接】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
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考