CVAT 镜像使用说明

快速参考

• 维护者：cvat.ai 开发团队
• 获取帮助：Gitter 社区
• 提交问题：GitHub Issues
• 在线试用 CVAT：app.cvat.ai
• 用户指南：***文档

什么是 CVAT？

计算机视觉标注工具（CVAT）是一款免费、在线、交互式的视频和图像标注工具，适用于计算机视觉任务。其后端镜像为 cvat/server。

如何使用此镜像

直接启动 cvat_server 实例

前提：需已运行 Postgres 实例（通过 DB_HOST 访问）和 Redis 服务（通过 REDIS_HOST 访问）。

执行以下命令启动容器：

bash
docker run -p 8080:8080 --name some-cvat-server -e CVAT_POSTGRES_HOST=DB_HOST -e CVAT_REDIS_HOST=REDIS_HOST -d cvat/server
# 创建超级用户（用于登录管理后台）
docker exec -it some-cvat-server bash -ic 'python3 ~/manage.py createsuperuser'

或通过 docker-compose

使用 docker-compose 配置文件可快速运行最新版 CVAT：

bash
# 克隆仓库
git clone [***] cvat
# 启动服务（后台运行）
docker-compose up -d
# 创建超级用户
docker exec -it cvat bash -ic 'python3 ~/manage.py createsuperuser'

暴露端口

容器暴露端口：8080

环境变量

cvat_server 镜像依赖多个环境变量，至少需指定 CVAT_POSTGRES_HOST 和 CVAT_REDIS_HOST。

数据库相关

• CVAT_POSTGRES_HOST：Postgres 数据库主机地址，默认值 cvat_db
• CVAT_POSTGRES_DBNAME：数据库名称，默认值 cvat
• CVAT_POSTGRES_USER：数据库登录用户名，默认值 root
• CVAT_POSTGRES_PASSWORD：数据库登录密码，默认值为空字符串

Redis 相关

• CVAT_REDIS_HOST：Redis 服务主机地址，默认值 cvat_redis

功能开关

• CVAT_SERVERLESS：启用半自动/自动标注功能，传 1 启用，默认值 0
• CVAT_NUCLIO_HOST：配合 CVAT_SERVERLESS 使用，设置 nuclio 仪表板主机名，默认值 nuclio
• CVAT_ANALYTICS：启用 UI 和服务日志转发至外部 Logstash，传 1 启用，默认值 0
• CLAM_AV：启用 ClamAV 扫描上传数据，传 yes 启用，默认值 no

日志与监控

• DJANGO_LOG_SERVER_HOST：配合 CVAT_ANALYTICS 使用，Logstash 主机名，默认值 localhost
• DJANGO_LOG_SERVER_PORT：Logstash 端口，默认值 5000
• DJANGO_LOG_VIEWER_HOST：Kibana 主机名，无默认值
• DJANGO_LOG_VIEWER_PORT：Kibana 端口，无默认值

代理配置

• http_proxy、https_proxy、no_proxy、socks_proxy：用于配置网络代理

CVAT 数据存储位置

容器内所有上传数据默认存储于 /home/django/data。为避免数据丢失，建议将主机目录挂载至该路径：

步骤

1. 在主机创建数据目录（如 /my/cvat_data_dir）
2. 启动容器时挂载该目录：

   bash
   docker run --name cvat-server -v /my/cvat_data_dir:/home/django/data -d cvat/server
   

   （-v /my/cvat_data_dir:/home/django/data 表示将主机 /my/cvat_data_dir 映射到容器内 /home/django/data）

许可信息

***声明：访问、下载或使用本软件及依赖软件（“软件包”）即表示您同意软件包的许可协议条款，包括第三方软件的许可声明。详情见 “third-party-programs.txt” 或类似文件。

查看 软件许可信息。

使用预构建镜像时，用户需自行确保符合所有包含软件的许可要求及潜在费用。本软件使用 FFmpeg 项目库，FFmpeg 基于 LGPL 和 GPL 许可，用户需自行确认使用 FFmpeg 是否需额外许可，CVAT.AI 不负责获取此类许可或承担相关费用。