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本地部署常见问题速查
⚠️ 部署卡住的情况，基本都在这几条里：
| 现象 | 可能原因 | 处理办法 |
|---|---|---|
| 启动后打不开页面 | 3000 端口被占用，或容器没跑起来 | docker ps 查看状态；端口冲突就改成 -p 8080:8080 重建 |
| 模型接上了但不回复 | Ollama 没启动或地址填错 | 先确认 Ollama 在运行，再核对管理设置里的地址 |
| 重建容器后聊天记录、设置消失 | 没挂载数据卷 | 确认命令带 -v 参数，再从之前的备份恢复 |
| 整体响应很慢 | 内存不足或模型过大 | 加 --memory 提高限额，或换个更小的模型 |
还卡住的话，仓库里有专门的 TROUBLESHOOTING.md 可以对照排查。
一句话总结：Open WebUI 是一个真能当生产力用的自托管AI平台——数据不出机器、界面熟悉、接模型灵活。如果你一直想把大模型能力放进内网或私有环境，这篇教程的命令可以直接照抄。后续接入更多模型和插件后，这个本地平台能玩的花样只会更多。
【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
