macOS 系统本地部署 CVAT 进行数据标注

推荐 macOS 本地部署 CVAT （Computer Vision Annotation Tool）方式：Docker Compose

一. 准备工作

检查系统要求

macOS 10.15 (Catalina) 或更高版本
至少 8GB RAM（推荐 16GB）
至少 20GB 可用磁盘空间
Intel 或 Apple Silicon (M1/M2/M3) 芯片都支持

安装必要工具

bash 复制代码

# 打开终端（Terminal）
# 可以按 Command+空格，搜索 "Terminal"

# 1. 安装 Homebrew（如果还没有）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装完成后，按提示执行：
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

# 验证安装
brew --version

安装 Docker Desktop

bash 复制代码

# 方法A：使用 Homebrew（推荐）
brew install --cask docker

# 方法B：从官网下载
# 访问：https://www.docker.com/products/docker-desktop/
# 下载对应芯片版本（Intel 或 Apple Silicon）

# 安装后启动 Docker Desktop
# 可以在 Applications 中找到并打开
# 或使用命令行：
open /Applications/Docker.app

# 等待 Docker 启动（菜单栏出现鲸鱼图标）

配置 Docker Desktop

点击菜单栏 Docker 图标 → Preferences
在 Resources 选项卡中：
- Memory: 设置为 8GB（如果电脑有16GB）
- CPUs: 设置 4个以上
- Swap: 2GB
在 General 中：
- 勾选 "Start Docker Desktop when you log in"
点击 Apply & Restart

安装 git

bash 复制代码

# 如果还没有 Git
brew install git

# 验证
git --version

二、部署 CVAT

步骤 1：获取 CVAT 代码

bash 复制代码

# 打开终端，选择一个工作目录
cd ~/Desktop  # 或你喜欢的目录

# 克隆 CVAT 仓库
git clone https://github.com/cvat-ai/cvat.git

# 进入目录
cd cvat

当遇到图片上的问题时，使用浅克隆（只下载最新版本）：git clone --depth=1 https://github.com/cvat-ai/cvat.git

步骤 2：使用 Docker Compose 启动

bash 复制代码

# 启动 CVAT 服务
docker compose up -d

# 如果是 Apple Silicon 芯片，可能需要先构建
docker compose build
docker compose up -d

注：等待下载和启动（首次运行需要下载约 3GB 镜像，可能需要10-20分钟）

步骤 3：查看启动状态：docker compose ps

查看 docker images
步骤 4：创建管理员账户

bash 复制代码

# 当所有容器都运行后，创建管理员
docker compose exec cvat_server bash -ic 'python3 ~/manage.py createsuperuser'

# 按提示输入：
# Username: admin
# Email address: admin@example.com
# Password: 设置一个安全的密码
# Password (again): 再次输入

步骤 5：访问 CVAT

打开浏览器（Safari 或 Chrome）
访问：http://localhost:8080
使用刚才创建的账户登录