资讯详情

Open WebUI 入门:用 Docker 装上本地对话界面并连接 Ollama

📅 2026/10/31 11:12:58 | 华诺云谱 👁 阅读
Open WebUI 入门:用 Docker 装上本地对话界面并连接 Ollama
适合人群想在自己电脑上用网页聊天界面跑本地大模型、又不想一直敲命令行的同学和上班族。本文用 Docker 一次性装好 Open WebUI并顺带带上 Ollama从打开页面到发出第一条消息。本文用一个场景贯穿小陈想在笔记本上用类似网页聊天的界面跑本地模型平时只会装软件不想记一长串命令。一、先准备 Docker官方推荐用 Docker 安装 Open WebUI并说明它可在 macOS、Linux 和 Windows 上使用。先安装并启动 Docker Desktop或本机已有的 Docker 环境确认终端里能执行 docker 命令磁盘和内存留出余量后面要下载镜像和模型具体占用以本机情况和界面提示为准若端口 3000 已被占用后面启动命令里把左侧端口号改成别的数字即可。按钮名称和菜单位置可能随版本变化以界面为准。二、用一体化镜像启动推荐新手为减少步骤本文走官方文档里的「Bundled with Ollama」CPU 示例一个容器里同时带上 Open WebUI 和 Ollama。在终端生成一段密钥命令为 openssl rand -hex 32把输出复制下来后面当作 WEBUI_SECRET_KEY到官方 Quick Start 页面复制带 :ollama 标签的 CPU 版 docker run 命令把命令里的 your-secret-key 换成刚才生成的密钥再执行。关键参数含义大致是-p 3000:8080本机用 3000 端口访问界面-v ollama:/root/.ollama 与 -v open-webui:/app/backend/data分别保存模型和聊天数据-e WEBUI_SECRET_KEY…固定密钥避免重建容器后全部掉登录–restart always开机后尽量自动拉起。若你已经单独装好了本机 Ollama也可以改用官方 :main 镜像并加上 --add-hosthost.docker.internal:host-gateway让容器访问本机服务。新手优先一体化路径即可。三、打开页面并创建管理员在浏览器地址栏输入 localhost:3000 并打开不要加多余路径首次启动可能要等一两分钟。若页面一直空白可在终端查看容器日志等到出现 Application startup complete 再刷新首屏会提示 Create Admin Account。第一个注册的账号就是管理员请记好密码丢失管理员密码会影响到实例级设置。四、确认连接并拉取模型Open WebUI 本身不自带对话模型需要接到 Ollama 或其它模型服务。打开头像旁的 Settings进入 Admin再打开 Connections一体化 :ollama 镜像一般会自带可用的 Ollama 连接若你用的是本机独立 OllamaDocker 场景下常见地址是 host.docker.internal:11434点 New Chat在模型选择框里输入模型名称并确认拉取管理员可直接触发从 Ollama 拉取。模型列表、名称和体积以 Ollama 与界面提示为准。五、发出第一条消息在 New Chat 里选好已就绪的模型在输入框写一句话例如请它用三句话介绍自己然后发送可以把文件拖进对话再针对文件内容提问。具体支持格式与大小以当前版本界面为准。到这里小陈已经能在网页里和本地模型对话而不必每次打开终端敲指令。常见问题问页面打不开或一直转圈怎么办答先确认容器在运行再查日志里是否出现 Application startup complete。端口冲突时改映射左侧端口。问为什么模型选择框是空的答Open WebUI 不内置模型。请到 Admin → Connections 检查 Ollama 连接并在选择框里输入名称拉取。独立安装的 Ollama 还需确认服务已启动。问重建容器后全部被退出登录答多半是没有固定 WEBUI_SECRET_KEY。请用 openssl 生成一次并一直沿用同一个值。问一体化镜像和分开安装怎么选答只想尽快用上网页界面选 :ollama。已经熟悉本机 Ollama、或想单独管理模型目录再考虑 :main 加本机连接。小贴士密钥只生成一次并妥善保存和数据卷一样重要。先拉体积较小的模型验证流程再换更大模型。数据在 Docker 卷里更新镜像前先确认卷名没有写错避免误删。若只在本机使用不要把 3000 端口暴露到公网对外访问前先阅读官方安全与分享说明。参考资料Open WebUI 官方文档Getting started / Quick Start含 :ollama 与 :main 的 docker run 示例 https://docs.openwebui.com/getting-started/quick-start/
📝

华诺云谱内容团队

资深建站顾问 · 行业研究员

10年+企业数字化服务经验,专注智能建站、SEO优化与品牌营销,持续输出建站技巧、行业洞察与营销干货,已帮助5000+企业实现数字化增长。

你可能需要的服务

订阅华诺云谱资讯周报

每周一封,精选建站技巧、SEO与营销干货,直达邮箱。已有 8,000+ 企业主订阅,助你少走弯路。

↑