Open WebUI 从部署到上手本地 AI 平台一篇就够的实战指南【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui想让 AI 聊天平台跑在自己的机器上数据不出内网还要能接 Ollama 或任何 OpenAI 兼容 APIOpen WebUI 本地部署基本一条 Docker 命令就能完成它把聊天界面、知识库、权限和插件都做好了。这篇带你从启动到日常使用把最容易踩的坑提前说清楚。5 分钟把服务跑起来先给一条最短命令假设你的机器上已经装好 Dockerdocker run -d -p 3000:8080 \ --add-hosthost.docker.internal:host-gateway \ # 让容器内能找到宿主机上的 Ollama -v open-webui:/app/backend/data \ # 数据卷聊天记录、用户都存这里重启不丢 --name open-webui \ # 起个固定名字后面查日志、更新都靠它 --restart always \ # 容器挂了自动拉起 ghcr.io/open-webui/open-webui:main每个参数只干一件事没有一个是多余的。数据卷可以理解成给容器买了个永久停车位数据库和用户都停在那里。跑完之后打开http://localhost:3000你会看到注册页面。注册第一个账号的会自动成为管理员之后的账号默认是普通用户。界面演示多模型并行聊天与知识库怎么把你的模型接进来按你手上的条件选一条就行都只改差异部分。Ollama 就在本机上面那条命令不用动--add-host已经帮容器指到了宿主机模型装好就能在界面里看到。Ollama 在另一台机器把--add-host换成一个环境变量其余不变-e OLLAMA_BASE_URLhttp://192.168.1.10:11434只用云端 APIOpenAI、vLLM、Groq 这类 OpenAI 兼容接口不加任何 Ollama 相关参数在设置里配 API Key 和 Base URL也可以在启动时直接-e OPENAI_API_KEYxxx然后在 WebUI 设置里改 API 地址。本地和云端可以同时开着聊天时按模型切换。界面左下角的「设置 → 管理员 → 模型」里能看到所有已发现的模型看不到就说明连不上翻到最后的踩坑速查。日常会反复用到的几个功能挑四个真正高频的按你想干什么 → 去哪操作说场景操作让 AI 读懂你的文档「知识库」页面上传 PDF/网页聊天输入框#选中知识库引用让 AI 记住你的偏好「设置 → 记忆」里写入事实后续对话自动携带团队共享一个 AI 讨论区建「频道」把模型拉进来像群聊一样 它定时跑一段提示词「自动化」里配重复计划执行记录会挂到日历上另外Notes 适合放对话外的草稿支持选中文字让 AI 改写。权限体系是标准的三种角色管理员、写者、查看者在「设置 → 管理员 → 用户」里逐人分配一般小团队不用碰太深。示意本地 RAG 检索让文档成为上下文怎么让它跑得更稳普通部署只需要盯三件事密钥、内存、健康检查。-e WEBUI_SECRET_KEY换成一段足够长的随机字符串 \ # 不固定它每次重启后所有用户登录态会失效 --memory2g \ # 给容器设个内存上限别拖垮宿主机 --health-cmd curl -f http://localhost:8080/health || exit 1 \ # 容器级健康检查 --health-interval 30s/health是项目自带的接口只做存活探测它还有一个更严格的/ready会顺带检查数据库连接适合放在负载均衡器前面。日常调试嫌日志吵或想看细节进容器看日志即可一般不用额外配置。示意健康检查保证服务持续可用踩坑速查界面能打开但模型列表是空的多半是容器连不上 Ollama。docker logs open-webui看连接报错远程机器就把OLLAMA_BASE_URL指对地址个别环境加--networkhost能直接解决。重建容器后聊天记录没了启动时漏了-v open-webui:/app/backend/data。数据全在那个卷里补上再重建就能找回。3000 端口打不开页面端口被占了。lsof -i:3000看看谁在用把映射改成-p 3001:8080换个端口就行。第一次启动转圈很久首次启动要初始化数据库并拉取嵌入模型网络慢的话等几分钟是正常的第二次启动会快很多。界面提示需要 WEBUI_SECRET_KEY开启了认证但没配密钥。生成一段长随机字符串用-e WEBUI_SECRET_KEY...传入再重启容器。接下来可以试试到这里你手上应该已经有一个能聊天、能挂知识库、数据不丢的 Open WebUI 了。如果只想换台机器装源码版pip install open-webui后执行open-webui serve也能跑但 Docker 路径的升级和备份都更省心建议优先保留。下一步不妨把「自动化」配一个每天跑一次的总结任务或者在「设置 → 管理员 → 工具」里加一个 MCP 工具服务器感受一下它把 AI 接进工作流的能力。【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考