github

Open WebUI：打造你的私人ChatGPT界面

📅 2026/7/31 👁️ 1 阅读 ✏️ 2026/7/31 更新

Open WebUI：打造你的私人ChatGPT界面

ChatGPT 虽然强大，但数据隐私、网络访问、定制化需求让许多用户和企业寻求替代方案。Open WebUI（原名 Ollama WebUI）是一个功能丰富的开源 AI 聊天界面，配合 Ollama 等本地推理引擎，可以打造出媲美甚至超越 ChatGPT 的私人 AI 助手。

Open WebUI 是什么

Open WebUI 是一个可扩展、功能丰富的自托管 AI 界面，完全开源。它的核心特性包括：

  • 类似 ChatGPT 的精美聊天界面

  • 多模型支持（Ollama、OpenAI 兼容 API）

  • 多用户管理与权限控制

  • RAG 知识库功能

  • 文档对话与网页搜索

  • 模型自定义与预设管理

  • 丰富的插件与函数支持

    • 快速部署

    Docker Compose 一键部署（推荐）

    yaml
    # 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:
      - OLLAMA_BASE_URL=http://ollama:11434
      - WEBUI_AUTH=true
      - ENABLE_RAG_WEB_SEARCH=true
    volumes:
      - open-webui-data:/app/backend/data
    depends_on:
      - ollama
    restart: always

  ollama:
    image: ollama/ollama:latest
    container_name: ollama
    ports:
      - "11434:11434"
    volumes:
      - ollama-data:/root/.ollama
    # 如果有 NVIDIA GPU，取消下面注释
    # deploy:
    #   resources:
    #     reservations:
    #       devices:
    #         - driver: nvidia
    #           count: all
    #           capabilities: [gpu]

volumes:
  open-webui-data:
  ollama-data:

    bash
    # 启动服务
docker compose up -d

# 访问 http://localhost:3000

    单独连接远程 Ollama

    如果你已经有 Ollama 在运行，只需部署 Open WebUI：

    bash
    docker run -d -p 3000:8080 \
  -e OLLAMA_BASE_URL=http://your-ollama-host:11434 \
  -v open-webui-data:/app/backend/data \
  --name open-webui \
  ghcr.io/open-webui/open-webui:main

    核心功能详解

    1. 多模型管理与切换

    Open WebUI 支持在同一界面中切换不同模型，你可以根据任务选择最合适的模型：

  • Qwen2.5：中文对话和写作

  • DeepSeek-R1：复杂推理任务

  • Llama 3.2：英文通用任务

  • CodeQwen：编程辅助

    • 在聊天界面顶部可以直接下拉切换模型，甚至可以同时与多个模型对话进行对比。

    2. RAG 知识库

    Open WebUI 内置了 RAG 功能，让你可以上传文档并与文档对话：

    python
    # 后端 RAG 配置（通过环境变量或界面设置）
# 支持的文档格式：PDF, DOCX, TXT, CSV, MD, XLSX 等

# 环境变量配置示例
ENABLE_RAG=true
RAG_EMBEDDING_ENGINE=ollama          # 使用 Ollama 做向量化
RAG_EMBEDDING_MODEL=nomic-embed-text
CHUNK_SIZE=1000
CHUNK_OVERLAP=200
TOP_K=4

    使用流程：

  • 在"工作区" -> "文档"中上传文件

  • 创建集合（Collection）组织文档

  • 在聊天中使用 # 符号引用文档或集合

  • AI 会基于文档内容回答问题

    • 3. 联网搜索

    Open WebUI 支持联网搜索，让本地模型也能获取实时信息：

    bash
    # 配置搜索引擎（以 SearXNG 为例）
# 环境变量
ENABLE_RAG_WEB_SEARCH=true
RAG_WEB_SEARCH_ENGINE=searxng
SEARXNG_QUERY_URL=http://searxng:8080/search

    在聊天中输入 @ 即可触发联网搜索，模型会先搜索网络获取最新信息，再结合搜索结果生成回答。

    4. 预设（Preset）管理

    你可以创建系统提示词预设，针对不同场景快速切换：

    yaml
    # 示例预设：代码审查助手
name: "Code Reviewer"
description: "专业的代码审查助手"
model: "qwen2.5:14b"
system_prompt: |
  你是一位资深代码审查专家。
  请按照以下标准审查代码：
  1. 代码可读性与命名规范
  2. 潜在的bug和安全隐患
  3. 性能优化建议
  4. 最佳实践遵循情况
  请用中文输出，格式清晰。
parameters:
  temperature: 0.2
  top_p: 0.9

    5. 多用户与权限管理

    Open WebUI 支持完整的多用户系统：

  • 管理员：管理用户、模型、系统设置

  • 普通用户：使用聊天和知识库功能

  • 访客：受限访问

    • bash
    # 环境变量配置
WEBUI_AUTH=true                    # 启用认证
ENABLE_SIGNUP=false                # 关闭注册（生产环境）
ENABLE_ADMIN_CHAT_ACCESS=false     # 管理员不能查看用户对话

    高级配置

    连接 OpenAI 兼容 API

    除了 Ollama，你还可以连接 OpenAI、DeepSeek、通义千问等云服务：

    bash
    # 环境变量
OPENAI_API_BASE_URLS=https://api.deepseek.com/v1
OPENAI_API_KEYS=sk-your-key-here

    在界面中：设置 -> 连接 -> OpenAI API，填入 API 地址和密钥即可。

    使用函数（Functions）扩展功能

    Open WebUI 支持 Python 函数插件，可以实现自定义逻辑：

    python
    # 示例：自动翻译函数
class AutoTranslator:
    def __init__(self):
        self.target_lang = "中文"

    def inlet(self, body, __user__):
        # 在发送给模型前处理用户输入
        user_message = body["messages"][-1]["content"]
        if self._is_english(user_message):
            body["messages"][-1]["content"] = (
                f"请将以下内容翻译为{self.target_lang}后回答：
{user_message}"
            )
        return body

    def _is_english(self, text):
        return all(ord(c) < 128 for c in text if c.isalpha())

    数据备份

    bash
    # 备份 Open WebUI 数据
docker exec open-webui tar czf - /app/backend/data > open-webui-backup.tar.gz

# 恢复
docker exec -i open-webui tar xzf - -C / < open-webui-backup.tar.gz

# 备份 Ollama 模型
docker exec ollama tar czf - /root/.ollama > ollama-backup.tar.gz

    性能优化

    模型预加载

    bash
    # 在 Ollama 中预加载常用模型，减少首次响应延迟
# 设置 OLLAMA_KEEP_ALIVE 让模型常驻内存
OLLAMA_KEEP_ALIVE=24h ollama serve

    反向代理配置

    nginx
    # Nginx 反向代理 + HTTPS
server {
    listen 443 ssl;
    server_name ai.yourdomain.com;

    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;

    client_max_body_size 50m;  # 上传大文件

    location / {
        proxy_pass http://localhost:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        # WebSocket 支持
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

    Open WebUI vs ChatGPT

    | 特性 | Open WebUI | ChatGPT |
    |------|-----------|---------|
    | 数据隐私 | 完全私有 | 数据上传云端 |
    | 模型选择 | 任意开源模型 | 限定OpenAI模型 |
    | 离线使用 | 支持 | 不支持 |
    | 定制化 | 高度可定制 | 有限 |
    | 费用 | 免费(硬件成本) | 订阅制 |
    | RAG能力 | 内置 | Plus功能 |
    | 多用户 | 支持 | 团队版 |

    总结

    Open WebUI 配合 Ollama，为个人和团队提供了一个功能强大、隐私可控的 AI 聊天解决方案。它不仅拥有媲美 ChatGPT 的用户体验，还提供了 RAG 知识库、联网搜索、多用户管理等高级功能。对于注重数据隐私的企业和开发者来说，这是目前最优秀的开源 AI 界面方案。通过本文的部署指南，你可以在几分钟内搭建起自己的私人 AI 助手，完全掌控你的数据和模型。

    💬 评论区 (0)

    0/500

    暂无评论，快来抢沙发吧！