在 macOS 上快速启动 Open WebUI（原 Ollama Web UI）非常简单，以下是详细的步骤说明，帮助你几分钟内完成安装并运行。

---

✅ 一、前提条件

确保你的 Mac 已安装以下工具：

1. Ollama（必须）
   Open WebUI 是基于 Ollama 的图形界面，因此需要先安装 Ollama。
2. Docker（推荐使用 Docker 安装 Open WebUI）

💡 提示：Open WebUI 推荐通过 Docker 运行，便于管理依赖和端口。

---

🚀 二、快速启动步骤（Mac + Docker）

步骤 1：安装 Ollama

前往官网下载并安装 Ollama for Mac：

🔗 https://ollama.com/download/Ollama-darwin.zip

或在终端中运行：

curl -fsSL https://ollama.com/install.sh | sh

安装完成后，启动 Ollama 应用（可在 Launchpad 找到），它会以后台服务形式运行。

---

步骤 2：拉取模型（例如 Llama3、Qwen 等）

在终端运行以下命令下载一个模型（以 llama3 为例）：

ollama pull llama3

你也可以选择其他模型，比如：

ollama pull qwen:7b
ollama pull mistral

---

步骤 3：安装 Docker Desktop for Mac

前往官网下载并安装 Docker：

🔗 https://www.docker.com/products/docker-desktop/

安装后打开 Docker Desktop，并确保其正在运行（状态栏出现鲸鱼图标 ✅）。

---

步骤 4：运行 Open WebUI（通过 Docker）

在终端执行以下命令启动 Open WebUI 容器：

docker run -d \
  --name open-webui \
  -p 3000:8080 \
  -e OLLAMA_BASE_URL=http://host.docker.internal:11434 \
  -v open-webui:/app/backend/data \
  --restart always \
  ghcr.io/open-webui/open-webui:main

📌 关键说明：

• -p 3000:8080：将容器的 8080 映射到本地 http://localhost:3000
• OLLAMA_BASE_URL=http://host.docker.internal:11434：让容器访问宿主机上的 Ollama 服务
• -v open-webui:/app/backend/data：持久化数据（聊天记录、设置等）
• --restart always：开机自启

✅ 启动成功后，你会看到类似输出：

Container started with ID: abcdef123456

---

步骤 5：访问 Open WebUI

打开浏览器，访问：

👉 http://localhost:3000

首次打开会提示你设置用户名和密码。

登录后即可开始与你下载的模型（如 llama3）对话！

---

🧪 三、测试对话（可选）

在 WebUI 中新建聊天，输入：

你好，你是谁？

选择模型为 llama3 或你已加载的模型，即可看到回复。

---

🔁 四、常用操作命令

功能	命令
查看容器状态	docker ps
停止容器	docker stop open-webui
启动容器	docker start open-webui
删除容器	docker rm -f open-webui
查看日志	docker logs open-webui

---

⚙️ 五、进阶配置（可选）

1. 使用自定义端口（比如 8080）

修改 -p 8080:8080，然后访问 http://localhost:8080

2. 支持中文界面

Open WebUI 默认支持中文！在右上角点击用户头像 → Settings → Language → 选择 中文

3. 启用 API 密钥（安全增强）

在 Settings → API 中生成密钥，可用于外部调用。

---

❌ 常见问题解决

❗ 问题 1：无法连接 Ollama（“Failed to connect”）

原因：Docker 容器无法访问宿主机的 Ollama。

✅ 解决方案：

• 确保 Ollama 正在运行（检查菜单栏图标）
• 使用 host.docker.internal（Mac/Linux）正确指向宿主机
• 检查 Ollama 是否监听 11434 端口：

  curl http://localhost:11434/api/version
  

❗ 问题 2：页面空白或加载失败

✅ 清除浏览器缓存，或尝试无痕模式打开。

---

🎉 总结：Mac 快速启动清单

步骤	操作
1	安装 Ollama
2	下载模型：ollama pull llama3
3	安装 Docker Desktop
4	运行 Open WebUI 容器（一行命令）
5	浏览器访问 http://localhost:3000 开始聊天

⏱ 全程约 5～10 分钟，无需编程基础。

---

如果你想进一步实现：

• 开机自启
• 反向代理（Nginx / Caddy）
• HTTPS 加密访问
• 多用户权限管理

欢迎继续提问，我可以提供完整部署方案！

现在就去试试吧 👉 Open WebUI GitHub