Dify 安裝教學:Docker 自架實測,2 核心 4 GB 裝得起來,但硬碟要留 20 GB

部分實測2026.10.13

照 Dify 官方文件用 Docker Compose 自架,我在 2 核心、4 GB 的 Linux 主機上從零實測:167 秒裝好,起 15 個容器,映像檔 11 GB,下載途中硬碟最高多用到近 19 GB,閒置用掉約 2.7 GB 記憶體。這篇把每一步的指令和時間、預設對外開了哪些連接埠、哪些預設密碼該改都列出來。

更新 2026/10/13・約 8 分鐘讀完・查證環境:Dify 1.17.1、Docker 29.9.0、Compose 5.6.0,2026 年 10 月 13 日在雲端測試機(Ubuntu 26.04,2 核心 4 GB,x86_64)上從乾淨的系統實際跑過。安裝頁的畫面是用無頭瀏覽器讀的,沒有填任何東西。我沒有建立管理員帳號,之後的登入、接模型、建立應用都沒有測;Mac 和 Windows、網域與 HTTPS、升級也沒有測,這幾段依官方文件

先講結論

  • 官方的最低需求是 2 核心、4 GB 記憶體。我就用這個規格實測,從乾淨的 Ubuntu 到安裝頁打得開是 167 秒。
  • 硬碟比想像中吃得多。映像檔合計 11 GB,下載解壓的途中最高多用到近 19 GB,所以要留 20 GB 左右的空間。
  • 閒置就用掉約 2.7 GB 記憶體,4 GB 的主機只剩 1.5 GB 左右。要長期用,我會選 8 GB。
目錄
  1. 我的測試環境
  2. 開始之前
  3. 安裝步驟
  4. 它起了什麼
  5. 硬碟:要留 20 GB
  6. 記憶體:閒置約 2.7 GB
  7. 第一次打開會看到什麼
  8. 預設值裡要注意的三件事
  9. 停掉、再打開
  10. log 裡的幾行錯誤
  11. 升級
  12. 要租多大的主機
  13. 這篇沒有測的

Dify 的官方文件把自架寫得很短:把原始碼抓下來、複製一份設定檔、docker compose up -d。照著做確實會動。

這篇補上文件那一頁沒有的數字:它要下載多少東西、裝完佔多少硬碟、閒置用多少記憶體、預設對外開了什麼。這些是我在一台乾淨的主機上實際裝一次量到的。

還不確定 Dify 是什麼的話,先看Dify 是什麼。

我的測試環境

一台雲端上臨時開的 Linux 主機,2 核心、4 GB 記憶體、Ubuntu 26.04,系統是最精簡的版本,連 curl 都沒有。

選這個規格,是因為官方文件寫的最低需求就是 2 核心、4 GiB。我想知道最低需求是不是真的夠。

裝的是 Dify 1.17.1,2026 年 9 月 10 日發佈,是我測的當下最新的版本。

開始之前

文件對軟體的要求:

系統 需要
Linux Docker 19.03 以上、Docker Compose 2.24.0 以上
macOS 10.14 以上 Docker Desktop,虛擬機至少設 2 個虛擬 CPU、8 GiB 記憶體
Windows 開啟 WSL 2,加上 Docker Desktop

我只測了 Linux。

安裝步驟

第一步是裝幾個小工具和 Docker。文件的指令會用到 git、curl、jq 這三個,我的系統都沒有,所以先裝:

sudo apt-get update
sudo apt-get install -y curl git ca-certificates jq
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh

裝 Docker 用的是它官方的安裝腳本。Docker 自己說這個腳本適合拿來試,正式環境建議照文件用套件庫安裝;對 Docker 還不熟的話,可以先看Docker 是什麼。

第二步是把原始碼抓下來。這一行是文件的原樣,它會先去查最新的版本號,再抓那一版:

git clone --branch "$(curl -s https://api.github.com/repos/langgenius/dify/releases/latest | jq -r .tag_name)" https://github.com/langgenius/dify.git

第三步是進到 docker 資料夾,複製設定檔,然後啟動:

cd dify/docker
cp .env.example .env
sudo docker compose up -d

每一步花的時間:

步驟 時間
裝小工具 8 秒
裝 Docker 13 秒
抓原始碼 33 秒,資料夾 767 MB
docker compose up -d 108 秒
合計,到安裝頁打得開 167 秒

docker compose up -d 那 108 秒幾乎都在下載映像檔。

它起了什麼

用 sudo docker compose ps -a 看,一共 16 個服務。15 個是常駐的,另外有一個叫 init_permissions 的,設定好檔案權限就結束,狀態會顯示 Exited。文件有寫這是正常的。

15 個常駐的服務裡,Dify 自己的有七個,包括後端的 API、背景工作、網頁、外掛服務。其他八個是它需要的資料庫 Postgres、Redis、向量資料庫 Weaviate、nginx,還有幾個隔離執行程式和擋對內連線用的。

硬碟:要留 20 GB

映像檔一共 12 個,合計 11.13 GB。最大的四個:

映像檔 大小
dify-api 4.04 GB
dify-plugin-daemon 2.26 GB
dify-agent-backend 1.48 GB
dify-web 896 MB

整台主機的硬碟用量,從剛開機的 1.4 GB 變成 14.2 GB,多了大約 12.8 GB。

要注意的是途中的高點。我每 5 秒記一次硬碟用量,下載解壓的時候最高到 20.2 GB,比裝完還多 6 GB。也就是安裝過程需要將近 19 GB 的空間。

入門的 VPS 有些硬碟只有 25 GB,扣掉系統之後會很緊。

記憶體:閒置約 2.7 GB

整台主機的記憶體用量是這樣變化的:

時間點 已使用 還可用
裝好 Docker,還沒啟動 Dify 0.4 GB 3.9 GB
啟動後 1 分半 2.2 GB 2.1 GB
啟動後 3 到 4 分鐘 2.7 GB 1.5 到 1.6 GB

這是什麼都還沒做的狀態:沒有建帳號、沒有接模型、沒有任何應用。之後匯入文件、跑流程會再多用多少,我沒有量到。

啟動的那一兩分鐘,2 個核心的負載很高,系統的負載平均值到過 5。穩定之後降到 1 以下。

所以我的看法是:最低需求是真的裝得起來,但 4 GB 只剩 1.5 GB 的空間,拿來試可以,要長期用我會選 8 GB。

第一次打開會看到什麼

瀏覽器開 http://你的主機 IP/install,會看到設定管理員帳號的畫面。直接開首頁也會被帶到這裡。

畫面上有三個欄位:信箱、使用者名稱、密碼。密碼的規則寫在欄位下面:要有英文字母和數字,長度超過 8。畫面上還有一顆切換語言的按鈕,預設是英文。

底下有一行提醒,請你在開始用社群版之前先讀它的開源授權。

我是用沒有畫面的瀏覽器把這一頁的文字讀出來的,沒有填任何東西,也沒有建立帳號。所以進到後台之後的樣子,這篇沒有。

預設值裡要注意的三件事

.env.example 有 300 行、244 個設定。直接複製就能跑,但有三件事我覺得要知道。

第一,它對外開了三個連接埠。80 和 443 是網頁用的。第三個是 5003,設定檔裡的名字是外掛除錯用的連接埠,預設也對所有來源開放。用不到的話,在主機商後台的防火牆把它擋掉。要留意的是,Docker 的文件寫明,它發佈的連接埠會繞過 ufw 的規則,所以只在主機裡設 ufw 是擋不住的。

第二,資料庫和 Redis 的密碼是公開的預設值,範例檔裡寫的是 difyai123456。我測的時候,這兩個服務沒有對外開連接埠,只有 Dify 自己的容器連得到。要正式用的話,還是在第一次啟動之前改掉。

第三,SECRET_KEY 是空的。這個不用擔心,範例檔的註解寫,留空的話它會自己產生一組,存在資料夾裡。

另外,預設沒有開 HTTPS。設定檔裡 NGINX_HTTPS_ENABLED 是 false。網域和憑證要另外設定,這一段我沒有做。

停掉、再打開

改了設定要重開才會生效:

sudo docker compose down
sudo docker compose up -d

我量到 down 是 14 秒。再 up 一次,因為映像檔都在了,4 秒就結束,9 秒後網頁打得開。

但這時候還不能用。後端的 API 要到第 81 秒才開始回應,到第 99 秒 Docker 才把它標成健康。所以重開之後,網頁先出來,要再等一分半左右。

log 裡的幾行錯誤

第一次啟動的時候,我在 log 裡看到三種錯誤訊息,之後服務都正常。

外掛服務說連不到資料庫,資料庫那邊對應一行 database "dify_plugin" does not exist。

網頁說連不到 API,連線被拒絕。

沙盒服務說找不到一個相依套件的清單檔。

前兩個是別的容器還沒準備好。這三種都只在啟動的那一段出現。

升級

文件對升級只有一句話:每一版的步驟可能不一樣,請看 GitHub 的 Releases 頁上那一版的升級說明。升級我沒有實際做過。

要租多大的主機

照上面的數字,至少要 2 核心、4 GB 記憶體,硬碟我會抓 40 GB 以上,留一些給之後的資料。記憶體我會選 8 GB 的。

Hostinger 有一頁 Dify 的 Docker 範本,選了方案它幫你裝好。那一頁列的方案是從 2 核心、8 GB 的 KVM 2 開始,標價每月 8.99 美元,要一次付兩年。這條路我沒有實際走過。Dify 要選 Hostinger 哪一級方案、續約價多少,我整理在 Hostinger 評價。

想比較其他幾家,或是不想綁約,看VPS 推薦哪一家。想把 Dify 跟別的工具裝在同一台,可以用VPS 規格試算器算要多大。

這篇沒有測的

建立管理員帳號之後的所有操作:登入、接模型、建立應用、知識庫。

網域和 HTTPS。

升級到新版本。

Mac 和 Windows 的 Docker Desktop。

長時間運作的穩定度,還有實際有人在用時的記憶體用量。我的測試機一次最多開 45 分鐘。

常見問題

Dify 自架的最低規格是多少?

官方文件寫 CPU 至少 2 核心、記憶體至少 4 GiB。我用 2 核心、4 GB 的主機實測裝得起來,閒置時整台用掉約 2.7 GB。硬碟文件沒有寫,我量到安裝途中最高多用了近 19 GB。

Dify 裝好之後預設的帳號密碼是什麼?

沒有預設帳號。第一次打開 /install 這個網址,要自己設定管理員的信箱、名稱和密碼,密碼要有英文字母和數字、長度超過 8。

Dify 可以裝在 Windows 或 Mac 上嗎?

文件寫可以,都是透過 Docker Desktop。Mac 要把 Docker 的虛擬機設成至少 2 個虛擬 CPU、8 GiB 記憶體;Windows 要開 WSL 2。這兩種我沒有測,我測的是 Linux。

clone 的時候出現 Remote branch null not found 怎麼辦?

文件的說法是改用明確的版本號重試,把指令裡自動查最新版的那一段換成版本號,例如 1.17.1。版本號在 GitHub 的 Releases 頁可以查。

這篇怎麼查證的

這篇只有一部分實際跑過,其餘依官方文件整理,查證日期 2026/10/13(Dify 1.17.1、Docker 29.9.0、Compose 5.6.0,2026 年 10 月 13 日在雲端測試機(Ubuntu 26.04,2 核心 4 GB,x86_64)上從乾淨的系統實際跑過。安裝頁的畫面是用無頭瀏覽器讀的,沒有填任何東西。我沒有建立管理員帳號,之後的登入、接模型、建立應用都沒有測;Mac 和 Windows、網域與 HTTPS、升級也沒有測,這幾段依官方文件)。哪些有跑、哪些沒跑,文中各段有寫。價格與方案以官方頁面為準,工具改版後內容可能過期。