能解决什么问题？

很多朋友在本地用 Ollama 跑大模型，但命令行黑框框不够友好，不能保存对话、没有多模型切换、也不能团队共用。Open WebUI 就是给本地模型套上一个类似 ChatGPT 的网页界面，支持多模型切换、对话历史、知识库上传、联网搜索（需配置），还能多用户使用。简而言之：模型还是你本地的，但操作体验直接拉满。

准备工作

建议先装好 Ollama（官网 ollama.com 可直连下载），并拉取至少一个模型，例如在终端输入 ollama pull qwen2.5:7b（通义千问，国内下载快）。然后选择 Open WebUI 的安装方式，推荐用 Docker，国内可直连 Docker Hub 或用阿里云镜像加速。若不想折腾 Docker，也可用 pip 安装：pip install open-webui。确保电脑有 8GB 以上内存，模型越大越吃资源。

分步骤实操

第1步：启动 Open WebUI。如果用 Docker，在终端输入：docker run -d -p 3000:8080 -v open-webui:/app/backend/data --name open-webui ghcr.io/open-webui/open-webui:main。如果用 pip，直接输入 open-webui serve。等待出现“Running on http://0.0.0.0:8080”即成功。

第2步：打开浏览器访问。在地址栏输入 http://localhost:3000（Docker）或 http://localhost:8080（pip）。首次进入会看到注册页面，输入邮箱、用户名、密码，点击“注册”按钮。第一个注册的用户自动成为管理员。

第3步：连接本地模型。登录后点右上角头像→“设置”或“管理员设置”，找到“连接”或“模型”选项卡。在“Ollama 地址”处填写 http://host.docker.internal:11434（Docker）或 http://localhost:11434（pip）。点“保存”后，点“模型”列表里的刷新按钮，就能看到已下载的模型，如 qwen2.5:7b。

第4步：开始对话。返回主界面，点左上角“新对话”，在顶部下拉框选择模型（如 qwen2.5:7b）。在底部输入框打字，按回车或点发送按钮。左侧会列出所有历史对话，点标题可切换。对话中可点“复制”复制回答，点“重新生成”让模型再答一次。

第5步：调整参数（可选）。在对话界面点右上角“设置”图标，展开“高级参数”。可调温度（0-2，越大越随机）、最大生成长度（如 2048）。改完点“保存”，下次对话生效。

第6步：多用户与分享。管理员可在“管理员设置”→“用户”里添加新用户，或开放注册。每个用户有独立对话历史。想分享某次对话，点对话标题右侧的“分享”按钮，生成链接发给同事。

进阶技巧

常见问题

问：连接 Ollama 失败，提示“Connection refused”怎么办？
答：先确认 Ollama 正在运行（终端输入 ollama list 有输出）。Docker 里部署的 Open WebUI 不能直接用 localhost，要用 host.docker.internal；如果还不行，在 Ollama 启动时加环境变量 OLLAMA_HOST=0.0.0.0。

问：模型列表是空的，刷新也没用？
答：检查 Ollama 地址是否正确，以及是否已用 ollama pull 下载模型。如果地址带端口，确保端口是 11434。可先在浏览器访问 http://localhost:11434 看是否显示“Ollama is running”。

问：想换一个界面语言或主题？
答：点右上角头像→设置→界面，可切换语言（支持中文）、主题（浅色/深色）。修改后自动保存。