适合人群：想在自己电脑上用网页聊天界面跑本地大模型、又不想一直敲命令行的同学和上班族。本文用 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-host=host.docker.internal:host-gateway，让容器访问本机服务。新手优先一体化路径即可。
三、打开页面并创建管理员
- 在浏览器地址栏输入 localhost:3000 并打开（不要加多余路径）；
- 首次启动可能要等一两分钟。若页面一直空白，可在终端查看容器日志，等到出现 Application startup complete 再刷新；
- 首屏会提示 Create Admin Account。第一个注册的账号就是管理员，请记好密码；丢失管理员密码会影响到实例级设置。
四、确认连接并拉取模型
Open WebUI 本身不自带对话模型，需要接到 Ollama 或其它模型服务。
- 打开头像旁的 Settings，进入 Admin，再打开 Connections；
- 一体化 :ollama 镜像一般会自带可用的 Ollama 连接；若你用的是本机独立 Ollama，Docker 场景下常见地址是 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/
