SSD Nodes Learn Hosting plans →
指南 Matt Connor作者: Matt Connor

如何在 VPS 上用 Docker Compose 自架 n8n Nod

依照本文在 VPS 安裝 n8n 團隊的 Nod Apache-2.0 agent,使用 Docker Compose 固定版本,將埠 4310 保持私有,並在正式使用前備份 Vault key。

Nod 是什麼,以及你要建置的內容

Nod 是由 n8n 團隊開發的個人 AI agent。你可以使用其專屬 repository 中的 Docker Compose kit,將 Nod 執行於 VPS。這份指南將 kit 固定在 tag nod-v0.8.1,並讓應用程式使用私有埠。你可以透過 SSH tunnel 或 HTTPS 存取 Nod。備份步驟是安裝流程的一部分,因為沒有其中一把 key,就無法復原已儲存的憑證。

README 將 Nod 描述為擁有自己電腦與瀏覽器的 agent:「它會在真實網站上追蹤發票、準備通話內容,以及取消試用服務。它會在你的機器上執行,使用你選擇的 model,並在代表你執行操作前先詢問。」你可以在單一聊天介面中與它互動。它擁有自己的 Linux workspace 與瀏覽器,並可連線至 Gmail、Calendar、Slack、Notion 和網路。

在安裝前,請先了解兩項限制。第一,README 將 Nod 標示為「研究預覽版」。文件網站也顯示「Early preview」橫幅,並寫著「請預期仍有粗糙之處及不相容變更。」第二,README 表示 Nod 的安全檢查「取決於 model 的判斷」。請將它視為預覽工具。只授予它你願意用於測試的帳戶存取權。

VPS 適合執行 Nod,原因很直接。文件指出,只有在執行 Nod 的機器開機時,排程才會執行。筆記型電腦會進入睡眠。伺服器則不會。

Nod 與 n8n AI Agent 工作流程的差異

Nod 不是 n8n AI Assistant,執行 Nod 也不需要 n8n。README 對「我需要 n8n 嗎?」的回答是:「不需要。Nod 是獨立的應用程式,由 n8n 背後的團隊打造。它不是 n8n AI Assistant。」

n8n 文件對 AI Agent 節點的描述如下:「連接聊天模型與一或多個工具,代理程式會決定要呼叫哪些工具來完成工作。」您必須在 n8n 編輯器中建立該代理程式,並至少連接一個工具子節點。如果您要完成的是這項工作,請參閱 在 n8n 中建立 AI Agent 節點工作流程。使用 Docker 和 HTTPS 在 VPS 上自行託管 n8n則會提供可用來建立該工作流程的 n8n 伺服器。

以下是我們對這兩組文件的解讀。AI Agent 節點是您在 n8n 中逐一設計節點所建立的單一代理程式。Nod 則是具備自身工作區與瀏覽器的完整聊天應用程式,您可以用一般語言交派工作。沒有任何供應商頁面直接比較兩者,因此請將這段內容視為摘要,而非官方立場。

兩者可以搭配使用。Nod 的 n8n 頁面寫道:「連接一次您的 n8n,之後在聊天中以名稱提出要求。」接著,Nod 可以建立「具備您指定工具與頻道的 n8n Agent」。如果您的要求未提及 n8n,Nod 會使用自身的工作與排程。

授權條款:Nod 採用 Apache-2.0,n8n 則否

Nod 的儲存庫 github.com/n8n-io/nod 採用 Apache License 2.0,著作權持有人為 n8n GmbH。README 頁尾寫著「Copyright 2026 n8n GmbH · Apache License 2.0」。隨附的第三方資產,例如 Geist 字型、供應商標誌與桌面執行階段元件,則各自適用其原有條款。

n8n 本身採用不同的授權條款。除了標示 .ee. 的檔案以外,其程式碼皆採用 Sustainable Use License。該授權的主要限制是以下句子:「您只能為自己的內部業務目的,或用於非商業或個人用途,使用或修改本軟體。」Apache-2.0 對您使用 Nod 的方式沒有這項限制。如果您正在評估可在 n8n 上建置的內容,請先閱讀 n8n Sustainable Use License 說明,再規劃以此為基礎的產品。

執行 Nod 所需的 VPS 條件

自架服務文件列出 Docker Engine 25 或更新版本、Compose v2、OpenSSL,以及 sha256sum 或 shasum。若要從原始碼建置,還需要 Git。支援的主機包括 AMD64 或 ARM64 架構的 Linux,以及安裝 Docker Desktop 的 Mac。

規格方面,文件建議:「先從 2 個 CPU 核心、8 GB 記憶體和 50 GB 磁碟空間開始。」這是建議的起始規格,不是經測量得出的最低需求。文件也指出,同時執行瀏覽器工作與本機模型時,需要更大的容量。套件中的 compose.yaml 說明了大部分記憶體需求。它會將 server container 上限設為 2 GB、browser 上限設為 3 GB,並將 workspace 上限設為 2 GB。您可以在 .env 中使用 NOD_SERVER_MEMORY、NOD_BROWSER_MEMORY 和 NOD_WORKSPACE_MEMORY 變更這些上限。Postgres 和 Caddy 沒有設定上限。

安裝時不需要 model API key。應用程式啟動後,再於其中連接 model。

如果伺服器尚未安裝 Docker,請先安裝。VPS 上的 Docker Compose 基礎會逐步說明安裝流程。接著確認版本,並加入其他工具:

docker version
docker compose version
sudo apt update && sudo apt install -y git openssl

docker version 的 Server: 區段必須顯示版本 25 或更新版本,而且 docker compose version 必須成功。以下命令假設您的使用者可以在不使用 sudo 的情況下執行 docker。如果無法執行,請在每個 docker 和 sh 命令前加上 sudo。

複製固定標籤的 Nod 儲存庫

工具包位於 deployment/self-host/,並會從您複製出的儲存庫建置 Nod 映像。工具包不會從 registry 下載任何 Nod 專用內容,因此您簽出的標籤就是實際執行的版本。

git clone https://github.com/n8n-io/nod.git
cd nod
git checkout nod-v0.8.1
cd deployment/self-host
ls

ls 應列出 setup.sh、compose.yaml、Caddyfile、backup.sh 和 restore.sh 等檔案。標籤 nod-v0.8.0 與 nod-v0.8.1 都是在 16 November 2026 建立,並不是最新版本。截至 21 November 2026,nod-v0.9.1(20 November)標示為 Latest。本指南是以 nod-v0.8.1 工具包進行驗證,因此固定使用該標籤。下方的更新一節說明如何升級。

compose.yaml 中的第三方映像是依 digest,而不是依 :latest 固定:postgres:17-alpine、node:24.21.0-bookworm-slim 和 caddy:2.11.7-alpine。Nod 映像預設會透過 NOD_IMAGE_TAG 標記為 local。設定該變數不會下載已發布的版本。

使用 setup.sh 產生 secret

sh setup.sh

setup.sh不接受任何旗標。它會將 .env.example 複製到私有的 .env,並填入 4 個產生的值:Compose 專案名稱、NOD_AUTH_TOKEN(來自 openssl rand -hex 32)、NOD_VAULT_KEY(來自 openssl rand -base64 32)及 NOD_POSTGRES_PASSWORD。接著執行 chmod 600 .env,因此只有你的使用者可以讀取該檔案。

最後會列印 Ready. Run: docker compose --file compose.yaml --env-file .env up -d --build --wait。如果 .env 已存在,則保留該檔案並列印 Using the existing .env. Its keys and data are unchanged.。如果你的 shell 已設定 NOD_AUTH_TOKEN、NOD_VAULT_KEY 或 NOD_POSTGRES_PASSWORD,它會拒絕執行。如果你曾匯出其中任何變數,請先將其 unset。在較舊版本的 Docker 上,會停止並顯示 Use Docker Engine 25 or newer.。

建置並啟動服務堆疊

docker compose up -d --build --wait
docker compose ps

第一次建置需要較長時間,因為此套件會從原始碼建置 Nod 映像檔。請保持終端機開啟,直到命令返回。--wait 會持續等待,直到已設定 health check 的服務回報 healthy;因此,命令無錯誤返回表示服務堆疊已啟動。docker compose ps 應顯示 server、postgres、browser 及其他服務正在執行,並將 server 標示為 healthy。

如果在 setup.sh 之前執行 docker compose up,Compose 會拒絕啟動並輸出 Run sh setup.sh first。這是因為 compose.yaml 將 NOD_AUTH_TOKEN 標記為必要項目,而只有 setup.sh 會寫入該項目。

若要讀取伺服器日誌:

docker compose logs --tail 100 server

文件指出,token 絕不會列印在啟動日誌中。

連接埠 4310 維持繫結至 loopback,ufw 並不負責保護它

伺服器會在 compose.yaml 中以以下方式發布主機連接埠:

'${NOD_BIND_ADDRESS:-127.0.0.1}:${PORT:-4310}:${PORT:-4310}'

因此,Nod 會監聽連接埠 4310,而主機端則繫結至 127.0.0.1。只有伺服器本身的程序可以連線。請維持此設定。

這一點比表面上更重要,因為 Docker 發布的連接埠會繞過 ufw。Docker 文件指出,發布至容器的連接埠時,網路流量「會在通過 ufw 防火牆設定之前被重新導向」,因此「實際上會忽略防火牆設定」。ufw deny 4310 規則無法保護發布至所有介面的連接埠。只有繫結至 loopback,才能讓 4310 維持私有。Docker 連接埠為何會繞過 ufw 說明其運作機制,以及如何檢查自己的伺服器。

Docker 另有一項版本注意事項。在早於 28.0.0 的版本中,位於同一 layer 2 網路區段的主機可以連線至發布到 localhost 的連接埠。在 VPS 上,該區段就是供應商的網路。因此,請在可行時使用 Docker 28 或更新版本。

不要將 NOD_BIND_ADDRESS 改為 0.0.0.0 來從遠端存取應用程式。文件指出:「絕不要公開 PostgreSQL、瀏覽器、workspace 或 Docker 連線。」請使用以下兩種存取路徑之一。

透過 SSH 通道開啟 Nod

此通道不需要網域,也不需要開放 SSH 以外的連接埠。在您自己的電腦上執行以下命令,不要在伺服器上執行:

ssh -L 4310:127.0.0.1:4310 user@203.0.113.10

保持此工作階段開啟,然後在本機瀏覽器中前往 http://localhost:4310。在此設定中,將 NOD_PUBLIC_URL 保持為本機預設值 http://localhost:4310。如果您變更了 PORT,請同步變更通道兩端的設定,以及瀏覽器中的位址。

應用程式會要求存取權杖。在伺服器上輸出該權杖:

grep NOD_AUTH_TOKEN .env

將 = 後面的值貼到存取表單中,接著完成初始設定並連線至模型。即使透過通道連線,仍然需要此權杖。

如果您改用 Tailscale 連線至伺服器,請先閱讀 Tailscale Serve 與 Funnel 的差異,再將任何服務置於 Nod 前方,因為 Funnel 會將服務公開至網際網路。

透過 Caddy profile 為 Nod 提供 HTTPS

若要使用公開位址,套件提供 https profile。它會加入 Caddy container,取得並續期 TLS(transport layer security)憑證,然後將網路流量轉送至伺服器。您需要一個 DNS 記錄指向 VPS 的網域。如果供應商提供 network firewall,也必須在其中開放輸入 TCP 80 和 443。

編輯 .env,並設定確切的 origin:

NOD_PUBLIC_URL=https://nod.example.com

NOD_PUBLIC_URL 是「您開啟 Nod 時所使用的確切 origin」。只能填寫 scheme 和 host。系統會拒絕路徑、query string 與 fragment。此 profile 需要使用 port 443 的 https:// origin,且必須是 DNS 名稱或 IPv4 host。接著使用此 profile 啟動 stack:

docker compose --profile https up -d --build --wait

之後的啟動、停止與狀態檢查指令,都要繼續加入 --profile https,否則 Compose 會排除 Caddy container。開啟 https://nod.example.com,並依照上述方式貼上 token。

請確認這會開放哪些連接埠。Caddy service 會發布 80:80、443:443 與 443:443/udp,且未指定 bind address,因此這些連接埠會在所有介面上監聽。無論 PORT 設定為何,它們一律使用 host ports 80 和 443。由於 Docker 會繞過上述規則,ufw 不會關閉這些連接埠。若您已在執行 reverse proxy,請略過此 profile。將 proxy 指向 127.0.0.1:4310,並將 NOD_PUBLIC_URL 設為 proxy 的 HTTPS origin。

使用資料與意見回饋:確認目前啟用項目

文件指出:「新擁有者預設啟用使用資料分享。」資料會傳送至 Nod 團隊託管於 EU 的 PostHog 專案,獨立安裝也包含在內。部署設定也必須允許此功能,而 NOD_ANALYTICS_ENABLED=false 會一律停用它。

nod-v0.8.1 中的套件會在 .env.example 內提供 NOD_ANALYTICS_ENABLED=false,而 setup.sh 會將該行複製到您的 .env。因此,依照本指南進行全新安裝時,伺服器層級的分析功能預設為關閉。請檢查:

grep -n NOD_ANALYTICS_ENABLED .env

如果該行不存在或內容為空,伺服器在 production mode 中執行時,會將分析功能視為允許。較舊版本或手動撰寫的 .env 可能造成此情況。此時,請自行將該行設為 false。

意見回饋收集器是獨立功能。NOD_FEEDBACK_ENABLED 不在 .env.example 中,且文件將其記載為預設啟用。文件列出完整的停用方式:將分析與意見回饋設為 false,並讓 NOD_ONBOARDING_EMAIL_URL 保持空白。

echo 'NOD_FEEDBACK_ENABLED=false' >> .env
grep -n -e NOD_ANALYTICS_ENABLED -e NOD_FEEDBACK_ENABLED -e NOD_ONBOARDING_EMAIL_URL .env
docker compose up -d --wait server

最後一個命令會以新值重新建立伺服器。如果您使用 --profile https,請一併加入。擁有者也可以在應用程式的 Settings、Privacy & data、Share usage data 中切換分享設定。停止分享不會刪除已傳送的資料。

備份 Vault 金鑰與資料:此步驟不可省略

NOD_VAULT_KEY 是「用於加密已儲存憑證的 base64 32-byte 金鑰」。它位於 .env,不在資料庫中。Vault 文件指出:「沒有此金鑰就無法讀取已儲存的憑證。」加密資料存在後,Nod 不會再產生替代金鑰。自架頁面也指出:「僅靠資料庫無法復原已儲存的憑證。」如果遺失金鑰,即使資料庫傾印內容完整,授予 Nod 的每個登入憑證都會遺失。

因此,先單獨儲存金鑰。請將它放在密碼管理器或伺服器外的其他安全位置:

grep NOD_VAULT_KEY .env

接著使用套件提供的指令碼進行完整備份。目的地必須是尚不存在的絕對路徑:

mkdir -p "$HOME/nod-backups"
chmod 700 "$HOME/nod-backups"
sh backup.sh "$HOME/nod-backups/nod-2026-11-21"

指令碼會在複製資料時停止伺服器、瀏覽器與工作區,完成後再重新啟動。它會顯示 Backup saved: 與路徑。該目錄包含 .env、source-commit、一個 postgres.dump、伺服器、工作區、工具與瀏覽器資料的封存檔,以及 complete 標記檔。依賴備份前,請確認該標記檔存在。

文件指出:「備份包含秘密資料。」其中包含所有產生的秘密資料,包括 Vault 金鑰。請以加密形式儲存,並限制可讀取的人員。將備份複製到伺服器外,因為儲存在同一磁碟上的備份會隨磁碟一同遺失。備份不包含 TLS 憑證。

還原 Nod 至全新的 checkout

還原作業會使用新的資料夾與新的 Compose 專案。讀取建立備份時所使用的 commit,然後精確 checkout 該 commit:

commit="$(cat "$HOME/nod-backups/nod-2026-11-21/source-commit")"
git clone https://github.com/n8n-io/nod.git nod-restored
cd nod-restored
git checkout "$commit"
cd deployment/self-host
sh restore.sh "$HOME/nod-backups/nod-2026-11-21" nod-restored

不要先執行 setup.sh。restore.sh 需要沒有 .env 的 checkout,以及與已 checkout 修訂版本相符的 source-commit。此指令會建立全新的 volume、還原資料庫,但不會啟動應用程式。最後會以 Restored into a new project. Review .env before starting Nod. 結束。

啟動還原後的伺服器前,先停止原始伺服器。接著執行 docker compose up -d --build --wait;若要使用公開位址,請搭配 --profile https。切勿在要保留的伺服器上執行 docker compose down --volumes。此指令會刪除資料 volume。

將 Nod 更新至較新的標籤

先備份。然後在 nod/deployment/self-host 中執行:

docker compose stop
git fetch origin --tags
git checkout nod-v0.9.1
docker compose up -d --build --wait

Nod 啟動時會執行資料庫遷移,因此無法只切換回舊標籤來復原更新。文件指出:「不要讓較舊的應用程式版本連線到已升級的資料庫。」復原表示將更新前的備份還原至全新的 checkout。每次升級前都要閱讀版本說明,因為 preview 標籤表示預期會有不相容變更。更新期間不要變更 COMPOSE_PROJECT_NAME。

若要輪替存取權杖,請執行 openssl rand -hex 32,替換 .env 中的 NOD_AUTH_TOKEN 值,然後執行 docker compose up -d --wait server。舊權杖會停止運作。絕對不要替換 NOD_VAULT_KEY 來輪替存取權限。

FAQ

是否需要 n8n 才能執行 Nod?

不需要。README 說明 Nod 是獨立的應用程式,由 n8n 背後的團隊製作,並不是 n8n AI Assistant。它會在自己的 Docker Compose stack 中執行。之後可以連接 n8n instance,再要求 Nod 依名稱使用該 instance,但安裝流程不依賴 n8n。

Nod 是否與 n8n 使用相同的開源授權?

不是。Nod 採用 Apache License 2.0,著作權歸 n8n GmbH 所有;隨附的第三方資產則保留各自的授權條款。n8n 的程式碼在其 .ee. 檔案以外,採用 Sustainable Use License,僅限內部商業、非商業或個人用途。Apache-2.0 沒有這項使用限制。

沒有網域時,如何在 VPS 上開啟 Nod?

請從自己的電腦建立 SSH tunnel:ssh -L 4310:127.0.0.1:4310 user@203.0.113.10。保持 tunnel 開啟,造訪 http://localhost:4310,並貼上伺服器 .env 中的 NOD_AUTH_TOKEN。讓 NOD_PUBLIC_URL 保持本機預設值。伺服器上的 4310 埠會持續綁定至 loopback,因此不會暴露新的連接埠。

如果遺失 NOD_VAULT_KEY,會發生什麼事?

已儲存的憑證將無法再次讀取。此金鑰會加密憑證,並儲存在 .env 中,而不是資料庫內。加密資料存在後,Nod 不會產生替代金鑰,因此只有資料庫 dump 並無法解決問題。請在伺服器外保存一份金鑰副本。執行 sh backup.sh 時也請使用絕對路徑,因為備份會帶有包含金鑰的 .env。

ufw 是否能保護 Nod 的連接埠?

無法保護 Docker 發布的連接埠。Docker 會繞過 ufw 的規則,將網路流量轉送至已發布的 container ports。4310 埠僅因 compose.yaml 將其綁定至 127.0.0.1,才會保持為私人連接埠。https profile 會在所有介面上發布 80、443 和 443/udp,因此 ufw 無法關閉這些連接埠。在早於 28.0.0 的 Docker 版本中,位於同一 layer 2 segment 的主機也可能連線至發布到 localhost 的連接埠。

這篇文章對您有幫助嗎?