跳转到主要内容

​
快速修复

​
”我无法访问 Web 界面”

  1. 检查容器是否正在运行：
docker ps | grep kodus-web-prod
  1. 验证端口是否正确映射：
docker port kodus-web-prod
  1. 检查 Web 容器日志：
docker logs kodus-web-prod

​
“Git Webhook 不工作”

  1. 验证您的域名设置：
curl -I https://your-domain.com
  1. 检查编排器日志中的 webhook 尝试：
docker logs kodus-orchestrator-prod | grep webhook
  1. 验证您的反向代理配置：
sudo nginx -t

​
“数据库连接问题”

  1. 检查数据库容器状态：
docker ps | grep db_kodus_postgres
docker ps | grep db_kodus_mongodb
  1. 验证数据库日志：
docker logs db_kodus_postgres
docker logs db_kodus_mongodb
  1. 测试数据库连接：
docker exec -it db_kodus_postgres psql -U $API_PG_DB_USERNAME -d $API_PG_DB_DATABASE
docker exec -it db_kodus_mongodb mongosh -u $API_MG_DB_USERNAME -p $API_MG_DB_PASSWORD

​
“由于缺少向量类型导致迁移失败”

如果在迁移期间遇到错误 “type vector does not exist”，这是因为您的 PostgreSQL 数据库中未启用 pgvector 扩展。以下是修复方法：
  1. 连接到您的 PostgreSQL 数据库：
docker exec -it db_kodus_postgres psql -U $API_PG_DB_USERNAME -d $API_PG_DB_DATABASE
  1. 启用 pgvector 扩展：
CREATE EXTENSION IF NOT EXISTS vector;
  1. 启用扩展后，再次尝试运行迁移：
docker exec -it kodus-api-prod npm run migration:run
如果您仍然遇到问题，可以验证扩展是否已正确安装： 
SELECT * FROM pg_extension WHERE extname = 'vector';

​
常见问题

​
RabbitMQ 问题

如果您看到消息队列错误：
  1. 检查 RabbitMQ 状态：
docker logs rabbitmq-prod
  1. 访问 http://localhost:15672 的管理控制台以验证队列和连接
  2. 如果需要，重启服务： 
docker restart rabbitmq-prod

​
资源问题

如果服务缓慢或崩溃：
  1. 检查资源使用情况：
docker stats
  1. 验证容器限制：
docker inspect kodus-orchestrator-prod | grep -A 5 "Resources"
  1. 如果需要，在 docker-compose.yml 中调整资源限制

​
获取帮助

​
支持请求中应包含的内容

  • 确切的错误消息
  • 受影响服务的相关日志
  • 您的部署方法（CLI、VM 等）
  • 重现问题的步骤

​
在哪里获取帮助