Open WebUI 是自托管 AI 网页平台，可连接 Ollama、OpenAI 兼容接口，并管理用户、知识库和工具。模型能力、费用和数据去向仍由所连接的后端决定。
Docker 和 Python 怎么选
- Docker：官方推荐多数用户使用，也有普通、CUDA 和内置 Ollama 等镜像标签。
- Python：适合能维护环境的用户，官方 README 当前提示使用 Python 3.11。
- Kubernetes：面向已有集群、存储和监控体系的团队。
Docker 部署最容易漏什么
官方命令中的 /app/backend/data 持久化卷保存数据库和应用数据，漏挂载会在重建容器时丢失内容。生产环境应固定正式版本，不长期跟随 dev 或 main 镜像。
首个账号和密钥
第一个创建的账号会获得管理员权限，不能先把空白实例暴露到公网再注册。WEBUI_SECRET_KEY 可避免容器重建后会话失效；该密钥应随机生成并安全保存。
Ollama 连接失败怎么办
容器内的 127.0.0.1 指向容器自身，不一定是宿主机 Ollama。应按官方文档使用 host.docker.internal 或明确地址，并限制远程 Ollama 的网络访问。不要为排错把 11434 或管理端口开放给互联网。
公网部署检查清单
- 关闭不需要的公开注册，启用强密码、最小角色权限和 HTTPS。
- 备份数据卷、数据库、上传文件与配置，并实际验证恢复。
- 插件、Tools、MCP、终端和知识库可能访问文件或外部服务，应按用户和模型限制权限。
- API Key 通过受保护的环境变量或后台配置保存，不出现在命令历史、截图和日志。
- 升级前阅读迁移说明；多 Worker 环境要遵守官方单 Worker 数据库迁移要求。
当前许可证要注意什么
当前代码包含 Open WebUI License 和历史许可证内容。现行许可证限制改变 Open WebUI 品牌，并列出不超过 50 名终端用户等例外。换品牌、分发或大规模商用前应核对 LICENSE、LICENSE_HISTORY 或企业许可。
部署结论
个人用户先在本机用 Docker 和持久化卷测试，连接一个模型后端；团队上线前固定版本，并补齐管理员、密钥、HTTPS、权限和备份。离线环境还要预下载模型与依赖。
