在家用机器上跑通 Open WebUI全程只需 3 条命令【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui这是一篇写给只会开浏览器的读者的 Open WebUI 本地部署教程。Open WebUI 是一个可自托管、支持离线运行的 Web 版 AI 对话平台你用 Docker把程序和依赖打包成集装箱的工具把它装到自己电脑上数据和对话记录就只留在本地。读完照做你能独立完成 Open WebUI Docker 部署接上自己的第一个模型并用它完成查文档、对比模型、文生图三件真事。第一步用 docker-compose 把 Open WebUI 跑起来目标在自己电脑上起一个本地 Web 服务浏览器打开能看到登录页。操作先确认环境里有 Docker 和 Docker Compose按 compose 文件一键拉起多个容器的工具docker --version docker compose version两条命令都输出版本号才算通过缺哪个就装哪个装完重跑验证。然后克隆仓库并启动git clone https://gitcode.com/GitHub_Trending/op/open-webui cd open-webuidocker compose up -d第一次运行会下载镜像可能要几分钟耐心等它把 open-webui 和 ollama 两个容器都拉起来。怎么算成功浏览器打开http://127.0.0.1:3000看到登录 / 注册页面。注册一个账号你是全站第一个用户自动成为管理员。第二步接入你的第一个模型目标让聊天框能真正收到回复。模型来源二选一Ollama 本地模型免费离线、首次下载稍慢或任意 OpenAI 兼容 API需 API key、响应快。方式优点代价Ollama 本地模型免费、离线、数据不出机首次要下载模型文件OpenAI 兼容 API响应快、免下载需要 API key联网付费操作Ollama 路线推荐新手compose 文件已带一个 Ollama 容器只需拉一个小模型ollama pull llama3.2回到网页顶部模型选择器出现llama3.2选中它发一句话。操作OpenAI 兼容 API 路线在docker-compose.yaml的open-webui段环境变量里加两行再重建容器参数说明OPENAI_API_KEY你的密钥OPENAI_API_BASE_URL兼容服务地址如https://api.openai.com/v1docker compose up -d docker compose ps怎么算成功任选一路给模型发用一句话介绍你自己几秒内收到回复且页面无报错。第三步用 Open WebUI 完成三件真实任务任务一拿自己的一份 PDF 提问内置 RAG左侧栏 Knowledge把一份 PDF 拖进去等待解析完成状态变为 Ready。新开聊天问一个只在这份文档里才有的事实例如某个具体条款或参数。成功判据回答内容与文档一致且回复下方出现指向该文档的引用。答得对但没有引用说明它用的是通用知识而非你的文档。任务二两个模型同屏对比回答同时接一个本地模型和一个 API 模型见第二步两种方式不互斥。开两个聊天标签分别选中两个模型发同一个开放问题。成功判据两条回答风格、长度、侧重明显不同。任务三文生图出一张图接一个支持图像生成的模型在顶部选择它。输入提示词油画风格的乡间小屋与田野。成功判据回复区直接出现图片而不是一段文字描述。第四步按需进阶配置换端口、换数据库、多用户只在你遇到对应场景时才改改完都执行docker compose up -d使配置生效。场景参数改 docker-compose.yaml效果端口冲突3000 被占用ports改为8080:8080改访问地址为http://127.0.0.1:8080原端口进程不受影响多实例部署设DB_POSTGRES_URI指向 PostgreSQL多个节点共享一份数据替代默认 SQLite 卷负载均衡多实例设REDIS_URL会话与 WebSocket 状态在多实例间同步多用户权限首个注册账号即管理员管理员可在后台给用户分配角色与权限首次启动设ADMIN_EMAIL可预置管理员怎么算成功改完访问新地址仍能看到登录页docker compose ps中各容器状态为 running。验收照着清单勾一遍http://127.0.0.1:3000打开能看到登录页并能注册管理员第一个模型发话有回复无 Connection Error上传的 PDF 能被 Knowledge 检索到回答带文档引用两个模型对同一问题给出了不同风格的回答重启容器后聊天记录和知识库仍在数据都在 Docker 卷里下一步去 docs/official.md 查你想深入的配置项想动手写工具插件时代码骨架都在 plugins/ai/ 里。【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考