CVAT标注工具部署指南:5分钟从零到可访问
2026/9/10 10:55:57 网站建设 项目流程

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
Docker20.10.0 或更高
Docker Compose1.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 downdocker-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),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询