快捷導(dǎo)航

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

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

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

安裝Docker

訪問Docker官網(wǎng)

Docker: Accelerated Container Application

選擇合適的版本進(jìn)行下載安裝

按照默認(rèn)情況安裝即可

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

配置&檢查

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

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

wsl --set-default-version 2

wsl --update --web-download

安裝/更新wsl2后重啟電腦，進(jìn)入Docker

選擇跳過登錄直接進(jìn)入Continue without signing in

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

Open WebUI

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

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

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

部署Open WebUI

通過docker run命令在本地主機(jī)進(jìn)行快速部署

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

部署完成結(jié)果如下

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

復(fù)制對應(yīng)的地址

http://localhost:3000/

進(jìn)入UI界面，開始使用

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

確認(rèn)更新消息

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

部署效果

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