在Azure Container App中部署Cheshire-Cat AI时遇到的网络问题解决方案

Cheshire-Cat AI是一个开源的AI框架，当用户尝试在Azure Container App服务上部署时，可能会遇到文档上传失败并显示"网络错误"的问题。本文将详细分析这一问题的成因及解决方案。

问题现象分析

用户在Azure Container App中部署Cheshire-Cat AI核心镜像后，虽然基础功能如LLM配置和嵌入模型(ChatGPT)可以正常工作，但在尝试上传文档(Markdown或PDF格式)时，系统会返回"网络错误"提示。类似问题也出现在插件管理功能中。

根本原因

经过技术分析，这一问题主要源于HTTPS协议配置不当。Azure Container App默认使用HTTPS协议，而Cheshire-Cat AI需要特定的环境变量配置才能正确处理HTTPS请求。

解决方案

要解决这一问题，需要在容器部署时配置以下关键环境变量：

1. CCAT_CORE_USE_SECURE_PROTOCOLS：设置为"true"，启用安全协议支持
2. CCAT_HTTPS_PROXY_MODE：设置为"true"，启用HTTPS代理模式
3. CCAT_CORS_FORWARDED_ALLOW_IPS：设置为"*"，允许所有跨域请求(生产环境应根据实际情况限制)

这些配置确保了应用能够正确处理HTTPS请求和跨域资源共享(CORS)策略。

持久化存储问题

用户还反馈了另一个常见问题：容器重启后所有数据(文档、API密钥、会话记录)都会丢失。这是由于Azure Container App默认使用临时存储导致的。

建议解决方案：

• 配置Azure存储账户作为持久化存储卷
• 将应用数据目录挂载到持久化存储上
• 或者配置外部数据库连接

最佳实践建议

1. 对于生产环境部署，建议使用Azure Kubernetes服务(AKS)而非Container App，以获得更完善的存储和网络配置选项
2. 定期备份重要数据
3. 监控容器日志以提前发现问题
4. 根据实际需求调整CORS策略，避免过度开放

通过以上配置和优化，用户可以在Azure云环境中稳定运行Cheshire-Cat AI，并充分利用其文档处理和插件功能。