在本地环境中通过 Docker 部署 Open WebUI 以连接 Ollama 大模型的完整流程。内容涵盖 Docker 环境准备、WebUI 镜像拉取与启动命令解析、端口映射配置、以及如何在 Web 界面中管理本地模型。此外，还补充了常见连接问题排查与安全加固建议，帮助用户快速搭建私有化 AI 对话平台。
在本地环境中运行开源大语言模型（如 Llama3）已成为许多开发者和爱好者的需求。通过 Docker 容器化技术，我们可以快速搭建一个基于 Open WebUI 的本地对话平台，无需编写复杂代码即可实现与模型的交互。
Open WebUI 依赖 Docker 容器运行。请前往官网下载对应系统的客户端：
WebUI 需要连接后端的 Ollama 服务。请先在本地安装 Ollama 并拉取所需模型（如 llama3:8b）：
# Windows PowerShell / Mac Terminal
ollama pull llama3:8b
确认模型可用：
ollama run llama3:8b
Open WebUI 提供了官方 Docker 镜像。推荐使用以下命令进行一键部署：
docker run -d \
--add-host=host.docker.internal:host-gateway \
-v open-webui:/app/backend/data \
--name open-webui \
--restart always \
ghcr.io/open-webui/open-webui:main
-d：后台运行容器。--add-host=host.docker.internal:host-gateway：关键配置。允许容器访问宿主机网络，使 WebUI 能连接到本地运行的 Ollama 服务。-v open-webui:/app/backend/data：挂载卷，用于持久化用户数据、聊天记录和配置文件，防止容器删除后数据丢失。--name open-webui：指定容器名称。--restart always：设置重启策略，确保服务异常退出后自动恢复。ghcr.io/...：指定镜像仓库地址。打开终端（Terminal/PowerShell/CMD），复制上述命令并回车。等待镜像拉取完成，可通过以下命令查看容器状态：
docker ps
若看到 open-webui 容器处于 Up 状态，则部署成功。
浏览器访问以下地址：
首次访问时，系统会提示注册管理员账号。输入用户名和密码即可完成初始化。
进入 WebUI 后，需确保其能识别到本地的 Ollama 实例：
http://host.docker.internal:11434。
llama3:8b）。如果 3000 端口被占用，可修改启动命令中的 -p 参数：
-p 8080:8080
此时访问地址变为 http://localhost:8080。
可通过 -e 参数添加环境变量，例如设置默认语言或启用特定功能：
-e WEBUI_SECRET_KEY=your_secret_key
建议在生产环境中设置强密码密钥。
--gpus all
--memory=4g 等限制。| 问题现象 | 可能原因 | 解决方案 |
|---|---|---|
| 页面无法访问 | 端口冲突或服务未启动 | 检查 docker ps 状态，尝试更换端口 |
| 模型列表为空 | Ollama 未运行或网络不通 | 确认 ollama serve 进程存在，检查防火墙设置 |
启动报错 Address already in use | 端口被占用 | 修改 -p 映射端口或使用 lsof 查找占用进程 |
| 中文乱码 | 字体缺失 | 在容器中安装中文字体或调整 WebUI 设置 |
通过 Docker 部署 Open WebUI 是本地运行大模型最便捷的方式之一。它屏蔽了复杂的后端配置，让用户专注于模型交互与应用场景。结合 Ollama 的高效推理能力，您可以在个人电脑上构建一个安全、私有的 AI 助手，无需担心数据上传至云端。随着技术的迭代，未来还可进一步集成 RAG（检索增强生成）等功能，扩展本地知识库的应用边界。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
使用加密算法（如AES、TripleDES、Rabbit或RC4）加密和解密文本明文。 在线工具，加密/解密文本在线工具，online
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online