n8n 2.23 升級到 2.30.4：實用新功能與版本建議

先看結論：哪些更新最值得用？#

如果你只在意一般工作流程，而不是 Enterprise 治理或 Instance AI，2.28 與 2.29 是這一段版本中最有感的兩次更新。

Webhook 可以在觸發前先過濾請求#

2.28 的 Webhook 節點新增 Only Run If。以前收到 Webhook 後，通常要接一個 IF 或 Filter 節點，才判斷事件類型、Header 或 Payload 是否符合條件；現在可以直接在入口決定是否執行。

例如同一個第三方 Webhook 會送出 created、updated、deleted 三種事件，而你的流程只處理新增事件，就能把條件放在 Webhook 節點：

1
{{ $json.event === 'created' }}

這項更新的價值不是少放一個 IF 節點而已。無效事件不必進入完整流程，能降低執行次數、資料寫入和後續 API 呼叫，也讓入口條件更容易被看懂。

注意：升級後不需要急著改掉既有 IF 節點。先確認 Only Run If 對測試 Webhook 與正式 Webhook 的行為都符合預期，再逐步搬移入口條件。

AI Agent 能直接處理 PDF 原檔#

2.28 為 AI Agent 增加 binary PDF passthrough，並補上 OpenAI Responses API 的 PDF 傳遞支援。只要選用的模型原生支援 PDF，就能把二進位 PDF 直接交給模型，不一定要先用 Extract From File 抽成純文字。

這對以下流程很實用：

• 讀取包含表格與版面的財務報告
• 比對合約頁面中的條款與註記
• 分析圖文混排的產品手冊
• 從發票或報價單擷取欄位

原生 PDF 不代表所有情況都該跳過文字抽取。大量文件需要檢索、切片或向量化時，原本的 RAG 流程仍比較合適；單份文件問答或需要理解版面時，直接傳 PDF 才更省事。

另外，2.30 修正 AI Agent 平行工具呼叫寫入聊天記憶時的結構問題，並改善沒有使用工具時的 intermediate steps 回傳。已經在做 AI Agent 或 MCP 流程的人，會比一般自動化使用者更容易感受到這些穩定性修正。站內也有一篇 n8n 整合 Perplexity-Ask MCP 的設定教學可以搭配參考。

GitHub、Slack 與 Telegram 節點更完整#

Microsoft 與 Google 的無人值守驗證更好用#

2.29 新增 Microsoft Entra Service Principal credential，並讓 OneDrive、Outlook 支援 app-only authentication；2.30 再把 Service Principal 擴展到 Excel、Teams、To Do，也加入憑證式驗證。

這代表排程工作不必再綁定某位員工的 OAuth 登入。對正式環境而言，使用應用程式身分通常更適合：

• 不會因個人密碼或 MFA 政策變動而失效
• 可以在 Entra ID 集中管理權限
• 容易區分「使用者操作」與「系統自動化」
• 憑證式驗證可避免長期保存 client secret

Google 端也有相似改善。2.28 的 Google Sheets Trigger 支援 Service Account，Google Calendar、Cloud Storage、Sheets 則能自訂 OAuth scopes。若你的流程只需要讀取試算表，就不必授予超出需求的權限。

2.24 到 2.29 的維運與治理更新#

這幾個版本不只增加節點操作，也補強了自架 n8n 的維運能力。

2.30 才有的功能，值得現在升嗎？#

2.30.0 的一般使用者功能不算少：

• 新增 N8N_WEBHOOK_URL，統一正式與測試 Webhook URL 設定
• Public API 可匯出 Project、讀取 evaluation test runs、篩選 crashed executions
• Data Table 節點與欄位操作介面改善
• Python task runner 可透過 N8N_RUNNERS_ALLOW_TRANSITIVE_IMPORTS 開放間接相依套件
• Kafka 支援 mTLS
• Microsoft Excel、Teams、To Do 支援 Service Principal
• Send and Wait 回應包含時間戳記

但 2.30.4 在本文發布當天仍是 beta，而且 2.30.1～2.30.4 都在修正聊天、Expression isolate、Webhook、Notion 欄位相容性與執行權限等問題。這表示 2.30 系列仍在快速收斂。

我的建議很直接：

另外，官方文件目前仍以 WEBHOOK_URL 說明反向代理設定，而 2.30 Changelog 才新增 N8N_WEBHOOK_URL。不要在升級時直接刪掉舊變數；先在測試環境確認 Editor 顯示的 Test URL、Production URL 與第三方服務註冊結果都正確。

從 2.23 升級到 2.29.10 的建議步驟#

正式環境不要只換 Image Tag 就收工。至少照以下順序做一次：

1. 備份 PostgreSQL 或 SQLite 資料庫。
2. 備份 n8n 持久化資料夾與 N8N_ENCRYPTION_KEY。
3. 記錄目前 Image Tag、環境變數與 Community Nodes 版本。
4. 在測試環境使用相同資料副本升到 2.29.10。
5. 測試 Webhook、Schedule、Sub-workflow、OAuth、Code Node 與主要 AI 流程。
6. Queue Mode 要讓 main、worker、webhook processor、runner 使用完全相同的 n8n 版本。
7. 正式升級後，檢查失敗執行、容器日誌與排程是否重複觸發。

Docker Compose 可先把 Image Tag 固定在 2.29.10：

1
services:
2
  n8n:
3
    image: docker.n8n.io/n8nio/n8n:2.29.10

再拉取映像並重建容器：

1
docker compose pull n8n
2
docker compose up -d n8n
3
docker compose logs -f n8n

如果要測試 2.30.4，請使用另一套測試環境，並明確固定版本：

1
image: docker.n8n.io/n8nio/n8n:2.30.4

升級後也建議重跑幾個容易受資料結構影響的流程。若流程使用 Code、Merge、Aggregate 或 Loop，可以順便檢查 Code 節點資料過濾陷阱、Merge 搭配 Loop 的常見問題，以及 Code、Merge、Aggregate 的使用差異。

常見問題#

總結#

• 正式環境目前升到 2.29.10，不急著上 2.30.4。
• 一般使用者最值得關注 Webhook 過濾、AI Agent PDF、GitHub PR、Slack 排程與 Service Principal。
• 自架與團隊環境則要留意 OpenTelemetry、外部儲存、Data Redaction、API Key scope 與 Project 匯出。
• 2.30 的統一 Webhook URL、Data Table 與 Public API 很實用，但仍應先在測試環境驗證。

參考來源：

n8n 2.23.0 官方 Changelog

n8n 2.24.0～2.29.0 官方 Changelog

n8n 2.30.0 官方 Changelog

n8n 2.30.4 官方 Changelog

n8n 官方自架更新指南

n8n 外部儲存與升級注意事項