WeKnora终极部署指南：10分钟快速搭建AI知识服务平台

WeKnora作为一款基于大语言模型的AI框架，为深度文档理解、语义检索和上下文感知回答提供了强大支持。本指南将带您快速完成WeKnora的Docker容器化部署，实现从零到一的完整搭建过程。

🚀 快速启动：10分钟完成WeKnora部署

第一步：获取项目代码

git clone https://gitcode.com/GitHub_Trending/we/WeKnora
cd WeKnora

第二步：配置环境参数

复制环境配置文件并进行必要修改：

cp .env.example .env

关键配置项说明：

• DB_DRIVER：数据库类型选择
• STORAGE_TYPE：存储服务配置
• OLLAMA_BASE_URL：本地LLM服务地址
• APP_PORT：后端API服务端口
• FRONTEND_PORT：前端界面访问端口

第三步：一键启动服务

使用项目提供的自动化脚本启动所有组件：

./scripts/start_all.sh

启动成功后，您可以通过以下地址访问服务：

• 前端界面：http://localhost:80
• API接口：http://localhost:8080
• 监控面板：http://localhost:16686

📋 环境检查清单

在开始部署前，请确保您的环境满足以下要求：

✅ 系统要求

• Docker 20.10+
• Docker Compose 2.0+
• 4GB可用内存
• 20GB磁盘空间

✅ 网络要求

• 可访问Docker Hub拉取镜像
• 如需离线部署，请提前下载镜像

✅ 端口占用检查 确保以下端口未被占用：

• 80（前端）
• 8080（API）
• 5432（数据库）
• 6379（缓存）

🛠️ 组件详解：WeKnora微服务架构

WeKnora采用现代化的微服务架构，各个组件分工明确，共同构成完整的AI服务平台。

核心服务组件

主应用服务（app）

• 承担所有业务逻辑处理
• 提供RESTful API接口
• 负责文档解析和向量化处理

前端界面（frontend）

• 基于Vue.js的现代化Web界面
• 提供直观的知识库管理功能
• 支持实时对话交互

数据存储层

• PostgreSQL：关系型数据存储
• Redis：缓存和会话管理
• MinIO：文件对象存储
• Neo4j：知识图谱存储

⚙️ 配置指南：多环境适配方案

开发环境配置

对于开发调试，建议使用以下配置：

# docker-compose.dev.yml
services:
  app:
    volumes:
      - ./:/app
    environment:
      - GIN_MODE=debug

生产环境优化

生产部署需要考虑性能和稳定性：

services:
  app:
    deploy:
      resources:
        limits:
          cpus: '2'
          memory: 4G

离线环境部署

在网络受限环境中，可提前准备：

# 保存镜像到本地
docker save wechatopenai/weknora-app:latest > weknora-app.tar
docker save wechatopenai/weknora-ui:latest > weknora-ui.tar

# 离线环境加载
docker load < weknora-app.tar
docker load < weknora-ui.tar

# 启动服务（不拉取镜像）
./scripts/start_all.sh --no-pull

🔧 故障排除：常见问题速查手册

服务启动失败排查

检查容器日志定位问题：

docker-compose logs -f app

常见解决方案：

• 端口冲突：修改.env文件中的端口配置
• 依赖服务未就绪：等待或手动启动依赖服务
• 镜像拉取失败：检查网络或使用离线镜像

数据库连接问题

验证数据库服务状态：

docker-compose exec postgres psql -U $DB_USER -d $DB_NAME

文件上传异常

检查存储服务配置：

# 验证MinIO服务
docker-compose exec minio mc admin info local

💡 进阶技巧：性能优化与监控

性能调优建议

• 增加应用实例数量提升并发能力
• 优化数据库查询和索引配置
• 合理配置缓存策略减少IO压力

系统监控集成

配置Prometheus和Grafana实现全面监控：

# 监控服务配置示例
prometheus:
  image: prom/prometheus
  ports: ["9090:9090"]

grafana:
  image: grafana/grafana
  ports: ["3000:3000"]

📚 资源汇总：常用命令与文档链接

核心操作命令

命令	功能描述
./scripts/start_all.sh	启动所有服务
./scripts/start_all.sh -s	停止所有服务
./scripts/start_all.sh -c	环境检查和诊断
docker-compose ps	查看容器运行状态
docker-compose logs -f app	实时查看应用日志

重要文档资源

• 配置目录：config/
• 部署脚本：scripts/
• 官方文档：docs/
• 知识库配置：docs/KnowledgeGraph.md

通过本指南，您已经掌握了WeKnora的完整部署流程。无论是个人学习还是企业级应用，这套容器化方案都能为您提供稳定可靠的服务基础。随着业务发展，您可以根据实际需求进一步扩展和优化系统架构。