5分钟跑起来Open WebUI：自托管AI平台本地部署完整教程

5分钟跑起来Open WebUI：自托管AI平台本地部署完整教程

【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui

你有没有把业务文档传到线上AI工具里、心里发虚？或者公司内网，根本连不上大模型服务？Open WebUI 是一款开源的自托管AI平台，一条 Docker 命令就能本地部署，数据全部留在自己的机器上，不出内网。

为什么选自托管AI而不是云服务

云端AI方便，但你敲下的每一句话都是数据在出机器。自托管部署后，模型、对话、文件全部跑在你自己的服务器上，断网照样能用。这对金融、医疗、科研这类数据要求严格的内网环境很合适。你能决定接哪个模型、给哪些人开权限、把哪些文件放进知识库，主动权全在自己手里。

一条Docker命令完成Open WebUI安装

先花两分钟确认机器满足基本条件，下面两条命令查 Docker 版本、内存和磁盘：

docker --version free -h && df -h .

最低配置要求很低，达到即可：

• 系统：Linux / macOS / Windows 任选（已装 Docker）
• CPU 双核，内存 4GB（建议 8GB），磁盘剩余 10GB
• Docker 20.10 及以上

环境没问题后，下面这条命令就能用 Docker 装好 Open WebUI，其中-v参数挂载数据卷，让聊天记录和设置都存得住：

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

✅ 浏览器打开 localhost:3000，注册一个账号就能开始聊。想改源码的开发者也可以直接 clone 仓库从源码安装。

Open WebUI部署后能做什么：三个日常场景

日常对话这块，界面就是熟悉的聊天窗口：左侧是历史和文件夹，中间是消息流。写文案、头脑风暴、解释代码，跟普通聊天软件一样，没有学习成本。

页面顶部可以接多个模型：本地的 Ollama，或 vLLM、LMStudio 等任何 OpenAI 兼容服务。什么任务用什么模型，同一个界面里切换，不用来回换工具。

要干活还有进阶工具：内置代码解释器可以直接跑代码，把公司文档传进本地 RAG 知识库就能直接提问，内置功能不够时还能装插件扩展。

Open WebUI配置要点：部署后必做的三件事

💡 第一件最容易被忽略，是数据持久化。安装命令里的-v open-webui:/app/backend/data就是关键，卷还在，删了容器重建也不丢历史。漏加的话，先把容器里 backend/data 的数据拷到宿主机目录再重建容器。卷里就几个文件，每周打包一次、存到别的机器即可：

docker run --rm -v open-webui:/source -v /backup/open-webui:/target \ alpine tar -czf /target/backup-$(date +%Y%m%d).tar.gz -C /source .

服务要对团队开放时，建议启动时就设好管理员邮箱和密码，这是访问安全的底线：

docker run -d -p 3000:8080 \ -e WEBUI_ADMIN_EMAIL=admin@example.com -e WEBUI_ADMIN_PASSWORD=ChangeMe! \ -v open-webui:/app/backend/data --name open-webui --restart always \ ghcr.io/open-webui/open-webui:main

服务器是共享的，就在 docker run 里加--memory=8g --cpus=2，给 Open WebUI 的资源用量封顶，避免挤占其他服务。

Open WebUI本地部署常见问题速查

⚠️ 部署卡住的情况，基本都在这几条里：

还卡住的话，仓库里有专门的 TROUBLESHOOTING.md 可以对照排查。

一句话总结：Open WebUI 是一个真能当生产力用的自托管AI平台——数据不出机器、界面熟悉、接模型灵活。如果你一直想把大模型能力放进内网或私有环境，这篇教程的命令可以直接照抄。后续接入更多模型和插件后，这个本地平台能玩的花样只会更多。

【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui