目錄
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 是什麼 開始吧。
基礎入門
- n8n 是什麼
n8n 是什麼?介紹 n8n 的用途與核心概念(工作流程、節點、觸發器),比較 n8n 與 Zapier、Make 的差異,說明 n8n Cloud 與自架版本的選擇,以及 Sustainable Use License 授權的限制。
- 安裝 n8n
一步一步在自己的電腦安裝 n8n:用 Docker 快速啟動、設定台灣時區、保存資料,或用 npx / npm 直接執行,以及第一次開啟時的帳號設定。
- 介面導覽
認識 n8n 的介面:首頁與專案、工作流程編輯器、新增與連接節點、節點設定面板、測試執行、儲存與發布(Publish)、執行紀錄,以及常用的快捷鍵。
- 第一個工作流程
跟著步驟建立第一個 n8n 自動化:用 Schedule Trigger 每天定時執行、HTTP Request 取得天氣 API、Edit Fields 整理資料,再寄出 Email 通知,並學會測試、發布與查看執行紀錄。
- 資料結構與 items
理解 n8n 最核心的資料觀念:節點之間傳遞的是 items 陣列,每個節點會對每一筆 item 執行一次。說明 JSON 與二進位資料、項目配對、拆分與合併資料,以及常見的「為什麼執行了好幾次」問題。
核心觀念
- 運算式
n8n 運算式(Expressions)完整教學:用 {{ }} 讀取資料、$json 與 $('節點名稱') 的差別、字串與陣列處理、條件判斷、日期時間(Luxon)、$now、$execution 等內建變數,附大量實用範例。
- 憑證管理
n8n 憑證(Credentials)教學:如何新增 API 金鑰與 OAuth 憑證、在自架 n8n 上設定 Google OAuth(試算表、Gmail、雲端硬碟)、在 HTTP Request 節點使用憑證,以及憑證的加密與共用。
- 常用核心節點
介紹 n8n 最常用的核心節點與使用時機:HTTP Request 呼叫 API、Edit Fields 整理欄位、If 與 Switch 條件分支、Filter、Merge 合併、Loop Over Items 分批處理、Wait 等待、Execute Workflow 子流程與排程觸發器。
- Webhook
用 n8n Webhook 節點接收表單、金流、GitHub 等外部服務送來的資料:測試網址與正式網址的差別、HTTP 方法與路徑、讀取 body 與 query、驗證請求、用 Respond to Webhook 自訂回應,以及常見問題。
- 程式碼節點
n8n Code 節點完整教學:Run Once for All Items 與 Run Once for Each Item 兩種模式、讀取與回傳 items 的格式、常見的資料處理範例、使用外部套件,以及 n8n 2.x 的 Python 與安全性變更。
- 錯誤處理
讓 n8n 自動化流程更穩定:節點的 Retry On Fail 自動重試、On Error 失敗後繼續或走錯誤分支、Stop and Error 主動中止,以及用 Error Trigger 建立全域錯誤通知工作流程。
AI 自動化
- AI Agent 入門
用 n8n 的 AI Agent 節點打造 AI 助理:Chat Trigger、聊天模型、記憶(Memory)、工具(Tools)的概念與連接方式,一步步做出能查天氣、讀試算表的聊天機器人,並說明系統提示詞與常見問題。
- 串接 Ollama 本機模型
讓 n8n 使用 Ollama 在本機執行的開源模型(Qwen、Llama、Gemma),不需 API 費用、資料不外流。說明連線網址設定(Docker 環境)、Ollama Chat Model 與 Embeddings 節點、模型選擇與常見錯誤。
- RAG 知識庫問答
用 n8n 建立 RAG(檢索增強生成)知識庫:把 Google Drive 或上傳的文件切塊、產生嵌入、存入向量資料庫,再讓 AI Agent 透過向量檢索工具根據文件回答問題。說明 Simple Vector Store、Qdrant、PGVector 的選擇。
實戰範例
- Google 試算表自動化
用 n8n 操作 Google Sheets:設定授權、讀取資料列、新增與更新資料(Append or Update)、監聽新資料列,並實作「表單報名自動寫入試算表並寄出確認信」的完整範例。
- Telegram AI 機器人
一步步用 n8n 建立 Telegram 機器人:用 BotFather 建立 Bot、Telegram Trigger 接收訊息、AI Agent 產生回覆、依使用者記憶對話、限制使用者,以及傳送圖片與按鈕的方法。
部署與維運
- 自架部署
把 n8n 部署到雲端主機正式使用:Docker Compose 搭配 PostgreSQL 資料庫與 Caddy 自動 HTTPS,設定網域、Webhook 網址、加密金鑰與時區等環境變數,並說明主機規格與安全性設定。
- 備份與更新
保護你的 n8n 工作流程與憑證:用 CLI 匯出工作流程與憑證、備份 PostgreSQL 與資料目錄、搬移到新主機,以及安全地更新 n8n 版本與從 1.x 升級到 2.x 的注意事項。
- 常見問題與錯誤
n8n 常見問題整理:Webhook 網址顯示 localhost、排程時間差 8 小時、節點重複執行、OAuth 授權失敗、記憶體不足、執行紀錄佔用空間、工作流程沒有自動執行等問題的原因與解決方法。
更新於 2026年10月12日