CVAT部署到虚拟机小记

在部署 CVAT 之前，需要先在虚拟机上安装 Docker 和 Docker Compose。
CVAT安装手册：https://docs.cvat.ai/docs/administration/basics/installation/

问题一：docker-compose up -d 启动失败或超时

原因分析：

• 我的笔记本开启了代理，使用的是 代理模式（地址固定为 127.0.0.1:10810）。
• 由于虚拟机的网络流量默认不经过宿主机的本地代理，无论虚拟机是 NAT 模式 还是 桥接模式，都无法访问站点。试过了国内的镜像站也拉不下来。
• 因此，docker-compose up -d 在拉取镜像或访问网络时会超时。

解决方案：

1. 将虚拟机和宿主机配置在同一网段。
2. 将虚拟机的网络流量通过宿主机的 IP 转发到对应端口。
3. 再将宿主机端口的流量转发到本地环回地址 127.0.0.1:10810。
4. 还要修改docker的代理，确保docker能够访问服务器，新建路径下proxy.conf文件

[Service]
Environment="HTTP_PROXY=http://192.168.30.206:10810/"
Environment="HTTPS_PROXY=http://192.168.30.206:10810/"
Environment="NO_PROXY=localhost,127.0.0.1,::1"

下图中的IP我修改过，因为之前公司的网络好像是同一网段下不同ip是不通的，我用自己的手机热点做的测试，后来连了公司的网线，也能用，所以IP就换回来了。

只要这张图中的地址显示的不是国内就ok。

这样虚拟机就可以通过宿主机的代理访问对应网站，从而解决 docker-compose up -d 启动失败的问题。

---

问题二：宿主机无法访问虚拟机上的 CVAT 界面

现象：

• 在虚拟机浏览器输入 localhost:8080 可以打开 CVAT 界面。
• 在宿主机浏览器输入虚拟机 IP 和端口，则无法访问。

原因分析：

• CVAT 的 docker-compose.yml 中默认配置了环境变量 CVAT_HOST: localhost。
• 这会导致 CVAT 仅绑定在虚拟机本地 localhost 上，而不是虚拟机的网卡 IP。

解决方案：

1. 在虚拟机终端中修改环境变量：

export CVAT_HOST=192.168.123.116   # 虚拟机 IP

2. 然后重新启动 CVAT：

docker-compose down
docker-compose up -d

3. 此时，宿主机和虚拟机都可以通过虚拟机 IP + 端口访问 CVAT。

也可以写一个.env文件，否则重启之后，该变量又变回localhost了。

宿主机访问成功界面

---

问题三：挂载宿主机本地文件到 CVAT Docker 容器挂不上去

现象：

• CVAT 界面中可以选择上传本地文件，上传时：

  • 如果在宿主机浏览器打开，上传的是宿主机文件。
  • 如果在虚拟机浏览器打开，上传的是虚拟机文件。

• “挂载到 Docker”选项，无法直接使用。宿主机的文件不能挂载到docker上去。

解决方案：

1. 在虚拟机中创建挂载文件夹，例如：

mkdir -p /mnt/test_cvat

2. 将宿主机的共享文件夹先挂载到虚拟机的 /mnt/test_cvat 目录。
3. 新建或修改 docker-compose.override.yml，修改device： /mnt/share为Linux的挂载目录即可挂载虚拟机目录到 Docker 容器：

然后重启docker，这样 CVAT 容器内就可以访问宿主机上的文件，实现挂载上传。

---

性能疑问

• CVAT 可以在本地浏览器和虚拟机浏览器中打开，上传文件速度基本一致。

• 标注时较卡，可能原因：

  • 虚拟机性能（CPU / 内存 / 磁盘 IO）不足。
  • Docker 容器共享虚拟机资源导致性能瓶颈。

• 建议：

  • 尝试分配更多 CPU / 内存给虚拟机。

---

总结：

1. 虚拟机访问对应服务器需通过宿主机代理或端口转发。
2. 宿主机访问 CVAT 必须修改 CVAT_HOST 为虚拟机 IP。
3. 上传和挂载文件需要虚拟机共享目录，并挂载到 Docker 容器中。