首页›团队工作台

Open WebUI 部署与 DeepSeek 团队私有化知识库配置指南

Open WebUI 是最受欢迎的开源 ChatGPT 替代界面。本文提供使用 Docker 一键部署 Open WebUI 并接入 DeepSeek API、多用户权限管理及文档 RAG 检索的完整方案。

维护：DeepSeekDSH（独立站点）内容更新：2026-09-13

本页内容

Open WebUI + DeepSeek 参数速查

OpenAI 兼容端点： https://api.deepseek.com/v1 或 https://api.deepseek.com
API 密钥： 从 DeepSeek 开放平台获取
默认本地访问端口： http://localhost:3000 或 http://服务器IP:3000

第 1 步

Docker / Docker Compose 一键启动

通过官方 Docker 容器快速启动 Open WebUI：

# 方案 A：单命令 Docker 启动（绑定本地数据卷）
docker run -d -p 3000:8080 \
  -e OPENAI_API_BASE_URL=https://api.deepseek.com/v1 \
  -e OPENAI_API_KEY=sk-你的DeepSeek_API_Key \
  -v open-webui:/app/backend/data \
  --name open-webui \
  --restart always \
  ghcr.io/open-webui/open-webui:main

或使用 docker-compose.yml 便于持久化维护：

version: '3.8'
services:
  open-webui:
    image: ghcr.io/open-webui/open-webui:main
    container_name: open-webui
    ports:
      - "3000:8080"
    environment:
      - OPENAI_API_BASE_URL=https://api.deepseek.com/v1
      - OPENAI_API_KEY=sk-你的DeepSeek_API_Key
    volumes:
      - open-webui-data:/app/backend/data
    restart: always

volumes:
  open-webui-data:

第 2 步

Web 界面连接与模型激活

浏览器打开 http://localhost:3000，注册第一个管理员账号。
点击左下角头像 管理员面板 (Admin Panel) → 设置 (Settings) → 连接 (Connections)。
在 OpenAI API 设置中确认 Base URL 为 https://api.deepseek.com/v1，输入 API Key。
点击刷新连接按钮，确认 deepseek-chat 与 deepseek-reasoner 成功列出并启用。

第 3 步

搭建文档 RAG 知识库

Open WebUI 原生支持上传 PDF、Markdown、TXT 及 Word 文档构建团队私有知识库：

在左侧侧边栏点击 知识库 (Workspace / Knowledge)，点击右上角新建知识库。
上传团队内部制度、开发文档或产品手册，系统会自动进行文本切分与向量化索引。
在对话框中输入 #知识库名称 或点击附件图标关联知识库，即可让 DeepSeek 基于内部资料进行检索答疑。

第 4 步

开启 Web 联网搜索能力

在管理员面板的 联网搜索 (Web Search) 中，可开启 DuckDuckGo（免 Key）或 SearXNG / Tavily 搜索引擎。开启后，在对话中勾选“联网搜索”，DeepSeek 即可在回答时抓取最新的实时网络信息。

常见排错清单

Models list empty / 模型列表为空

检查 OPENAI_API_BASE_URL 末尾是否带有 /v1，确保服务器能正常访问 https://api.deepseek.com 外网。

R1 模型思考链显示异常

Open WebUI 最新版本原生支持 reasoning_content 字段的折叠渲染。请确保拉取的是 open-webui:main 最新镜像。