Open WebUI 安装与本地部署：一条 Docker 命令跑通自托管 AI 聊天界面-北京尧图网络

Open WebUI 安装与本地部署一条 Docker 命令跑通自托管 AI 聊天界面【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webuiOpen WebUI 是一个自托管的 AI 聊天平台给 Ollama、OpenAI 兼容接口这类模型后端套上开箱即用的网页界面并且可以完全离线运行。如果你正在做 Open WebUI 本地部署这篇按实际操作顺序走装好、验证跑通、把模型接上全程只依赖两三条命令。动手前环境与安装方式怎么选环境要求很轻Docker 或 Python 3.11 二选一即可有 NVIDIA 显卡的话再加装 NVIDIA 容器工具包。两条路一句话选型——Docker适合大多数人一条命令起服务依赖都在镜像里备好了本教程以此为主线pip适合已有 Python 环境的开发者pip install open-webui之后运行open-webui serve默认端口同为 8080。安装 Open WebUIDocker 推荐路径假设 Ollama 已装在宿主机上默认监听 11434 端口直接执行docker run -d -p 3000:8080 --add-hosthost.docker.internal:host-gateway \ -v open-webui:/app/backend/data --name open-webui --restart always \ ghcr.io/open-webui/open-webui:main关键参数一行说清-p 3000:8080把容器内 8080 映射到本机 3000--add-host让容器能用 host.docker.internal 找到宿主机的 Ollama-v open-webui:/app/backend/data把数据库和上传文件放进命名卷避免数据随容器消失--restart always保证重启机器后服务自动拉起。如果只走 OpenAI 兼容 API、不用 Ollama在上述命令里补一个-e OPENAI_API_KEY你的密钥即可其余参数不动。✅ 首次运行验证怎么确认装好了浏览器打开 http://localhost:3000看到注册页面就说明服务已经正常注册第一个账号——它会自动成为管理员。登录后检查两点左侧能列出 Ollama 里的模型说明前后端已打通随便发一句消息能出流式回复整条链路就算跑通了。页面白屏或报错时先docker logs -f open-webui看日志再往下查。⚙️ 关键配置只动必须动的三项Ollama 不在本机时改 OLLAMA_BASE_URL在 docker run 中加-e OLLAMA_BASE_URLhttps://你的Ollama地址末尾不带 /就能指向远程服务器。只用 OpenAI API 时加 OPENAI_API_KEY同一个-e参数解决界面里即可选用 OpenAI 系模型。端口想换就换容器内固定 8080只改映射的左侧端口例如-p 8080:8080。向量库、数据库、RAG 等其余配置都有默认值先用默认跑起来之后在管理后台按需调整。按需进阶GPU、离线与一体化镜像场景有 NVIDIA 显卡想让本地推理更快镜像标签换成:cuda并加--gpus allLinux/WSL 需先装 NVIDIA 容器工具包。场景机房完全断网启动前导出HF_HUB_OFFLINE1阻止服务尝试从 Hugging Face 拉取模型。场景连 Ollama 都还没装改用官方一体化镜像:ollama它把 Ollama 打包进同一容器再挂一个-v ollama:/root/.ollama保存模型文件省掉单独安装 Ollama 的步骤。️ 常见问题快查现象界面提示连不上 Ollama 服务器→ 容器里的 127.0.0.1 是容器自己而非宿主机。改用 host 网络模式重建容器docker run -d --networkhost ...同时指定OLLAMA_BASE_URLhttp://127.0.0.1:11434此时访问地址变为 http://localhost:8080。现象3000 端口被占用容器起不来→ 把映射端口换成空闲的如-p 8080:8080。现象重建容器后聊天记录没了→ 多半漏挂了数据卷。确认启动命令里有-v open-webui:/app/backend/data并复用同一个卷名。现象离线环境启动卡住、日志刷模型下载超时→ 设置HF_HUB_OFFLINE1后重启容器。继续深入装好只是开始RAG 知识库、分组权限、插件与 MCP 工具都能在管理后台逐项开启安全策略详见 docs/SECURITY.md想改行为而不只是改配置可以直接读 AI 功能的后端源码 backend/open_webui/。【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

Open WebUI 安装与本地部署：一条 Docker 命令跑通自托管 AI 聊天界面

相关推荐

把模型部署的内存压到 1/4：Hermes Agent 的量化与剪枝两条路

嵌入式DevOps落地实践：从固件版本管理到OTA安全分发

JVM垃圾回收实战：从监控到调优的完整指南

更多资讯

工务段需要电工证吗内部消息告诉你怎么转证

外省电工证能转过来吗？办理电工证步骤和考前押题全解析

高压电工作业行业前景：多久拿证才能上岗？实操考试心里没底怕挂科

考电工证什么步骤最难内部消息揭秘培训与考试难点

物业电工高薪需电工证怎么考？电子证书怎么查？一文讲清

电工证襄阳到哪里学习，复审多少钱？证书过期了不知道怎么复审延期

今日更新

河南特种工八大员含金量高吗？别被中介坑了，这些关键点你要知道

电工证ps软件多少钱？工地太忙根本没时间复习考试怎么办

牡丹江报考高压电工证在哪考？新手避坑指南

本周精选

安监局电工证分数查询怎么查才能知道含金量高不高

新疆电工作业干活累吗良心建议助你避开考不过的坑

中牟县电工证怎么报名外省证能转吗

本月热门

面向复杂光照与角度的宠物面部识别鲁棒性增强策略

基于DRV8818与STM32的双极步进电机驱动方案实战解析

DRV8818PWPR+PIC18F45K80双极步进电机控制方案实战

读完文章，想聊聊您的网站？