实践分享 | 使用基石智算 DeepSeek 服务自建 OpenDeepWiki

OpenDeepWiki 是一款 AI 驱动的代码知识库平台，作为 DeepWiki 开源替代方案，能助力团队成员快速洞悉项目结构与实现原理。它能自动剖析代码仓库，生成可视化文档，涵盖详细解释、流程图、架构图等内容，还会自动修复 Mermaid 图表语法，确保可视化内容精准呈现。

OpenDeepWiki 适用场景广泛。对新成员，可提供快速上手文档；对维护者，能梳理项目逻辑；对开发团队，可提供智能化代码洞见。开发者和技术文档编写者等通过它，能实现代码级到架构级多层次文档与图表需求。

获取 API 密钥和域名

部署 OpenDeepWiki

前期准备

部署步骤

services:
  koalawiki:
    image:crpi-j9ha7sxwhatgtvj4.cn-shenzhen.personal.cr.aliyuncs.com/koala-ai/koala-wiki
    environment:
      -KOALAWIKI_REPOSITORIES=/repositories
      -TASK_MAX_SIZE_PER_USER=5# 每个用户AI处理文档生成的最大数量，遇到429限流时可调整为1
      -REPAIR_MERMAID=1# 是否进行Mermaid修复，1修复，其余不修复
      -CHAT_MODEL=DeepSeek-V3# 必须要支持function的模型
      -ANALYSIS_MODEL=DeepSeek-V3# 分析模型，用于生成仓库目录结构，模型越强，生成的目录结构越好
      -CHAT_API_KEY=您的APIkey
      -ENDPOINT=https://openapi.coreshub.cn/v1
      -DB_TYPE=sqlite
      -DB_CONNECTION_STRING=DataSource=/data/KoalaWiki.db
      -EnableSmartFilter=true# 是否启用智能过滤，可能影响AI获取仓库文件目录的能力
    volumes:
      -./repositories:/app/repositories
      -./data:/data
      
koalawiki-web:
    image:crpi-j9ha7sxwhatgtvj4.cn-shenzhen.personal.cr.aliyuncs.com/koala-ai/koala-wiki-web
    environment:
      -NEXT_PUBLIC_API_URL=http://koalawiki:8080# 提供给server的地址
      
nginx:# 将前端和后端代理到同一端口
    image:crpi-j9ha7sxwhatgtvj4.cn-shenzhen.personal.cr.aliyuncs.com/koala-ai/nginx:alpine
    ports:
      -8090:80
    volumes:
      -./nginx/nginx.conf:/etc/nginx/conf.d/default.conf
    depends_on:
      -koalawiki
      -koalawiki-web

mkdir -p nginx

server {
    listen 80;
    server_name localhost;

    # 日志配置
    access_log var/log/nginx/access.log;
    error_log var/log/nginx/error.log;

    # 代理所有 api/ 请求到后端服务
    location api/ {
        proxy_pass http://koalawiki:8080/api/;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_cache_bypass $http_upgrade;
    }

    # 其他所有请求转发到前端服务
    location  {
        proxy_pass http://koalawiki-web:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_cache_bypass $http_upgrade;
    }
}

# 拉取镜像
docker-compose pull

# 启动服务
docker-compose up -d

将项目添加到 OpenDeepWiki

更多福利，速来体验

扫码立即体验

咨询售前专家

点击下方“阅读原文”开启您的体验之旅！