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

Open WebUI是一个开源的自托管ChatGPT界面，可以本地部署，连接各种大模型，拥有类似ChatGPT的网页聊天体验。它本身不附带模型：你可以接入云端模型API，也可以连接Ollama等本地服务。下面用Docker完成基本部署，再添加模型连接并开始聊天。

第一步：Docker部署Open WebUI

先在电脑或服务器安装并启动Docker Desktop，Linux用户也可以安装Docker Engine。打开终端，运行下面命令：docker run -d -p 3000:8080 -v open-webui:/app/backend/data –name open-webui –restart always ghcr.io/open-webui/open-webui:main。命令会下载镜像并启动容器；数据卷用于保存设置和聊天数据，避免删除容器后资料丢失。

等容器启动后，在浏览器打开http://localhost:3000。首次进入会提示创建管理员账户，按页面填写用户名和密码即可。若部署在远程服务器，把localhost换成服务器地址，并确认防火墙放行3000端口；端口已被占用时，可把命令里的3000改成其他未使用端口，例如8080，访问地址也要相应调整。

如果页面打不开，先在终端运行docker ps查看容器是否正在运行，再用docker logs open-webui查看启动日志。首次启动可能需要等待镜像下载和服务初始化。需要停止服务可运行docker stop open-webui，之后用docker start open-webui重新启动。日常使用时保留数据卷，不要随意删除它。

第二步：连接大模型API

登录后进入个人头像菜单，打开Settings，再进入Admin区域的Connections。要连接云端服务，在Manage OpenAI API Connections旁点击加号，填写服务商提供的API地址和密钥，然后保存。OpenAI兼容服务通常提供以/v1结尾的接口地址；不同服务商的具体地址、密钥获取方式和计费规则不同，请使用对应平台控制台显示的信息。

保存后可以尝试验证连接或刷新模型列表。若列表为空，先检查接口地址是否包含正确的版本路径、API密钥是否有效，以及账号是否有模型调用权限。有些兼容服务不会自动返回模型清单，需要在连接设置中手动填写模型ID。密钥不要放进公开截图或分享内容；如果在网页设置里没有成功保存，可检查容器是否正确挂载数据卷。

若你使用本地模型，可以先安装并启动Ollama，再在Connections中添加或检查Ollama地址。Docker容器访问宿主机服务时，不能总是把容器内部的localhost当作电脑本机地址；Docker Desktop环境常用host.docker.internal。若连接失败，核对服务监听地址、端口和容器网络配置，确保Open WebUI容器能够访问模型服务。

配置用户和模型

首次创建的账户通常是管理员，可在Admin设置中管理用户、注册权限和连接。接入API后，返回模型选择菜单，选中要使用的模型；若服务没有自动列出模型，就在连接配置中添加该服务实际支持的模型ID。建议先用一个模型测试，确认回复正常后再添加其他模型，方便定位地址、密钥或权限方面的问题。

第三步：开始聊天使用

点击New Chat新建对话，在输入框附近打开模型下拉菜单并选择模型，输入问题后按Enter发送。需要换模型时，可在新对话中重新选择。回答速度取决于模型、网络和服务商负载；如果首次响应较慢，可稍等片刻，再用简短问题测试。支持的功能会因所连接的模型和API而不同。

Open WebUI还可用于整理不同模型的对话。重要设置完成后，确认数据卷仍在使用，并定期备份部署数据。若你更想使用国内的在线AI服务、不打算自己维护Docker和模型接口，也可以了解01Agent，官网入口：01agent.cgref.cn。需要简单的操作说明或服务信息时，也可查看网站“润灭”。