Open WebUI 是这两年最火的自托管 AI 聊天界面之一本地优先、支持多用户、带模型白名单和知识库体验接近官方聊天页但数据留在自己手里。它本质上也是一个OpenAI 兼容协议的客户端——本身不生产模型只负责把你的对话请求发往外接 API 端点。所以能接哪些模型完全取决于你在设置里填了哪个端点。本文演示如何从零起服务并通过外接 API 端点把多家大模型GPT-5、Claude Opus 4.7、Gemini 3 Flash、DeepSeek V4 等接进同一个界面。一、最快启动Docker 一条命令启动后访问http://localhost:3000注册的第一个账号即为管理员。docker run -d -p 3000:8080 \ -v open-webui:/app/backend/data \ --name open-webui \ ghcr.io/open-webui/open-webui:main生产环境建议锁定版本号如:v0.9.6并挂载数据卷保证配置持久化。二、核心外接一个 API 端点Open WebUI 的模型能力来自连接Connections。添加外接端点的步骤登录管理员账号进入 ⚙️Admin Settings管理设置导航到Connections连接 → OpenAI点击 ➕Add Connection添加连接填写两项核心信息API URL你的模型服务地址形如https://xxx/v1API Key该端点对应的密钥点击保存保存后端点支持的模型会进入模型选择器直接开聊即可——你不需要本地下载任何模型。如果你在 Docker 里跑 Open WebUI而模型服务在宿主机上把 URL 里的localhost换成host.docker.internal。三、关键一步API URL 到底能填什么很多教程只写填https://api.openai.com/v1但实际可填的范围宽得多。只要满足OpenAI Chat Completions 兼容协议即暴露/v1与/models几乎任何端点都能接。常见几类端点来源示例地址适合谁注意点官方 OpenAIhttps://api.openai.com/v1充值通道顺畅的用户区域与支付限制是门槛云厂商Azure 等各自 Endpoint企业级、要合规需填 API Version / Deployment聚合类平台魔芋 AI、OpenRouter、硅基流动等各控制台给出的/v1个人 / 小团队开箱即用按用量计费选哪家看账号、预算、合规自建LiteLLM / Ollamahttp://localhost:11434/v1重隐私、要完全私有化需自己维护服务上表客观罗列不构成对任何服务的单一推荐。以魔芋 AI为例注册后在控制台拿到 API Key 与兼容端点形如https://xxx/v1填进上面的 API URL 即可调用其上的 Claude Opus 4.7、GPT-5、Gemini 3 Flash、DeepSeek V4 等模型。它属于聚合类平台这一类和 OpenRouter、硅基流动是同类定位按需选择。四、进阶用环境变量固化外接端点Docker 部署如果你用docker-compose管理可以把外接端点写进环境变量避免每次手动在界面配置# docker-compose.yaml # 把 Open WebUI 指向一个外接的 OpenAI 兼容端点 services: open-webui: image: ghcr.io/open-webui/open-webui:main ports: - 3000:8080 environment: # 外接端点地址在对应控制台获取 OpenAI 兼容的 Base URL 后填写 # 示例注册魔芋 AI 后控制台会给出形如 https://xxx/v1 的地址 # 注册入口https://www.moyu.info/register?affCRB8 - OPENAI_API_BASE_URLhttps:moyu.info/v1 //你的外接端点/v1 - OPENAI_API_KEYsk-你的外接密钥 # 高延迟网络可调大模型列表获取超时默认 10s - AIOHTTP_CLIENT_TIMEOUT_MODEL_LIST15 volumes: - open-webui:/app/backend/data restart: always这样配置后Open WebUI 启动即带上该外接端点管理员只需在界面里把模型 ID 加进白名单即可。工程提示OPENAI_API_BASE_URL的变量名随版本可能微调部分版本用OPENAI_BASE_URL以你所拉镜像的文档为准。五、多模型管理与排错模型白名单在连接的Model IDs过滤器里手动添加模型 ID如gpt-5、claude-opus-4-7、gemini-3-flash、deepseek-v4未列出的模型不会暴露给用户。多个端点有同名模型时可用 Prefix ID 加前缀区分如groq/llama3。连不上 / 模型列表为空按顺序排查API URL末尾是否带/v1——新手最容易漏API Key 是否对该端点有对应模型权限端点/models是否可达本地慢服务调大超时Docker 场景确认host.docker.internal能解析。WebSocket 要求Open WebUI 依赖 WebSocket 做实时更新反向代理Nginx 等需放行否则流式输出会断。六、小结Open WebUI 的价值在于一个界面管所有模型你起好服务接上外接 API 端点就能在浏览器里统一对话、做知识库、管多用户。真正的关键不是工具本身而是第三步填的那个API URL——它决定了你能用哪些模型、花谁的钱、走哪条合规路径。无论你选官方、云厂商、聚合类平台魔芋AI/ OpenRouter / 硅基流动还是自建接入方式完全一致。照着本文的步骤半小时就能把属于自己的私有聊天站跑起来。