
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 任选已装 DockerCPU 双核内存 4GB建议 8GB磁盘剩余 10GBDocker 20.10 及以上环境没问题后下面这条命令就能用 Docker 装好 Open WebUI其中-v参数挂载数据卷让聊天记录和设置都存得住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✅ 浏览器打开 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_EMAILadminexample.com -e WEBUI_ADMIN_PASSWORDChangeMe! \ -v open-webui:/app/backend/data --name open-webui --restart always \ ghcr.io/open-webui/open-webui:main服务器是共享的就在 docker run 里加--memory8g --cpus2给 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),仅供参考