Open WebUI 快速上手指南:免费部署本地 AI 聊天平台的 4 个步骤

📅 发布时间:2026/8/28 10:21:40
Open WebUI 快速上手指南:免费部署本地 AI 聊天平台的 4 个步骤 Open WebUI 快速上手指南免费部署本地 AI 聊天平台的 4 个步骤【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui很多人第一次用大模型都要先注册一个云服务、担心对话内容上传到外部还要在网页和命令行之间来回切换。Open WebUI 就是为了解决这个问题它是一个开源、自托管的 AI 聊天平台把本地 Ollama 模型和兼容 OpenAI 协议的 API 装进一个浏览器界面里部署完成即可完全离线使用不依赖任何第三方服务。 为什么值得试试数据不出内网聊天、文档、知识库都存在你自己机器上断网也能用一个界面接所有模型本地 Ollama、vLLM、OpenAI 兼容 API 混着用切换只是换个下拉菜单免费开源个人使用零成本也可用 Docker、pip 多种方式部署比命令行省心得多同样是接 Ollama它提供完整的聊天界面、账号体系和知识库不用再写脚本拼请求 准备工作一台安装了DockerDocker Desktop 或 Docker Engine的电脑Linux、macOS、Windows 均可端口 3000 未被占用后面可改有网络下载镜像模型可选本地 Ollama 或任意 OpenAI 兼容 API硬件有独显体验最佳纯 CPU 跑小模型也完全可行 一键部署步骤从拿到代码到跑起来最短路径就三步git clone https://gitcode.com/GitHub_Trending/op/open-webui cd open-webui docker compose up -d第 1 行把 Open WebUI 项目代码克隆到本地第 2 行进入项目目录第 3 行一条命令同时启动 Ollama 和 Open WebUI 两个容器完成后浏览器打开http://localhost:3000按提示注册第一个账号它会自动成为管理员再在界面上拉取或连接一个模型就可以开聊了。️ 跑起来之后选模型、开聊天顶部下拉框切换模型左侧管理历史会话和文件夹。你平时 90% 的使用场景——提问、追问、换模型——都在这里完成。把文档变成知识库上传 PDF、网页到知识库聊天时在输入框输入#引用某个知识库AI 会基于你的文档回答而不是凭空编造适合用来问手册、合同、笔记这类私有资料。多模型同场对比一个对话里可以同时挂多个模型同一个问题并排回答。选型阶段用它横向对比输出质量比单模型试错快得多。语音输入与跨会话记忆输入框自带麦克风按钮说话转文字直接发送开启记忆功能后AI 会把关于你的事实带到下一次对话里省去反复自我介绍。⚙️ 进阶调优多人共用时首个注册账号即管理员登录后在管理面板配置用户组与权限避免所有人都能改配置换模型服务地址Ollama 不在本机时改 docker-compose.yaml 里的OLLAMA_BASE_URL指向对应服务器即可确认配置项行为大部分行为开关都有环境变量具体含义可以看 config.py⚠️ 常见坑现象页面能打开但提示连不上模型服务器 →解决容器内访问不到宿主机的 Ollama给容器加--networkhost或确认 compose 里的host.docker.internal映射生效现象重启容器后聊天记录、知识库全丢 →解决务必挂载数据卷-v open-webui:/app/backend/data数据才会持久化现象提示 3000 端口被占用 →解决把端口环境变量OPEN_WEBUI_PORT改成空闲端口现象完全离线的机器启动后一直尝试下载模型卡住 →解决设置环境变量HF_HUB_OFFLINE1强制离线模式装好 Open WebUI 之后本地大模型才算真正长进了你的日常工作流。✅ 对话、文档、记忆全部存在本地隐私可控✅ 浏览器即客户端手机电脑通用无需额外装 App✅ 模型随时可换本地和云端 API 自由切换✅ 免费开源Docker 一条命令即可复现现在打开终端把上面那三条命令跑一遍十分钟后你就能和自己的模型聊天了。【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考