环境搭建：CVAT的在线版本注册与使用、Docker部署CVAT本地环境

说实话，很多新手在CVAT面前栽的第一个跟头，不是标注操作，而是环境没搭起来。我见过太多人卡在Docker启动这一步，然后跑来问我：「老师，我明明按步骤来了，为什么就是跑不起来？」

嗯，别急。这一章我带你把环境彻底搞定。咱们分两条路走：一条是懒人路线——直接用在线版；另一条是硬核路线——自己用Docker部署本地环境。我个人建议，如果你只是临时用用，在线版足够了。但如果你要处理敏感数据，或者团队协作频繁，本地部署才是正道。

一、在线版本：注册即用，零门槛

CVAT官方提供了一个在线版本，地址是 app.cvat.ai。说白了，这就是一个SaaS服务，你注册个账号就能直接用。

注册流程很简单：

1. 打开浏览器，访问 app.cvat.ai
2. 点击右上角的「Sign Up」按钮
3. 输入邮箱、用户名、密码
4. 去邮箱里点一下验证链接
5. 登录，完事

我在项目中遇到过一种情况：团队里有人注册后收不到验证邮件。后来发现是公司邮箱把CVAT的邮件当成垃圾邮件了。所以，如果你也遇到这个问题，去垃圾箱里翻翻看。

二、Docker部署：本地环境搭建

如果你选择本地部署，那Docker就是绕不开的工具。为什么用Docker？因为CVAT依赖的服务太多了——PostgreSQL、Redis、Nginx、还有一堆Python库。手动装一遍，我保证你会崩溃。Docker把这些都打包好了，一条命令就能启动。

2.1 系统要求与配置检查

先看看你的电脑够不够格。我踩过这个坑：一开始用一台4GB内存的老笔记本跑，结果Docker直接卡死。

组件	最低要求	推荐配置
CPU	2核	4核及以上
内存	8GB	16GB
磁盘空间	20GB	50GB（SSD更佳）
操作系统	Linux / macOS / Windows	Ubuntu 20.04+ 或 Windows 10 Pro
Docker版本	20.10+	最新稳定版

你想想看，如果你的机器连最低要求都达不到，那部署起来会很痛苦。我曾经在一台8GB内存的笔记本上跑CVAT，同时还要开浏览器和IDE，结果内存直接飙到95%。后来我加了一条内存条，世界清净了。

2.2 安装Docker和Docker Compose

如果你还没装Docker，先去官网下载安装。Windows用户记得开启WSL2，macOS用户直接用Docker Desktop就行。Linux用户一条命令搞定：

# Ubuntu/Debian
sudo apt update
sudo apt install docker.io docker-compose -y

# 启动Docker服务
sudo systemctl start docker
sudo systemctl enable docker

# 验证安装
docker --version
docker-compose --version

嗯，这里要注意：Windows用户如果用的是Docker Desktop，记得在设置里把资源调高一点。默认的2核4GB跑CVAT会有点吃力。

2.3 克隆CVAT源码并启动

CVAT的官方仓库里包含了完整的Docker配置。我们直接克隆下来：

git clone https://github.com/opencv/cvat
cd cvat

然后，用Docker Compose启动所有服务：

docker-compose up -d

这条命令会拉取镜像、创建容器、启动服务。第一次运行会下载很多东西，大概需要5-10分钟，取决于你的网速。我建议你泡杯咖啡，慢慢等。

启动成功后，你会看到类似这样的输出：

Creating cvat_db ... done
Creating cvat_redis ... done
Creating cvat_server ... done
Creating cvat_worker_export ... done
Creating cvat_worker_import ... done
Creating cvat_ui ... done

看到这些「done」就说明服务都起来了。这时候打开浏览器，访问 http://localhost:8080，就能看到CVAT的登录页面了。

2.4 首次启动与登录

第一次登录，你需要创建一个管理员账号。CVAT提供了一个命令行工具来创建：

docker exec -it cvat_server bash -c "python manage.py createsuperuser"

然后按提示输入用户名、邮箱、密码。我习惯用 admin 作为用户名，密码设一个复杂点的，毕竟这是生产环境。

创建完成后，回到浏览器，用刚才的账号登录。你会看到CVAT的主界面——一个干净的任务列表页面。嗯，到这里，环境搭建就算完成了。

三、知识体系总览

为了让你对整个环境搭建流程有个全局认识，我画了一张图。你看一眼就明白了：

这张图把两条路线都梳理清楚了。左边是在线版，三步搞定；右边是本地版，稍微复杂一点，但每一步都很清晰。你跟着走就行。

---