日期：2026年 04月 11日

標籤： n8n Continuous Integration(CI) Microsoft Azure SQL Server LineBot JavaScript RSS Groq AI Agent Linux Ubuntu

摘要：n8n

第一部分：為什麼選擇自架(Self-Hosted)n8n？

Step 1：前言-為什麼選擇自架(Self-Hosted)n8n？

架設在本地有以下優點：

最重要的一點：免費 (n8n Cloud 有 14 天試用期的限制，超過要綁信用卡進行繳費，保留期限為 3 天)

Step 2：n8n Cloud vs. 自架 Ubuntu Server 差異分析

以下是 2 者的差異，如果需要隱私性、低成本，那麼可以考慮自行搭建(較複雜)

n8n 的 Cloud 不包含 AI Agent 的 Token 費用，但在雲服務上可以隨時取得最新的自動化服務功能

第二部分：環境準備與硬體需求

Step 1：沒有硬性規定

n8n community有討論過自架設 n8n 最低需求配置為何
討論的結果一 依照自己 workflow 的複雜度來定義

Step 2：整理官方討論 - 建議最小配置

依照討論結果，若要 Ubuntu 系統的 Docker 容器化搭建 n8n ; 依據環境差異，以下最小配置需求，提供參考：

第三部分：Docker Compose 快速部署

Step 1：n8n 官網文件

n8n 官網 -> Docs -> Self-Host n8n

Step 2：Docker 嚮導

進入後選擇 Docker installation guide

Step 3：n8n自架開源庫

中間有一段 n8n-hosting repository.，我們要從裡面取得 docker-compose.yml 的安裝腳本
※目前官方自架（Self-hosting）最推薦、也最穩定的方式。
n8n 的 docker-compose.yml 有以下特性：

Step 4：下載 n8n 開源代碼

將 n8n Git Source 複製

Step 5：使用 withPostgres 版本

n8n 預設使用的是 Sqlite ，下載 Git Source 後，在小型個人開發，先 withPostgres 的 docker-compose 進行安裝
將代碼複製到 Ubuntu 主機 (圖為 WinScp 上傳檔案)
※有 4 種模式的 docker-compose 在第五部分進行補充

Step 6：進入 Ubuntu 目錄 + 調整腳本

我們進入 Ubuntu 主機進入以下目錄

/home/louis/n8n-hosting/docker-compose/withPostgres

並且在 # 的地方做調整，我們增加此 2 行
※第五部分有補充相關訊息

N8N_RUNNERS_ENABLED=false
N8N_SECURE_COOKIE=false 

上述參數的目的如下：

對應腳本：

version: '3.8'

volumes:
  db_storage:
  n8n_storage:

services:
  postgres:
    image: postgres:16
    restart: always
    environment:
      - POSTGRES_USER
      - POSTGRES_PASSWORD
      - POSTGRES_DB
      - POSTGRES_NON_ROOT_USER
      - POSTGRES_NON_ROOT_PASSWORD
    volumes:
      - db_storage:/var/lib/postgresql/data
      - ./init-data.sh:/docker-entrypoint-initdb.d/init-data.sh
    healthcheck:
      test: ['CMD-SHELL', 'pg_isready -h localhost -U ${POSTGRES_USER} -d ${POSTGRES_DB}']
      interval: 5s
      timeout: 5s
      retries: 10

  n8n:
    image: docker.n8n.io/n8nio/n8n
    restart: always
    environment:
      - DB_TYPE=postgresdb
      - DB_POSTGRESDB_HOST=postgres
      - DB_POSTGRESDB_PORT=5432
      - DB_POSTGRESDB_DATABASE=${POSTGRES_DB}
      - DB_POSTGRESDB_USER=${POSTGRES_NON_ROOT_USER}
      - DB_POSTGRESDB_PASSWORD=${POSTGRES_NON_ROOT_PASSWORD}
      # - N8N_RUNNERS_MODE=external # ← 這行替換成下面這行
      - N8N_RUNNERS_ENABLED=false
      # 添加以下這行
      - N8N_SECURE_COOKIE=false 
    ports:
      - 5678:5678
    links:
      - postgres
    volumes:
      - n8n_storage:/home/node/.n8n
    depends_on:
      postgres:
        condition: service_healthy

Step 7：進入 Ubuntu 目錄 + 安裝(異常是正常)

並且執行以下代碼安裝 n8n

docker-compose up -d

第一次安裝後必定會出現安裝失敗，要在執行一次

docker-compose up -d

第二次再次執行就會看到正常
※原因是 n8n 的 docker-compose.yml 會先安裝 postgresql -> 然後安裝 n8n -> 這時檢查到 postgresql 的健康檢查異常因此出現 Error
實際上是因為 postgresql 剛安裝好，尚未初始化完成

Step 8：檢查安裝結果

進入 Portainer 或下以下指令，檢查可以發現 n8n 與 postgresql 的容器皆安裝完成

docker ps -a

Step 9：訪問 n8n Web-UI

此為內部架設，可以依照自己的容器 Port 號(預設 5678)，輸入 URL 訪問

http://172.18.2.233:5678/

一開始會需等待初始化：




依序填寫帳號密碼，做管理員的配置

Step 10：官方提供額外功能 (可跳過此步驟)

到此步驟，會出現提供這些功能（如：資料夾分類、進階除錯、執行紀錄搜索）原本是付費版才有的，但官方為了吸引用戶留存並 收集匿名數據 ，決定讓你免費啟用。
基本上我們自架設用不到這些服務，若有需要再進行填寫

基本上如果極度重視隱私，不想讓官方知道你跑了多少個 Workflow，就選擇 跳過 Skip

第四部分：進入 n8n 世界 - 雲端轉本地

Step 1：進行轉移 - n8n 雲端下載 workflow

進入自己的 n8n 雲端服務，選擇 download 會得到 .json 檔案

Step 2：進行轉移 - n8n 本地端匯入

開啟一個空的 workflow -> 選擇 Import from file…

Step 3：進行轉移 - 重設金鑰

匯入完成後，可以看到所有的節點與雲端一致
要開始對每個節點有用到金鑰的地方重新設定 EX: Azure Sql Database、Groq API 等等…


執行 Create new credential

Step 4：執行 n8n - 轉移完成

全部轉移完成後，執行 Execute workflow 節點
可以觀察到所有流程已從 雲端 轉移到 本地端 ，並且重現 串接 Groq AI + Azure SQL + LineBot 完整自動化流程

第五部分：進入 n8n 世界 - 雲端轉本地

Step 1：為何選擇 Docker-Compose withPostgres 腳本

對應 Step 5：使用 withPostgres 版本
n8n 在預設未使用 Docker-Compose 單部署容器化，預設安裝的資料庫是 Sqlite ，效能與未來擴容沒有 PostgreSQL 高效
官方一共給出 4 種模式：

對應特點如下，可依照實際需求再選擇：

Step 2：為何配置 N8N_RUNNERS_ENABLED=false

對應 Step 6：進入 Ubuntu 目錄 + 調整腳本

未設定 N8N_RUNNERS_ENABLED=false 時， n8n 本地端 Web-UI 會遇到無法訪問的異常


觀察容器 Log

ssing auth token. When `N8N_RUNNERS_MODE` is `external`, it is required to set `N8N_RUNNERS_AUTH_TOKEN`. 
Its value should be a shared secret between the main instance and the launcher.

n8n 在較新的版本中引入了 Task Runners（任務運行器）機制。當系統偵測到某些環境設定時，它會以為你要使用「外部運行模式」，因此要求一個安全憑證（Auth Token）。
因此我們 關閉 Task Runners 模式

- N8N_RUNNERS_ENABLED=false # 關鍵：關閉 Task Runners 模式

Step 3：為何配置 N8N_RUNNERS_ENABLED=false - 追加補充

為什麼這樣設定可以排除錯誤?
因為 n8n 為了提升 安全性與效能，預設會檢查 Worker 與主程式之間的溝通憑證。

如果你沒有設定 N8N_RUNNERS_AUTH_TOKEN，且系統環境觸發了某些偵測機制，它就會報錯跳出。
對內網自架用戶來說，直接設定 N8N_RUNNERS_ENABLED=false 是最省事的做法。

在自架且非 Cluster 模式下，我們通常不需要這個