第1章 Open WebUI 入门指南
开放 WebUI 入门
从零基础到第一次 AI 对话,只需不到五分钟。 Open WebUI 支持多种运行环境(Docker、Kubernetes、pip、裸机),并开箱即用地连接 Ollama、兼容 OpenAI 以及 Open Responses 服务。选择一种安装方式,接入一个模型服务,即可开始聊天。
⏱️ 快速上手 安装 Open WebUI,连接模型,开始对话。 涵盖一切必要的配置。选择 Docker 作为最快路径,Python 适合轻量级安装,Kubernetes 适合生产环境编排。每个指南都包含连接第一个模型服务的步骤。 🐳 Docker 单命令部署,官方推荐路径 📦 Python (pip / uv) 适用于低资源或手动设置的轻量级安装 ☸️ Kubernetes (Helm) 支持扩展的生产级编排 🖥️ 桌面应用 原生应用,无需 Docker 🔌 连接服务 支持 Ollama、OpenAI、Anthropic、llama.cpp、vLLM 等 ⚙️ 了解设置 学习管理员设置与用户设置如何协同工作 开始安装 →
📱 将 Open WebUI 安装为应用 已在运行 Open WebUI?在任何设备上将其安装为应用。 Open WebUI 是一个渐进式 Web 应用(PWA)。你可以将其添加到手机主屏幕、桌面任务栏或 Dock 中,无需单独下载。在任何浏览器中都能获得全屏、类似原生的体验。 📱 iPhone / iPad 通过“分享 → 添加到主屏幕” 🤖 Android 通过“菜单 → 安装应用” 🖥️ Chrome / Edge 通过“地址栏安装图标” 安装为应用 →
Open WebUI 基础要素 已安装并可以聊天了。接下来呢? 以下短章节涵盖了每个新用户第一天都希望了解到的内容:什么是插件以及如何安装、为什么长对话最终会报错(以及上下文压缩如何处理)、用于生成标题和自动补全的“隐形”任务模型、基于自有文档的 RAG 入门、网络搜索、原生工具调用和 Open Terminal。 🧩 插件 工具、管道、过滤器、操作:扩展性体系 🧠 上下文管理 为什么长对话会受限及如何应对 🤖 任务模型 将标题、标签和自动补全从主模型中分离 📚 基础 RAG 与你自己的文档聊天 🔧 工具调用 原生模式 + 需安装的首批工具 🌐 网络搜索 选择一个服务商,模型需要时即可搜索 🖥️ Open Terminal 模型可构建和运行程序的沙盒 shell 阅读基础要素 →
🤖 连接智能体 超越简单的模型服务。连接一个自主 AI 智能体。 像 Hermes Agent 和 OpenClaw 这样的 AI 智能体自带工具(终端、文件操作、网络搜索、记忆),并将 Open WebUI 作为丰富的聊天前端。智能体决定何时使用工具,执行操作,并将结果流式返回给你。 🧠 Hermes Agent Nous Research 开发的智能体,具备终端、文件操作、网络搜索和技能 🐾 OpenClaw 自托管智能体框架,支持 shell 访问、网络浏览和频道机器人 连接智能体 →
共享 Open WebUI 通过一次部署,将 AI 带到整个组织。 Open WebUI 不仅仅是本地的 AI 界面。它旨在成为团队的中心化 AI 操作系统。部署一次即可实现简化的入职流程、协作智能、资源池化和集中式安全。 局域网与隧道 支持 Tailscale、Cloudflare 隧道和局域网 IP 访问 反向代理 使用 Nginx、Caddy 或 HAProxy 保护实例 团队入职 管理员审批流程和企业级 SSO 集成 共享上下文 频道、共享聊天和通用知识库 了解如何共享 Open WebUI →
🛠️ 高级主题 扩展、监控和自定义你的部署。 超越基础功能。配置环境变量,连接外部数据库,添加云存储,启用 OpenTelemetry,或使用 Redis 和多个工作进程实现水平扩展。 ⚖️ 扩展 多工作进程、多节点、基于 Redis 的会话 📊 日志与可观测性 OpenTelemetry 追踪、指标和结构化日志 🧪 开发环境 从源码运行以进行本地开发和测试 探索高级主题 →
🔄 更新 保持使用最新功能和安全补丁。 通过单条 Docker 或 pip 命令手动更新,或使用 Watchtower、WUD 或 Diun 实现自动化。包含生产环境使用的备份/恢复步骤和版本锁定。 🔄 手动更新 Docker 拉取 + 重新创建,或 pip 升级 🤖 自动更新 Watchtower、WUD 或 Diun 📌 版本锁定 锁定特定发布版本以确保稳定性 💾 备份与恢复 单命令卷备份和恢复 更新指南 → 此内容仅供参考,不构成保修、保证或合同承诺。Open WebUI 按“原样”提供。请查看你的许可证了解适用条款。