01 · 先安装 Ollama 或准备 API Key
优先阅读 README、Release 和 Issues，确认当前版本是否稳定。
部署路径
先跑通最小示例，再接真实资料和公网服务。不要把生产数据、客户资料或密钥直接放进第一次测试环境。
02 · 用 Docker 启动 WebUI
记录环境、依赖、参数和失败原因，后续才能复现和交接。
03 · 设置模型、用户和访问权限
记录环境、依赖、参数和失败原因，后续才能复现和交接。
04 · 确认日志、上传文件和公网暴露风险
记录环境、依赖、参数和失败原因，后续才能复现和交接。
常见错误
先用最小样例定位问题，再提交复现材料。AI旗页会优先处理能复现、有版本号和日志的下载或部署反馈。
Docker 启动后页面打不开
先看端口是否被占用、防火墙是否放行，再检查容器日志和反向代理配置。不要直接把测试容器暴露到公网。
模型或 API Key 配好后仍然报错
核对模型名称、Base URL、Key 权限、余额和地区限制；把报错时间、请求模型和截图一起提交。
更新版本后旧数据不可用
升级前先备份数据库、配置文件和上传目录；跨大版本升级必须先读 Release 说明。
站内下载前检查
AI旗页不会在 License、版本和安全校验不完整时开放下载。下面是当前项目进入下载区前必须补齐的字段。
下载状态暂不开放下载
Release 版本待绑定 Release 版本
SHA256待生成
安全检查安全检查待处理
后台审核2026-05-18 05:51:43
缺项提醒Release 版本、SHA256、安全检查、下载状态
开放下载必须齐全
- 原始仓库与作者来源
- Release 版本号
- SHA256 校验值
- License 与 NOTICE
- 依赖安全检查
- 部署教程与回滚说明
反馈下载问题请提供
- 项目名称：Open WebUI
- 涉及版本：待绑定 Release 版本
- 问题类型：无法下载、校验不一致、压缩包损坏、部署文档缺失或依赖报错
- 复现信息：浏览器、系统、报错截图、下载时间和网络环境
暂不开放站内下载
当前许可证信息不明确，必须先核对仓库 LICENSE、Release、依赖和作者说明，再决定是否提供下载。
当前许可证信息不明确，必须先核对仓库 LICENSE、Release、依赖和作者说明，再决定是否提供下载。
替代项目
开源项目选型不应该只看一个仓库。建议用同一份任务材料横向比较部署成本、License、文档质量和长期维护。