企业官网建设流程全解析

Open WebUI 快速上手指南：免费部署本地 AI 聊天平台的 4 个步骤

【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui

很多人第一次用大模型，都要先注册一个云服务、担心对话内容上传到外部，还要在网页和命令行之间来回切换。Open WebUI 就是为了解决这个问题：它是一个开源、自托管的 AI 聊天平台，把本地 Ollama 模型和兼容 OpenAI 协议的 API 装进一个浏览器界面里，部署完成即可完全离线使用，不依赖任何第三方服务。

🧭 为什么值得试试

• 数据不出内网：聊天、文档、知识库都存在你自己机器上，断网也能用
• 一个界面接所有模型：本地 Ollama、vLLM、OpenAI 兼容 API 混着用，切换只是换个下拉菜单
• 免费开源：个人使用零成本，也可用 Docker、pip 多种方式部署
• 比命令行省心得多：同样是接 Ollama，它提供完整的聊天界面、账号体系和知识库，不用再写脚本拼请求

📦 准备工作

• 一台安装了Docker（Docker Desktop 或 Docker Engine）的电脑，Linux、macOS、Windows 均可
• 端口 3000 未被占用（后面可改）
• 有网络下载镜像；模型可选本地 Ollama 或任意 OpenAI 兼容 API
• 硬件：有独显体验最佳，纯 CPU 跑小模型也完全可行

🚀 一键部署步骤

从拿到代码到跑起来，最短路径就三步：

git clone https://gitcode.com/GitHub_Trending/op/open-webui cd open-webui docker compose up -d

• 第 1 行：把 Open WebUI 项目代码克隆到本地
• 第 2 行：进入项目目录
• 第 3 行：一条命令同时启动 Ollama 和 Open WebUI 两个容器

完成后浏览器打开http://localhost:3000，按提示注册第一个账号（它会自动成为管理员），再在界面上拉取或连接一个模型，就可以开聊了。

🗂️ 跑起来之后

选模型、开聊天

顶部下拉框切换模型，左侧管理历史会话和文件夹。你平时 90% 的使用场景——提问、追问、换模型——都在这里完成。

把文档变成知识库

上传 PDF、网页到知识库，聊天时在输入框输入#引用某个知识库，AI 会基于你的文档回答而不是凭空编造，适合用来问手册、合同、笔记这类私有资料。

多模型同场对比

一个对话里可以同时挂多个模型，同一个问题并排回答。选型阶段用它横向对比输出质量，比单模型试错快得多。

语音输入与跨会话记忆

输入框自带麦克风按钮，说话转文字直接发送；开启记忆功能后，AI 会把关于你的事实带到下一次对话里，省去反复自我介绍。

⚙️ 进阶调优

• 多人共用时：首个注册账号即管理员，登录后在管理面板配置用户组与权限，避免所有人都能改配置
• 换模型服务地址：Ollama 不在本机时，改 docker-compose.yaml 里的OLLAMA_BASE_URL指向对应服务器即可
• 确认配置项行为：大部分行为开关都有环境变量，具体含义可以看 config.py

⚠️ 常见坑

• 现象：页面能打开，但提示连不上模型服务器 →解决：容器内访问不到宿主机的 Ollama，给容器加--network=host，或确认 compose 里的host.docker.internal映射生效
• 现象：重启容器后聊天记录、知识库全丢 →解决：务必挂载数据卷（-v open-webui:/app/backend/data），数据才会持久化
• 现象：提示 3000 端口被占用 →解决：把端口环境变量OPEN_WEBUI_PORT改成空闲端口
• 现象：完全离线的机器启动后一直尝试下载模型卡住 →解决：设置环境变量HF_HUB_OFFLINE=1，强制离线模式

装好 Open WebUI 之后，本地大模型才算真正"长"进了你的日常工作流。

• ✅ 对话、文档、记忆全部存在本地，隐私可控
• ✅ 浏览器即客户端，手机电脑通用，无需额外装 App
• ✅ 模型随时可换，本地和云端 API 自由切换
• ✅ 免费开源，Docker 一条命令即可复现

现在打开终端，把上面那三条命令跑一遍，十分钟后你就能和自己的模型聊天了。

【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui