核心摘要
目标：为本地的 Ollama 模型配置图形化界面 (GUI)。 工具：Docker + Open WebUI（社区活跃的开源 WebUI）。 核心功能：媲美 ChatGPT 的对话界面、本地知识库 (RAG)、自定义角色 (Agent)。
命令行工具有时显得过于硬核，对于日常使用或展示大模型，需要一个更友好的交互方式。本文将介绍如何用 10 分钟时间，搭建一个功能媲美 ChatGPT 的私有化网页页面，并连接本地模型。
01. 模型服务准备
在开始之前，确认 Ollama 服务已运行。
可以通过在终端输入 curl http://localhost:5656 命令验证其是否正确开启（端口号需根据实际配置，默认通常为 11434，为避免端口被扫描，建议切换至其他端口如 5656）。
如果显示 Ollama is running，说明准备就绪。
02. 使用 Docker 一键安装 Open WebUI
Docker 可以简化服务部署。如果尚未安装 Docker Desktop，请先前往官网下载。
使用以下命令自动下载 OpenWebUI 镜像并启动该服务：
docker run -d \
--network=host \
-v open-webui:/app/backend/data \
-e OLLAMA_BASE_URL=http://127.0.0.1:5656 \
-e PORT=3000 \
--name open-webui \
--restart always \
ghcr.io/open-webui/open-webui:main
命令参数说明：
-d：后台静默运行。--network=host：关键参数。让 Docker 容器内部能通过特殊地址访问宿主机上的 Ollama 服务。-v open-webui:/app/backend/data：将容器的数据目录映射到 docker 管理的卷中，防止重启后数据丢失。
执行以下命令查看容器是否运行成功：
docker ps -a
如果状态（Status）是 Up，即可进行下一步。
打开任意浏览器，访问 http://localhost:3000，即可看到登录页面。
03. 连接大模型
3.1 注册管理员账号
首次打开页面需要注册账号。本地部署的服务，账号密码仅存储在本地电脑中。
3.2 选择模型
登录后，点击左上角的 选择模型 下拉菜单，选择刚才配置的 Ollama 模型。
如果在菜单中未看到模型，请检查 OpenWebUI 的 Ollama 配置：
- 点击左侧 外部链接。
- 点击面板上方的 设置。
- 点击 用户名 -> 管理员面板，打开管理界面。
- 核对当前的连接地址和端口是否正确，然后点击 验证链接 按钮。
3.3 对话功能
在输入框中即可像 ChatGPT 一样与模型对话，支持 Markdown 渲染、代码高亮、流式输出等功能。
3.4 进阶使用
除了对话，Open WebUI 还支持以下实用功能：
功能一：本地知识库（RAG） RAG（检索增强生成）允许模型基于上传的文档回答问题，无需重新训练模型。
实操步骤：
- 在聊天输入框左侧点击 [+] 号，选择 上传文件（如 PDF 文档）。
- 上传后，文件会显示在聊天框左上角。
- 针对文档内容进行提问，例如：'介绍一下这本书'。
系统会将文档分块转化为向量存入内置数据库，提问时检索相关段落作为上下文。
