引言 Open WebUI是一个功能强大的开源AI聊天界面，支持Ollama和OpenAI兼容API。它将ChatGPT级别的用户体验带到本地部署环境中，支持语音输入、文件上传、RAG知识库、多模型切换等丰富功能。本文将指导你完成完整的本地部署。
一、Open WebUI核心特性 功能亮点 类ChatGPT界面：流畅的对话体验 多模型支持：Ollama本地模型 + 云端API RAG知识库：上传文档，让AI基于你的数据进行回答 语音交互：语音输入与TTS输出 权限管理：支持多用户和角色管理 插件系统：扩展自定义功能 移动端适配：响应式设计，手机也能用 二、部署方式一：Docker快速部署（推荐） 前置条件 Docker和Docker Compose 至少2GB可用内存 20GB磁盘空间（含模型） 基础部署
拉取并启动Open WebUI
docker run -d -p 3000:8080
--name open-webui
--restart always
-v open-webui-data:/app/backend/data
ghcr.io/open-webui/open-webui:main
访问 http://localhost:3000 注册第一个账号（自动成为管理员）。
集成Ollama本地模型
先启动Ollama
docker run -d -p 11434:11434
--name ollama
--restart always
-v ollama-models:/root/.ollama
ollama/ollama
拉取模型
docker exec ollama ollama pull deepseek-r1:7b docker exec ollama ollama pull qwen2.5:7b Docker Compose一键部署 创建 docker-compose.yml：
version: "3.8" services: open-webui: image: ghcr.io/open-webui/open-webui:main ports: - "3000:8080" volumes: - open-webui-data:/app/backend/data environment: - OLLAMA_BASE_URL=http://ollama:11434 - WEBUI_SECRET_KEY=your-secret-key depends_on: - ollama restart: always
ollama: image: ollama/ollama volumes: - ollama-models:/root/.ollama restart: always
volumes: open-webui-data: ollama-models: 三、配置指南 连接云模型API 进入设置 → 外部连接 添加OpenAI兼容API 输入API Key RAG知识库配置 进入工作区 → 知识库 点击创建知识库 上传文档（PDF、TXT、Markdown等） 选择嵌入模型 等待处理完成 语音配置 Open WebUI支持Edge-TTS免费语音合成。
四、高级功能
-
自定义主题 通过修改环境变量或CSS变量实现主题定制。
-
函数与管道 支持自定义处理函数，实现请求预处理和响应后处理。
-
多用户管理 管理员：系统配置和用户管理 用户：普通使用权限 访客：有限的试用权限 五、安全配置 HTTPS配置 使用Nginx反向代理配置SSL证书。
数据备份
备份数据卷
docker run --rm -v open-webui-data:/data -v $(pwd):/backup alpine tar czf /backup/open-webui-backup.tar.gz -C /data . 六、性能优化 硬件建议 Ollama本地模型：建议16GB以上内存 嵌入式模型：8GB内存即可流畅运行 GPU加速：NVIDIA显卡支持CUDA加速 缓存策略 开启响应缓存减少重复查询 配置Redis缓存后端提升性能 总结 Open WebUI是目前最优秀的本地AI聊天界面解决方案。通过本文的教程，你已经掌握了Docker部署、模型配置、RAG知识库搭建等核心技能。无论是个人使用还是团队共享，Open WebUI都能提供出色的AI助手体验。所有数据都保留在你的本地，完全保障了数据安全。
