Open WebUI 部署教程：给Ollama大模型装上可视化界面

Ollama 让你在服务器上运行大模型变得非常简单，但纯命令行的交互方式对很多用户来说并不友好。Open WebUI 正是为了解决这个问题而诞生的——它为 Ollama 提供了一个功能完整的 Web 图形界面，让你像使用 ChatGPT 一样与本地大模型对话。本文将教你如何在腾讯云 Lighthouse 上部署 Open WebUI。

一、Open WebUI 是什么？

Open WebUI 是一个开源的、功能丰富的大模型聊天界面，专为 Ollama 设计，同时兼容 OpenAI 格式的 API。它的主要功能包括：

• 图形化聊天界面：像 ChatGPT 一样对话，支持多轮上下文
• 多模型切换：在界面中一键切换不同的本地模型
• 文件上传：支持上传图片、PDF、文档等文件作为对话上下文
• 知识库 RAG：将文档导入知识库，让模型基于你的文档回答问题
• 用户管理：支持多用户注册和权限管理
• 响应式设计：手机、平板、电脑均可正常使用

二、前提条件

在部署 Open WebUI 之前，需要先完成以下工作：

1. 一台腾讯云 Lighthouse 或 CVM 云服务器（推荐 2 核 4G 及以上）
2. 已安装 Docker 环境
3. 已安装 Ollama 并拉取了模型

如果还没有安装 Ollama，可以参考之前的教程先完成部署。

三、部署 Open WebUI

方式一：Docker 一键部署（推荐）

执行以下命令即可启动 Open WebUI：

docker run -d -p 3000:8080 \
  -v open-webui:/app/backend/data \
  -e OLLAMA_BASE_URL=http://你的服务器内网IP:11434 \
  --name open-webui \
  --restart always \
  ghcr.io/open-webui/open-webui:main

参数说明：

• -p 3000:8080：将容器的 8080 端口映射到服务器的 3000 端口
• -v open-webui:/app/backend/data：持久化存储用户数据和聊天记录
• -e OLLAMA_BASE_URL：指定 Ollama 服务的地址
• --restart always：自动重启，确保服务持续运行

如果 Ollama 和 Open WebUI 安装在同一个服务器上，OLLAMA_BASE_URL 可以设置为 http://127.0.0.1:11434。

方式二：Docker Compose 部署

创建一个 docker-compose.yml 文件：

version: '3.8'
services:
  ollama:
    image: ollama/ollama:latest
    container_name: ollama
    restart: always
    volumes:
      - ollama-data:/root/.ollama
    ports:
      - "11434:11434"

  open-webui:
    image: ghcr.io/open-webui/open-webui:main
    container_name: open-webui
    restart: always
    depends_on:
      - ollama
    ports:
      - "3000:8080"
    volumes:
      - open-webui-data:/app/backend/data
    environment:
      - OLLAMA_BASE_URL=http://ollama:11434

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

然后在文件所在目录执行：

docker compose up -d

这种方式的优势是 Ollama 和 Open WebUI 一次性部署完成。

四、使用 Open WebUI

首次访问

部署完成后，在浏览器访问 http://你的服务器IP:3000。

首次访问需要注册管理员账号，注册后自动登录。

选择模型

登录后，在界面顶部的模型选择下拉框中，可以看到你在 Ollama 中已安装的所有模型，点击即可切换。

上传文件

点击输入框左侧的附件图标，可以上传 PDF、Word、图片等文件。Open WebUI 会自动提取文件内容并作为上下文发送给模型。

创建知识库

在侧边栏中找到"知识库"功能，上传文档后，可以在对话中选择对应的知识库，让模型基于你的私有文档回答问题。

五、安全配置

将 Open WebUI 部署到公网后，建议：

1. 配置 HTTPS：使用 Nginx 反向代理 + Let's Encrypt 免费证书，保证数据传输安全
2. 开启注册审核：在 Open WebUI 后台管理面板中，可以关闭允许新用户注册，仅允许已有用户登录
3. 配置防火墙：仅放行必要的端口

六、常见问题

Q1：为什么访问页面显示空白？

A：检查 Docker 容器是否正常运行：docker ps。确认端口映射是否正确，以及服务器防火墙是否放行了 3000 端口。

Q2：Open WebUI 无法连接 Ollama？

A：在容器内测试能否访问 Ollama：docker exec open-webui curl http://host.docker.internal:11434。如果无法连接，检查 OLLAMA_BASE_URL 配置是否正确。

Q3：聊天记录会丢失吗？

A：如果使用了 -v open-webui:/app/backend/data 持久化挂载，聊天记录会保存在 Docker 卷中，容器重启不会丢失。

👉 前往腾讯云 Lighthouse 选购云服务器