← 返回

如何用 OpenResty Edge Lua 擴充套件實現事件驅動自動化：閘道器伺服器離線時自動從 DNS 摘除節點

章亦春釋出於 Jun 26, 2024 更新於 Aug 26, 2026

預計閱讀 5 分鐘

閱讀次數

OpenResty Edge Lua 擴充套件是一段自定義 Lua 程式碼，當內建閘道器事件觸發時（例如閘道器伺服器異常離線），Edge 會自動執行它。你完全在 Edge 的 Web 控制檯裡建立、編輯並繫結這些擴充套件——路徑為 Global Config → Global Lua Extensions，並選擇一個事件型別作為觸發條件。這讓 Edge 成為一個事件驅動的自動化平臺：無需輪詢或編寫外部膠水程式碼，直接把 Lua 邏輯掛到閘道器生命週期事件上。

本文將演示如何構建一個事件驅動的 Lua 擴充套件，響應 **Gateway Server Abnormal Offline（閘道器伺服器異常離線）**事件，在閘道器伺服器一掉線的瞬間就從 GoDaddy DNS 摘除失效節點——讓 DNS 不再把流量解析到離線節點，無需人工介入。若你想從 page rule 裡呼叫可複用的 Lua 而非繫結事件，請參見配套功能 Global Lua Modules；若想了解基於 webhook 的同類事件驅動方案，請參見用 OpenResty Edge Webhook 構建事件驅動運維。

如何建立繫結閘道器事件的 OpenResty Edge Lua 擴充套件

OpenResty Edge 提供了強大的 Lua 擴充套件功能，能夠自動響應閘道器伺服器的離線事件。

讓我們切換到 OpenResty Edge 的 Web 控制檯。這是我們的控制檯的樣例部署。每個使用者都有自己的本地部署。

進入 “Global Config” 頁面。

點選 “Global Lua Extensions”。

讓我們建立一個新的 Lua 擴充套件。

建立一個擴充套件，防止 GoDaddy 將域名解析到已經離線的節點。

這裡我們輸入名稱為 “remove_node_from_godaddy_if_node_is_offline”。

選擇 “By event”。

OpenResty Edge 支援幾種內建事件。

這裡，我們選擇 “Gateway Server Abnormal Offline” 型別。這意味著如果伺服器離線，Lua 擴充套件就會被觸發。

如果你習慣使用 Vim，可以啟用 Vim 模式來編輯程式碼。

當事件發生時，它會將 trigger_event 傳遞給 Lua 擴充套件。

向管理伺服器傳送請求，當節點離線時，可以從 GoDaddy 中移除該節點。

當響應內容滿足條件時，使用 Lua 的 cjson 模組解碼它，並將結果賦值給 body 變數。

如果 body 存在且 body.status 等於 0，則輸出成功訊息。

點選建立！

透過 OpenResty Edge 管理所有應用程式

如何透過讓閘道器伺服器離線來觸發並驗證 Lua 擴充套件

建立後，這個新的 Lua 擴充套件將自動執行。讓我們用一個離線的閘道器伺服器來測試它。

進入閘道器叢集頁面。

這是我們要使用的閘道器叢集。

它現在是線上的。

在終端上，使用 systemctl 命令停止服務。

重新整理列表。

伺服器現在離線了。

返回 “Global Config” 頁面。

進入 “Global Lua Extensions”。

檢查執行歷史。

如圖所示，擴充套件已被觸發並執行。

節點已成功從 GoDaddy 中移除。

常見問題

甚麼是 OpenResty Edge 中的 Lua 擴充套件？

Lua 擴充套件是一段自定義 Lua 程式碼，OpenResty Edge 會在內建閘道器事件觸發時自動執行它。你在 Web 控制檯的 Global Config → Global Lua Extensions 下編寫和管理它，因此無需改動底層閘道器配置檔案就能加入事件驅動的自動化邏輯。

哪些事件可以觸發 Lua 擴充套件？

建立擴充套件時，你選擇 “By event” 作為觸發方式。OpenResty Edge 支援多種內建事件；本文使用的是 “Gateway Server Abnormal Offline”（閘道器伺服器異常離線），只要有閘道器伺服器離線就會觸發該擴充套件。

建立 Lua 擴充套件後需要過載或重啟閘道器嗎？

不需要。Lua 擴充套件執行在 Edge Admin（管理端），而不是各閘道器節點（Edge Node），因此沒有需要過載或重啟的閘道器。點選建立後，新的 Lua 擴充套件就會自動生效，沒有額外的啟用步驟；下一次繫結的事件觸發時，Edge Admin 就會執行你的 Lua 程式碼。

事件觸發時擴充套件會收到甚麼資料？

事件發生時，OpenResty Edge 會把一個 trigger_event 值傳給 Lua 擴充套件，你的程式碼由此知道是哪臺伺服器或哪個上下文觸發的，從而據以行動——例如確定要摘除哪個離線節點。

Lua 擴充套件能否呼叫 DNS 服務商等外部服務？

可以。本例中，擴充套件向管理伺服器傳送請求以從 GoDaddy 摘除離線節點，然後用 Lua 的 cjson 模組解碼響應，並在記錄成功前檢查 body.status 是否等於 0。同樣的模式適用於任何 HTTP API。

如何確認 Lua 擴充套件確實執行了？

回到 Global Config → Global Lua Extensions 檢視執行歷史。它會顯示擴充套件是否已被觸發並執行——在本文中，確認了離線節點已從 GoDaddy DNS 中移除。

關於 OpenResty Edge

OpenResty Edge 是一款專為微服務和分散式流量架構設計的全能型閘道器軟體，由我們自主研發。它集流量管理、私有 CDN 構建、API 閘道器、安全防護等功能於一體，幫助您輕鬆構建、管理和保護現代應用程式。OpenResty Edge 擁有業界領先的效能和可擴充套件性，能夠滿足高併發、高負載場景下的苛刻需求。它支援排程 K8s 等容器應用流量，並可管理海量域名，輕鬆滿足大型網站和複雜應用的需求。

申請試用 OpenResty Edge

如果你喜歡這個教程，請訂閱這個部落格網站和我們的 B 站頻道。謝謝！

關於作者

章亦春是開源 OpenResty^® 專案創始人兼 OpenResty Inc. 公司 CEO 和創始人。

章亦春（Github ID: agentzh），生於中國江蘇，現定居美國灣區。他是中國早期開源技術和文化的倡導者和領軍人物，曾供職於多家國際知名的高科技企業，如 Cloudflare、雅虎、阿里巴巴, 是 “邊緣計算“、”動態追蹤 “和 “機器程式設計 “的先驅，擁有超過 22 年的程式設計及 16 年的開源經驗。作為擁有超過 4000 萬全球域名使用者的開源專案的領導者。他基於其 OpenResty^® 開源專案打造的高科技企業 OpenResty Inc. 位於美國矽谷中心。其主打的兩個產品 OpenResty XRay（利用動態追蹤技術的非侵入式的故障剖析和排除工具）和 OpenResty Edge（最適合微服務和分散式流量的全能型閘道器軟體），廣受全球眾多上市及大型企業青睞。在 OpenResty 以外，章亦春為多個開源專案貢獻了累計超過百萬行程式碼，其中包括，Linux 核心、Nginx、LuaJIT、GDB、SystemTap、LLVM、Perl 等，並編寫過 60 多個開源軟體庫。