OpenCV/CVAT 图像标注工具安装指南-优快云博客

OpenCV/CVAT 图像标注工具安装指南

cvat Annotate better with CVAT, the industry-leading data engine for machine learning. Used and trusted by teams at any scale, for data of any scale. 项目地址: https://gitcode.com/gh_mirrors/cv/cvat

前言

CVAT (Computer Vision Annotation Tool) 是由OpenCV团队开发的一款开源的图像和视频标注工具，广泛应用于计算机视觉领域的数据标注工作。本文将详细介绍CVAT在不同操作系统下的安装方法，帮助用户快速搭建本地标注环境。

系统要求

在开始安装前，请确保您的系统满足以下基本要求：

支持的操作系统：Ubuntu 20.04/22.04、Windows 10/11、macOS Mojave及以上版本
至少4GB内存（推荐8GB以上）
10GB以上可用磁盘空间
稳定的网络连接

Ubuntu系统安装

1. 安装Docker和Docker Compose

# 更新软件包列表
sudo apt-get update

# 安装必要的依赖包
sudo apt-get --no-install-recommends install -y \
    apt-transport-https \
    ca-certificates \
    curl \
    gnupg-agent \
    software-properties-common

# 添加Docker官方GPG密钥
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -

# 添加Docker仓库
sudo add-apt-repository \
    "deb [arch=amd64] https://download.docker.com/linux/ubuntu \
    $(lsb_release -cs) \
    stable"

# 安装Docker引擎
sudo apt-get update
sudo apt-get --no-install-recommends install -y \
    docker-ce docker-ce-cli containerd.io docker-compose-plugin

2. 配置Docker用户组（可选）

# 创建docker用户组
sudo groupadd docker

# 将当前用户加入docker组
sudo usermod -aG docker $USER

# 重新登录使配置生效

3. 获取CVAT源代码

git clone https://github.com/cvat-ai/cvat
cd cvat

4. 启动CVAT服务

# 设置主机环境变量（如需远程访问）
export CVAT_HOST=your_ip_or_domain

# 启动容器
docker compose up -d

5. 创建管理员账户

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

6. 安装Chrome浏览器

# 添加Google Chrome仓库
curl https://dl-ssl.google.com/linux/linux_signing_key.pub | sudo apt-key add -
sudo sh -c 'echo "deb [arch=amd64] http://dl.google.com/linux/chrome/deb/ stable main" >> /etc/apt/sources.list.d/google-chrome.list'

# 安装Chrome
sudo apt-get update
sudo apt-get --no-install-recommends install -y google-chrome-stable

Windows系统安装

1. 安装WSL2

以管理员身份打开PowerShell

运行以下命令启用WSL功能：

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

重启计算机
下载并安装WSL2内核更新包
设置WSL2为默认版本：
```
wsl --set-default-version 2
```

2. 安装Linux发行版

从Microsoft Store安装Ubuntu 20.04 LTS
启动Ubuntu并完成初始设置

3. 安装Docker Desktop

下载Docker Desktop for Windows安装包
运行安装程序并按照向导完成安装
在设置中启用WSL2集成

4. 获取CVAT源代码

在WSL终端中执行：

git clone https://github.com/cvat-ai/cvat
cd cvat

5. 启动CVAT服务

docker compose up -d

6. 创建管理员账户

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

macOS系统安装

1. 安装Docker Desktop

下载Docker.dmg安装包
双击安装包并将Docker图标拖到Applications文件夹
启动Docker应用并完成初始配置

2. 安装Git

# 检查是否已安装Git
git --version

# 如果未安装，会自动提示安装Xcode命令行工具

3. 获取CVAT源代码

git clone https://github.com/cvat-ai/cvat
cd cvat

4. 启动CVAT服务

docker compose up -d

5. 创建管理员账户

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

高级配置

健康检查

docker exec -t cvat_server python manage.py health_check

网络设置

在~/.docker/config.json中添加网络配置：

{
  "network": {
    "default": {
      "httpServer": "http://network_server:port",
      "httpsServer": "http://network_server:port",
      "excludeDomains": "*.example.com,.example.org"
    }
  }
}

共享存储配置

创建docker-compose.override.yml文件：

services:
  cvat_server:
    volumes:
      - cvat_share:/home/django/share:ro
  # 其他服务配置...

volumes:
  cvat_share:
    driver_opts:
      type: none
      device: /path/to/your/share
      o: bind