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

2026-02-07 05:20:57作者：管翌锬

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`	实时查看应用日志