通過Docker為本地DeepSeek-r1部署WebUI界面的完整教程

更新時間：2025年02月09日 12:03:02 作者：F_D_Z

本文詳細介紹了如何通過Docker安裝并配置OpenWebUI,一個功能豐富的自托管Web用戶界面,用于與大型語言模型交互,文章步驟包括安裝Docker、配置WSL2、使用dockerrun命令部署OpenWebUI,并提供了詳細的命令解釋和部署結果,需要的朋友可以參考下

安裝Docker

訪問Docker官網

Docker: Accelerated Container Application

選擇合適的版本進行下載安裝

按照默認情況安裝即可

打開命令行，鍵入docker，如顯示以下信息說明Docker安裝成功

配置&檢查

安裝完成后，在“啟用或關閉Windows功能中”，啟用”適用于Linux的Windows子系統(tǒng)” 、”虛擬機平臺”

使用管理員權限打開命令提示符，安裝/更新wsl2：

wsl --set-default-version 2

wsl --update --web-download

安裝/更新wsl2后重啟電腦，進入Docker

選擇跳過登錄直接進入Continue without signing in

左下角Engine running說明一切正常，可以進行圖形化界面的部署

Open WebUI

Open WebUI 是一個開源的、功能豐富的自托管 Web 用戶界面，專為與大型語言模型（LLMs）交互而設計，與chatgpt界面相似。它支持完全離線運行，兼容多種 LLM 運行器，如 Ollama 和 OpenAI API，并提供直觀的聊天界面。其功能強大，支持 Markdown 和 LaTeX、本地 RAG 集成、多語言、多模型對話、網絡搜索和圖像生成集成，還具備語音和視頻通話功能，滿足多樣化需求。

Open WebUI 的部署方式靈活，支持通過 Docker 或 Kubernetes 快速安裝，界面響應式設計適配桌面和移動設備。它為開發(fā)者、研究者和企業(yè)提供了便捷的 AI 應用部署和訪問方式，尤其適合對數(shù)據隱私要求較高的場景，能夠快速搭建生成式 AI 應用，具有不錯的用戶體驗。

https://github.com/open-webui/open-webui

部署Open WebUI

通過docker run命令在本地主機進行快速部署

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

docker run：用于創(chuàng)建并啟動一個新的 Docker 容器。
-d：表示以后臺模式運行容器，容器在后臺運行，不會阻塞終端。
-p 3000:8080：將容器內的8080 端口映射到宿主機的 3000 端口。這意味著你可以通過訪問宿主機的 3000 端口來訪問容器內運行的應用（默認是 Open WebUI 的 Web 界面）。
--add-host=host.docker.internal:host-gateway：在容器的 /etc/hosts 文件中添加一個條目，將 host.docker.internal 映射到宿主機的網關地址。這通常用于在容器內部訪問宿主機上的服務，確保容器能夠與宿主機進行通信。
-v open-webui:/app/backend/data：將宿主機上的一個名為 open-webui 的卷（如果不存在則會自動創(chuàng)建）掛載到容器內的 /app/backend/data 目錄。這用于持久化存儲容器內的數(shù)據，例如模型文件、配置文件等，即使容器被刪除，數(shù)據也不會丟失。
--name open-webui：為容器指定一個名稱，這里是 open-webui。這樣可以通過名稱來管理容器，例如使用 docker stop open-webui 來停止容器。
--restart always：設置容器的重啟策略為“始終重啟”。這意味著無論容器因何種原因停止，Docker 都會自動重新啟動它。
ghcr.io/open-webui/open-webui:main：指定要運行的 Docker 鏡像。這里使用的是ghcr.io/open-webui/open-webui 鏡像的 main 標簽，表示從 GitHub Container Registry 獲取最新的主分支版本。

部署完成結果如下

部署完成后，在Docker的Containers中可以看到Open WebUI

復制對應的地址

http://localhost:3000/

進入UI界面，開始使用

創(chuàng)建管理賬戶，設置賬號，郵箱，密碼

確認更新消息

隨即可在瀏覽器中使用，進一步可通過cpolar進行內網穿透以供大規(guī)模公網訪問

部署效果

基于本地部署的 DeepSeek 能提供高度的靈活性和定制化能力，支持多語言、可擴展的插件功能，能夠根據用戶需求優(yōu)化性能和配置。此外，本地部署無需支付訂閱費用，降低了長期使用成本，同時用戶完全自主控制模型運行和數(shù)據管理，避免外部服務中斷風險。適用于創(chuàng)意寫作、企業(yè)知識管理、教育研究等多種場景，能夠高效利用本地資源，實現(xiàn)高性能和低延遲的交互體驗。