type
Post
status
Published
date
Mar 18, 2025
slug
deepseek-webui-self-hosting
summary
我从学习者角度重新整理 DeepSeek WebUI 自部署:如何理解 Ollama、Open WebUI、本地模型服务和排查思路。
tags
LLM
工具
开发
category
LLM
icon
password
💡
这篇是我重新整理 DeepSeek WebUI 自部署时的学习笔记。最开始我只记了两句话:open-webui serve 和保证 Ollama 运行。现在回头看,真正值得记录的不是命令本身,而是我如何理解“本地模型 + Web UI + 数据留在自己机器上”这套工作流。
我最开始关注 DeepSeek WebUI,是因为我想把大模型从“网页上的一个聊天框”变成自己电脑里可以长期使用的工具。直接用云端模型当然方便,但当我想测试私有文档、临时代码、学习笔记或者一些本地资料时,本地部署会让我更有掌控感。
对我来说,自部署至少解决了三个问题:
  • 隐私边界更清楚:很多内容不一定适合直接发到外部平台,本地运行能减少不必要的数据外流。
  • 实验成本更可控:我可以反复测试不同模型、提示词和参数,不必每一步都考虑调用费用。
  • 学习链路更完整:从模型下载、服务启动、接口连接到 Web UI 使用,整个过程能帮助我理解大模型应用背后的真实结构。

⚙️ 二、我先把系统拆成两层

我现在会把这套系统理解成两层:
  1. Ollama 负责模型运行:它像一个本地模型服务,把 DeepSeek、Qwen、Llama 等模型以 API 的形式跑起来。
  1. Open WebUI 负责交互界面:它提供网页聊天界面、模型管理、会话记录、插件、RAG 等能力,让本地模型更接近日常可用产品。
这也是我之前那句“保证 Ollama 运行”的真正含义。Open WebUI 本身不是模型,它需要连接到一个模型后端。Ollama 默认 API 地址通常是 http://localhost:11434,Open WebUI 启动后会尝试连接这个服务。

🧪 三、我会怎么从零跑起来

如果只是本地学习,我会先用最简单的路径验证:
然后拉取一个可用模型,例如:
再启动 Open WebUI:
如果使用 Python 安装方式,官方文档里的路径大致是:
启动后访问 http://localhost:8080。如果使用 Docker,Open WebUI 官方更推荐容器化方式,因为依赖隔离、数据卷和长期运行会更稳定。

🧩 四、我踩坑时会优先检查什么

自部署最容易卡住的地方,通常不是模型本身,而是服务之间没有连上。我会按这个顺序检查:
  • Ollama 是否真的运行:浏览器或命令行能否访问 localhost:11434
  • 模型是否已经下载:没有模型时,WebUI 能打开但无法正常对话。
  • 端口是否冲突:Open WebUI 默认端口可能和已有服务冲突。
  • Docker 网络是否正确:容器里的 localhost 不等于宿主机的 localhost,这时需要配置 host.docker.internalOLLAMA_BASE_URL
  • 模型能力是否匹配任务:小模型能跑通流程,但复杂推理、代码生成和长上下文任务不一定稳定。
我现在更愿意把这些坑看成系统学习的一部分。只要知道每一层负责什么,排查时就不会只盯着报错信息乱试命令。

🔐 五、本地部署不等于天然安全

本地部署会增强掌控感,但不代表可以完全放松。比如 WebUI 如果暴露到公网,就需要考虑账号、权限、反向代理、HTTPS、访问控制和数据备份。模型本地运行也不代表输出一定可靠,尤其是涉及代码、医疗、法律、金融类内容时,仍然需要人工校验。
我会把本地 DeepSeek WebUI 当成一个学习和辅助工具,而不是一个可以自动替我做决定的系统。它适合帮我整理资料、解释代码、生成草稿、做初步实验,但最终判断还是要回到人。

🧠 六、这件事给我的启发

这次重新整理后,我最大的收获是:大模型应用不是只有模型本身。一个真正可用的个人 AI 工作台,至少需要模型运行层、交互层、数据层、权限层和评测习惯。
DeepSeek WebUI 自部署是一个很好的入口,因为它足够具体:我可以看到服务怎么启动、模型怎么接入、页面怎么调用、数据怎么保存。把这些都跑通后,我再去理解 AIPC、本地 Agent、RAG、私有知识库,会更容易建立整体框架。

📎 参考资料

🚀
下一步我想继续试的是:把本地 Open WebUI 和自己的学习笔记、代码仓库、常用工具连接起来,看看它能不能从一个聊天界面逐渐变成真正的个人 AI 工作台。
MCP 课程学习笔记:我如何理解工具、上下文和 AgentDeepSeek 模型复现:我会从哪里开始
Loading...