Open WebUI：功能最强悍的自托管 ChatGPT 替代开源面板

一、 Open WebUI 架构定位

Open WebUI（原 Ollama WebUI）是目前 GitHub 上 Star 最多的自建大模型用户界面之一。它以接近官方 ChatGPT 的交互体验，提供了企业级知识库 RAG、语音识别（Whisper）、多模型聚合、权限分组与插件生态支持。

二、 硬件要求与准备工作

• 推荐环境：Linux 服务器（Ubuntu 22.04+ 或 Debian 12），建议至少 2 核 CPU、2GB 内存；
• 容器运行依赖：安装最新版本 Docker 与 Docker Compose；
• 可选算力后端：本地部署的 Ollama（端口 11434）或远程 OpenAI 格式 API Key。

三、 Docker 一键快速部署实操

1. 创建本地持久化数据目录：

   mkdir -p /opt/open-webui/data
   cd /opt/open-webui
   

2. 启动生产级 Docker 容器：

   # 标准启动命令（映射本地 3000 端口，打通宿主机网络通信）
   docker run -d -p 3000:8080 \
     --add-host=host.docker.internal:host-gateway \
     -v /opt/open-webui/data:/app/backend/data \
     --name open-webui \
     --restart always \
     ghcr.io/open-webui/open-webui:main
   

3. 配置反向代理与 SSL：

   通过 Nginx / OpenResty 将域名（如 ai.example.com）反向代理至本地 127.0.0.1:3000，并配置通配符 SSL 证书即可安全外网访问。

四、 初始化配置与知识库 RAG 上手

• 注册超级管理员：首个访问并注册的用户将自动拥有系统管理员权限；
• 接入第三方大模型：在管理员设置 ➔ 连接 ➔ 添加 OpenAI 接口基础地址与 Key，支持直连 DeepSeek、Claude 等；
• 文档知识库问答：在左侧导航新建“知识库”，直接上传 PDF 或 Word 技术文档，对话时输入 #知识库名称 即可实现精准上下文检索。

五、 常见问题与排坑

• 问题 1：无法连接到宿主机本地运行的 Ollama ➔ 确认 Ollama 监听环境变量设置了 OLLAMA_HOST=0.0.0.0，并在 Open WebUI 中使用地址 http://host.docker.internal:11434。
• 问题 2：上传大文件 RAG 解析卡死 ➔ 默认内置的 Embedding 模型运行在 CPU 上，建议在设置中将嵌入模型切换为云端 API（如 text-embedding-3-small）以极大提升分段速度。