目錄

n8n 教學

n8n 是一套開源的工作流程自動化工具。你可以用拖拉節點的方式,把 Google 試算表、Gmail、Slack、Telegram、資料庫、各種 API 以及 AI 模型串在一起,讓重複的工作自動完成。

例如:

  • 每天早上 8 點抓取天氣與行事曆,整理後傳到 Telegram
  • 表單有人填寫時,自動寫入試算表、寄出確認信、通知業務
  • 收到客戶來信時,用 AI 分類並草擬回覆
  • 打造一個能查詢公司文件、會使用工具的 AI 助理

和 Zapier、Make 等服務相比,n8n 最大的特色是可以自己架設,資料留在自己的伺服器,執行次數也不受方案限制。

你會學到什麼

  • n8n 的基本概念:工作流程、節點、觸發器、項目(items)
  • 用 Docker 安裝 n8n,並建立第一個自動化流程
  • 運算式、憑證、常用核心節點的用法
  • 用 Webhook 接收外部資料、用程式碼節點處理複雜邏輯
  • 錯誤處理與通知
  • 用 AI Agent 節點打造 AI 助理,串接本機 Ollama 模型與知識庫(RAG)
  • 自架部署、備份與更新

適合誰

  • 想把日常重複工作自動化的上班族、行銷、客服、營運人員
  • 想快速串接各種服務、但不想從零寫程式的開發者
  • 想打造 AI 自動化流程與 AI Agent 的人

基本操作完全不需要寫程式。進階章節會用到一點 JavaScript。

本教學以 n8n 2.x 版為準。n8n 更新頻繁,介面細節可能和你看到的略有不同。

從 n8n 是什麼 開始吧。

基礎入門

  1. n8n 是什麼

    n8n 是什麼?介紹 n8n 的用途與核心概念(工作流程、節點、觸發器),比較 n8n 與 Zapier、Make 的差異,說明 n8n Cloud 與自架版本的選擇,以及 Sustainable Use License 授權的限制。

  2. 安裝 n8n

    一步一步在自己的電腦安裝 n8n:用 Docker 快速啟動、設定台灣時區、保存資料,或用 npx / npm 直接執行,以及第一次開啟時的帳號設定。

  3. 介面導覽

    認識 n8n 的介面:首頁與專案、工作流程編輯器、新增與連接節點、節點設定面板、測試執行、儲存與發布(Publish)、執行紀錄,以及常用的快捷鍵。

  4. 第一個工作流程

    跟著步驟建立第一個 n8n 自動化:用 Schedule Trigger 每天定時執行、HTTP Request 取得天氣 API、Edit Fields 整理資料,再寄出 Email 通知,並學會測試、發布與查看執行紀錄。

  5. 資料結構與 items

    理解 n8n 最核心的資料觀念:節點之間傳遞的是 items 陣列,每個節點會對每一筆 item 執行一次。說明 JSON 與二進位資料、項目配對、拆分與合併資料,以及常見的「為什麼執行了好幾次」問題。

核心觀念

  1. 運算式

    n8n 運算式(Expressions)完整教學:用 {{ }} 讀取資料、$json 與 $('節點名稱') 的差別、字串與陣列處理、條件判斷、日期時間(Luxon)、$now、$execution 等內建變數,附大量實用範例。

  2. 憑證管理

    n8n 憑證(Credentials)教學:如何新增 API 金鑰與 OAuth 憑證、在自架 n8n 上設定 Google OAuth(試算表、Gmail、雲端硬碟)、在 HTTP Request 節點使用憑證,以及憑證的加密與共用。

  3. 常用核心節點

    介紹 n8n 最常用的核心節點與使用時機:HTTP Request 呼叫 API、Edit Fields 整理欄位、If 與 Switch 條件分支、Filter、Merge 合併、Loop Over Items 分批處理、Wait 等待、Execute Workflow 子流程與排程觸發器。

  4. Webhook

    用 n8n Webhook 節點接收表單、金流、GitHub 等外部服務送來的資料:測試網址與正式網址的差別、HTTP 方法與路徑、讀取 body 與 query、驗證請求、用 Respond to Webhook 自訂回應,以及常見問題。

  5. 程式碼節點

    n8n Code 節點完整教學:Run Once for All Items 與 Run Once for Each Item 兩種模式、讀取與回傳 items 的格式、常見的資料處理範例、使用外部套件,以及 n8n 2.x 的 Python 與安全性變更。

  6. 錯誤處理

    讓 n8n 自動化流程更穩定:節點的 Retry On Fail 自動重試、On Error 失敗後繼續或走錯誤分支、Stop and Error 主動中止,以及用 Error Trigger 建立全域錯誤通知工作流程。

AI 自動化

  1. AI Agent 入門

    用 n8n 的 AI Agent 節點打造 AI 助理:Chat Trigger、聊天模型、記憶(Memory)、工具(Tools)的概念與連接方式,一步步做出能查天氣、讀試算表的聊天機器人,並說明系統提示詞與常見問題。

  2. 串接 Ollama 本機模型

    讓 n8n 使用 Ollama 在本機執行的開源模型(Qwen、Llama、Gemma),不需 API 費用、資料不外流。說明連線網址設定(Docker 環境)、Ollama Chat Model 與 Embeddings 節點、模型選擇與常見錯誤。

  3. RAG 知識庫問答

    用 n8n 建立 RAG(檢索增強生成)知識庫:把 Google Drive 或上傳的文件切塊、產生嵌入、存入向量資料庫,再讓 AI Agent 透過向量檢索工具根據文件回答問題。說明 Simple Vector Store、Qdrant、PGVector 的選擇。

實戰範例

  1. Google 試算表自動化

    用 n8n 操作 Google Sheets:設定授權、讀取資料列、新增與更新資料(Append or Update)、監聽新資料列,並實作「表單報名自動寫入試算表並寄出確認信」的完整範例。

  2. Telegram AI 機器人

    一步步用 n8n 建立 Telegram 機器人:用 BotFather 建立 Bot、Telegram Trigger 接收訊息、AI Agent 產生回覆、依使用者記憶對話、限制使用者,以及傳送圖片與按鈕的方法。

部署與維運

  1. 自架部署

    把 n8n 部署到雲端主機正式使用:Docker Compose 搭配 PostgreSQL 資料庫與 Caddy 自動 HTTPS,設定網域、Webhook 網址、加密金鑰與時區等環境變數,並說明主機規格與安全性設定。

  2. 備份與更新

    保護你的 n8n 工作流程與憑證:用 CLI 匯出工作流程與憑證、備份 PostgreSQL 與資料目錄、搬移到新主機,以及安全地更新 n8n 版本與從 1.x 升級到 2.x 的注意事項。

  3. 常見問題與錯誤

    n8n 常見問題整理:Webhook 網址顯示 localhost、排程時間差 8 小時、節點重複執行、OAuth 授權失敗、記憶體不足、執行紀錄佔用空間、工作流程沒有自動執行等問題的原因與解決方法。

更新於 2026年10月12日