把本地模型变成可用的 AI 工作台

项目内容构成

Open WebUI 主要包括前端聊天界面、后端 API、用户与会话管理、模型连接、数据存储、插件或函数扩展等模块。它支持 Ollama，也可以连接 OpenAI API 和其他兼容服务，因此适合个人本地 AI、团队内部助手、离线知识问答等场景。

相比直接在终端里运行模型，Open WebUI 提供了历史会话、模型切换、Prompt 管理、文件交互和更完整的用户体验。对于需要本地部署的团队，它能显著降低使用门槛。

运行逻辑

用户在浏览器里发起请求后，Open WebUI 后端会根据配置把请求转发到 Ollama、本地推理服务或云端模型 API。它负责保存会话、管理用户、处理上传文件，并把模型输出流式返回给前端。

如果配合 Ollama 使用，模型权重通常保存在本机或服务器上，推理也在本地执行。这样可以减少数据外发，也便于在内网环境中搭建统一入口。

如何安装

官方 README 给出的默认 Docker 方式如下，适合 Ollama 在同一台机器上的场景：

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

只使用 OpenAI API

如果只连接 OpenAI API，可设置 OPENAI_API_KEY：

docker run -d -p 3000:8080 -e OPENAI_API_KEY=your_secret_key -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:main

使用建议

启动后访问 http://localhost:3000。生产环境需要关注用户注册策略、管理员账号、模型访问权限、数据卷备份、反向代理和 HTTPS。若连接内网模型，应限制公网暴露，避免把模型入口变成未授权 API。