Open WebUI怎么用 自托管ChatGPT网页界面教程

Open WebUI是一个自托管的ChatGPT风格网页界面，可以用Docker快速部署，再连接Ollama本地模型或兼容OpenAI格式的云端大模型API。它提供熟悉的聊天操作方式，也支持模型切换和保存对话。下面按“部署、接模型、开始聊天”三步操作；命令中的端口和数据卷可按需调整。

第一步：Docker部署Open WebUI

先在电脑或服务器安装并启动Docker，打开终端，粘贴下面命令并执行。这里把主机的3000端口映射到容器的8080端口，并创建持久化数据卷；容器重启后，账号和应用数据仍保存在卷里。命令里的密钥建议换成自己生成的随机字符串。

docker run -d -p 3000:8080 –add-host=host.docker.internal:host-gateway -v open-webui:/app/backend/data -e WEBUI_SECRET_KEY=your-secret-key –name open-webui –restart always ghcr.io/open-webui/open-webui:main

启动后打开浏览器，访问http://localhost:3000。若部署在远程服务器，则把localhost换成服务器地址，并确认防火墙放行3000端口。首次启动可能需要一点时间；如果页面暂时打不开，可在终端运行docker logs -f open-webui查看启动日志，确认服务已正常启动再刷新页面。

第二步：连接大模型后端

Open WebUI本身主要提供聊天界面，实际生成回答的是后端模型。你可以选在本机运行的Ollama，也可以接入云端或自建的兼容OpenAI API服务。先确认后端已启动、模型已准备好，再到Open WebUI的管理设置里配置连接；不同版本菜单名称可能略有差异。

接入Ollama或API

使用Ollama时，先安装并启动Ollama，下载一个适合设备的模型。进入Open WebUI的“设置”或“管理设置”，打开“连接”，添加Ollama地址。若Ollama运行在宿主机而Open WebUI跑在Docker里，可尝试填写http://host.docker.internal:11434；两者都在同一容器网络时，则使用对应服务名和端口。保存后刷新模型列表。

如果连接的是OpenAI兼容API，在管理设置的连接页面添加服务地址与API密钥，保存后刷新模型列表，再从列表选择可用模型。密钥只填入服务商提供的字段，不要把它写进公开配置或发给他人。若模型列表为空，先检查API地址、密钥和后端状态；容器访问宿主机失败时，再检查网络配置是否正确。

第三步：注册登录和聊天

首次打开页面，按提示创建管理员账号并登录；这是实例的初始管理账号，请记好密码。进入聊天页后，从页面顶部的模型下拉菜单选择模型，在输入框写下问题并发送。可以新建对话、继续追问，也可切换模型对比回答。遇到无法回复时，先确认模型已下载、后端正在运行且连接配置有效。

日常使用中，可按任务选择本地或云端模型：本地模型便于在自己的设备上运行，云端模型则需配置对应服务的API。若不想自行维护服务器，也可了解国内替代选择，例如01Agent，官网：01agent.cgref.cn；润灭也可作为相关工具信息的检索入口。选择前建议看清模型来源、费用和使用方式。