從零開始之Dify部署篇
寫給技術(shù)小白的先修知識
基礎(chǔ)概念速覽
-
?GitHub是什么 ?
可以理解為「代碼的網(wǎng)盤」，開發(fā)者們在這里存放和共享代碼（比如微信的源代碼）。我們通過GitHub下載Dify的代碼，就像從網(wǎng)盤下載文件一樣簡單。用到的下載工具git：可以理解為「網(wǎng)盤軟件」，開發(fā)者通常使用這個軟件下載代碼到本地
?Docker是什么?
想象成「軟件集裝箱」，把應(yīng)用程序和它需要的環(huán)境打包成一個標(biāo)準(zhǔn)箱子（容器），這樣無論用Windows/Mac都能正常運行，避免出現(xiàn)"我電腦上好好的啊"這類問題。
一、工具列表（小白友好版）
你需要準(zhǔn)備的"工具包"
?Docker Desktop?
一個管理"軟件集裝箱"的調(diào)度中心，負責(zé)下載、運行Dify的容器（類似安卓手機的應(yīng)用商店）?Git客戶端?
代碼下載工具，相當(dāng)于專門從GitHub下載代碼的
小提示：跟著教程操作就像組裝宜家家具，按步驟來就能完成！
二、搭建流程（含小白注解）
1. 安裝Docker Desktop
訪問 Docker官網(wǎng) 點擊Download Docker Desktop
# 這串命令就像魔法咒語，在黑色窗口（命令提示符）里輸入就能檢查安裝是否成功
docker --version
2. 配置鏡像加速（給下載加速）
國內(nèi)訪問Docker官方倉庫就像看YouTube需要梯子，配置鏡像源相當(dāng)于使用"國內(nèi)鏡像網(wǎng)站"：
右鍵點擊桌面的??小鯨魚圖標(biāo)
選擇「Settings」→ 「Docker Engine」
在編輯框里粘貼這段代碼：
{
"builder": {
"gc": {
"defaultKeepStorage": "20GB",
"enabled": true
}
},
"experimental": false,
"registry-mirrors": [
"https://docker.hpcloud.cloud",
"https://docker.m.daocloud.io",
"https://docker.unsee.tech",
"https://docker.1panel.live",
"http://mirrors.ustc.edu.cn",
"https://docker.chenby.cn",
"http://mirror.azure.cn",
"https://dockerpull.org",
"https://dockerhub.icu",
"https://hub.rat.dev",
"https://proxy.1panel.live",
"https://docker.1panel.top",
"https://docker.m.daocloud.io",
"https://docker.1ms.run",
"https://docker.ketches.cn"
]
}
3. 獲取Dify代碼
在你想要加載代碼的文件夾（比如H:\dify）鼠標(biāo)右擊“在終端中打開”，如圖所示（圖中已加載完）
git clone https://github.com/langgenius/dify.git
# 這就像告訴電腦："去GitHub把最新版Dify代碼下載到本地文件夾"
如圖是加載的過程
輸入命令進入到項目文件夾中
cd dify/docker
4. 啟動系統(tǒng)
# 生成配置文件（就像拆包裝的說明書）
cp .env.example .env
docker compose up -d
# 相當(dāng)于按下「開機鍵」，啟動Dify需要的所有服務(wù)（數(shù)據(jù)庫、后臺程序等）
需要等待幾分鐘，等到如下圖所示之后，證明已經(jīng)開啟完畢
瀏覽器輸入http://localhost/install，填寫郵箱、 賬號和密碼，然后登錄就大功告成。
小白常見困惑解答
Q1：為什么要用命令行？
答：就像開車需要方向盤，命令行是與計算機深度交互的工具。不過別擔(dān)心，跟著教程復(fù)制命令即可。
Q2：docker compose 是什么？
答：可以理解為「批量啟動器」，一次性啟動Dify需要的所有組件（類似手機快捷指令）
Q3：遇到報錯怎么辦？
答：90%的錯誤可通過以下三步解決：
- 檢查是否復(fù)制了完整命令
- 重啟Docker Desktop
- 重新執(zhí)行上一步操作
記?。翰渴疬^程就像拼樂高，只要嚴格按照步驟操作，最終一定能看到成果！遇到問題隨時回看這個指南~
三、配置大模型
配置流程
1.1. 獲取API密鑰
登錄deepseek → 右上角【API開放平臺】 → API keys → 創(chuàng)建API key → 復(fù)制 （沒有額度需要先充值）
1.2. 記錄模型ID
找到圖中框出來的內(nèi)容里model="xxx" 引號里的即為model ID
2.1. 有平臺可以白嫖deepseek
獲取API密鑰
登錄布爾算力 → 鼠標(biāo)懸停頭像 → 點擊API密鑰 → 新建API密鑰 → 然后點擊密鑰復(fù)制
2.2. 記錄模型ID
進入模型廣場 → 點擊任意一個模型，在彈出詳情框復(fù)制「Model ID」
3. Dify配置步驟
記事本打開之前創(chuàng)建的配置文件 .env，進行修改
VOLC_ACCESS_KEY=你的API密鑰
VOLC_MODEL_ID=你的模型ID
將上面的加入到文件的頭兩行（注意把自己的API密鑰復(fù)制過去），如圖所示
