DeepWiki-Open部署指南：Docker与手动安装方案全对比

你还在为开源项目文档整理烦恼？DeepWiki-Open让AI帮你自动生成知识库，本文对比两种部署方案，5分钟快速上手。读完你将获得：Docker一键部署步骤、手动安装详细指南、两种方案优缺点分析及常见问题解决方法。

准备工作

首先需要克隆项目仓库，确保本地环境已安装Git。

git clone https://gitcode.com/gh_mirrors/de/deepwiki-open
cd deepwiki-open

环境要求：

• Docker部署：Docker Engine 20.10+ 和 Docker Compose v2+
• 手动部署：Python 3.11+、Node.js 20+ 和 npm/yarn

Docker部署方案

步骤1：配置环境变量

创建.env文件，设置必要的API密钥和配置参数：

cp .env.example .env
# 编辑.env文件，添加OPENAI_API_KEY、GOOGLE_API_KEY等必要配置

步骤2：启动服务

使用docker-compose一键启动所有服务：

docker-compose up -d

docker-compose.yml配置了服务端口映射、数据持久化和资源限制：

docker-compose.yml

步骤3：访问应用

服务启动后，通过以下地址访问DeepWiki-Open：

• Web界面：http://localhost:3000
• API服务：http://localhost:8001

Docker部署架构如图所示：

手动安装方案

步骤1：安装后端依赖

# 创建虚拟环境
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# 安装Python依赖
pip install -r api/requirements.txt

后端依赖配置文件：api/requirements.txt

步骤2：安装前端依赖

# 使用npm安装依赖
npm install

# 或使用yarn
yarn install

前端包配置文件：package.json

步骤3：配置环境变量

同Docker部署步骤1，创建并配置.env文件。

步骤4：启动服务

# 启动后端API
uvicorn api.main:app --host 0.0.0.0 --port 8001

# 启动前端应用（新终端）
npm run dev

手动部署架构如图所示：

两种方案对比

特性	Docker部署	手动安装
部署难度	简单（一键启动）	中等（需手动配置环境）
环境隔离	好（容器化）	一般（依赖系统环境）
资源占用	较高（约6GB内存）	较低（可按需调整）
灵活性	较低（配置通过环境变量）	高（可直接修改代码和配置）
更新维护	简单（重新拉取镜像）	复杂（需手动更新依赖）
适用场景	快速部署、生产环境	开发调试、定制化需求

常见问题解决

服务启动失败

查看日志文件定位问题：

api/logs/application.log

日志配置在api/logging_config.py中定义，可通过LOG_LEVEL环境变量调整日志级别。

API密钥错误

确保.env文件中配置了正确的API密钥，支持的AI服务提供商配置可参考：

api/config/generator.json

embedding模型配置

修改嵌入模型配置，切换不同的嵌入服务：

api/config/embedder.json

结语

Docker部署适合追求简单快捷的用户，而手动安装适合需要深度定制的开发者。无论哪种方案，DeepWiki-Open都能帮助你快速构建基于AI的项目知识库。

点赞收藏本指南，关注项目获取最新更新！如有部署问题，欢迎在项目issue中交流。