在AWS上部署CVAT时遇到的404问题分析与解决方案

CVAT（Computer Vision Annotation Tool）是一个开源的计算机视觉标注工具，广泛应用于图像和视频标注任务。本文将详细分析在AWS EC2实例上部署CVAT时遇到的404错误问题，并提供完整的解决方案。

问题现象

用户在AWS EC2实例上按照官方文档部署CVAT后，通过浏览器访问公网IP的8080端口时，遇到了"404 page not found"的错误。尽管用户已经正确设置了安全组规则并导出了CVAT_HOST环境变量，问题依然存在。

根本原因分析

通过检查Traefik路由配置，发现问题的根源在于CVAT服务的路由规则被错误地配置为仅响应localhost请求。具体表现为：

Host('localhost') && PathPrefix('/api/', '/static/', '/admin', '/documentation/', '/django-rq')

这种配置意味着服务只接受来自localhost的请求，而拒绝所有外部请求，从而导致404错误。

解决方案

1. 正确设置CVAT_HOST环境变量

确保在启动CVAT容器前正确设置CVAT_HOST环境变量，指向EC2实例的公网IP地址：

export CVAT_HOST=your-ec2-public-ip

2. 重新创建容器

环境变量设置后，需要重新创建CVAT容器以使配置生效：

docker compose up -d

3. 验证配置

使用以下命令验证路由规则是否已更新：

docker inspect --format '{{ index .Config.Labels "traefik.http.routers.cvat.rule"}}' cvat_server

正确配置应显示类似如下内容（包含你的公网IP）：

Host('your-ec2-public-ip') && PathPrefix('/api/', '/static/', '/admin', '/documentation/', '/django-rq')

技术原理

CVAT使用Traefik作为反向代理，负责将外部请求路由到相应的服务。Traefik的路由规则通过容器标签配置，其中关键的是traefik.http.routers.cvat.rule标签。当CVAT_HOST环境变量未正确设置时，系统会默认使用localhost作为主机名，导致外部请求无法匹配路由规则。

最佳实践建议

1. 持久化环境变量：为避免每次重启都需要重新设置，可将CVAT_HOST变量添加到shell配置文件中（如.bashrc或.zshrc）

2. 使用域名：建议配置域名并设置DNS解析，比直接使用IP地址更可靠

3. HTTPS配置：生产环境应考虑配置HTTPS以保障数据传输安全

4. 监控日志：定期检查容器日志，可快速发现并解决问题

docker logs cvat_server
docker logs traefik

总结

在AWS上部署CVAT时遇到404错误通常是由于主机名配置不当导致。通过正确设置CVAT_HOST环境变量并重新创建容器，可以解决此问题。理解Traefik的路由机制有助于快速诊断和解决类似网络访问问题。对于生产环境部署，建议进一步考虑安全性和高可用性方面的配置。