← 返回

OpenResty Edge 中的閘道器小語言 EdgeLang

章亦春釋出於 Apr 19, 2023 更新於 Jun 21, 2023

預計閱讀 5 分鐘

閱讀次數

今天我將演示 OpenResty Edge 的另一個很酷的功能。就是如何使用我們基於規則的小語言，即 Edge 語言，簡稱 Edgelang。

Edgelang 簡介

使用者可以使用 Edgelang 來編寫複雜的閘道器規則，用於自定義認證、重寫請求和響應、配置動態上游路由等等。這些規則的執行速度通常要比手寫的 Lua 程式碼快很多。Edgelang 編譯器會生成高效的原生程式碼，在閘道器伺服器上執行。

Edgelang 編譯器是非常高效的。它實現了許多先進的最佳化技術。它支援將所有 Edgelang 規則所引用的正規表示式合併到一個狀態機中。這樣只需掃描一次請求資料，就會立即知道能匹配上哪些規則以及這些規則的哪些部分。

它還支援把所有 Edgelang 規則的常量字串字首和字尾模式組合成單一的樹狀資料結構。

新增使用 Edgelang 定義的頁面規則

讓我們進入 OpenResty Edge 的 Admin Web 控制檯。這就是我們控制檯的樣本部署。每個使用者都有自己的本地部署。

我們可以繼續使用之前的示例應用，test-edge.com。

進入該應用。

在之前的教程中我們已經建立了一個頁面規則。

這個頁面規則設定了一個反向代理到一個上游。

可以在這裡新增我們的 Edgelang 程式碼。

現在來新增第一條規則。

首先是規則的條件部分。條件是當 URI 是 “/foo/” 時。

用箭頭來標誌條件部分的結束。

箭頭之後，我們指定當條件得到滿足時要執行的動作。

這個動作啟動了一個 HTTP 重定向到 “/bar/” 頁面。

儲存這個規則。

正如我們看到的那樣，Edgelang 規範由規則組成。每個規則都有兩個基本部分：

一個是條件部分，

另外一個是由動作組成的結果。

條件和結果由一個箭頭連線。

整個規則以一個分號結束。

這只是一個最簡單的規則。我們可以隨意新增各種規則。一條規則可以有多個條件，各個條件之間可以用 AND 或者 OR 連線。一條規則在其結果部分也可以執行多個動作。

像往常一樣，需要釋出一個新的版本來推送我們剛才的改動。

點選這個按鈕。

釋出！

新版本現在已經同步到所有的閘道器伺服器上了。

現在，新的頁面規則已經被推送到所有的閘道器叢集和伺服器。

這些配置的變化不需要伺服器過載、重啟或二進位制升級。所以它是非常高效和可擴充套件的。

測試

在終端上，我們透過 curl 命令列工具向一個由 DNS 解析的閘道器伺服器傳送 HTTP 請求。

curl -I http://test-edge.com/bar/

請注意響應頭沒有重定向。

接下來，讓我們傳送一個帶有 /foo/ URI 的 HTTP 請求。

curl -I http://test-edge.com/foo/

可以看到這個請求已經被重定向了。

它被重定向到 /bar/ 這個位置。剛才定義的 Edgelang 規則生效了！

讓我們測試另一個字首為 “/foo/” 的 URI。

這個 URI 有一個額外的字尾，“blah/"。

傳送請求。

可以看到這個請求並沒有命中 Edgelang 規則。這是因為我們的 Edgelang 條件需要完全匹配 “/foo/"。

修改頁面規則的 Edgelang 定義

我們可以修改 Edgelang 規則中的條件部分來處理這種情況。

單擊 “編輯” 按鈕。

刪除原來的條件。

將其改為匹配 URI 字首 “/foo/"。

儲存這個規則。

再做一次新配置的釋出。

回到終端。再次傳送我們之前的測試請求。

仍然採用 “blah/” URI 的字尾。

傳送請求。

可以看到它觸發了一個重定向，這次是命中了我們的 Edgelang 規則。

接下來，讓我們傳送一個沒有任何額外 URI 字尾的 HTTP 請求。

curl -I http://test-edge.com/foo/

仍然能夠命中。

使用 Edgelang 定義 WAF 規則

我們可以在 Web 控制檯的許多不同地方使用 Edgelang。例如，可以用 EdgeLang 為 WAF，或 Web 應用防火牆新增自定義規則。

建立一個新的 WAF 規則。

在這裡寫入 Edgelang。

Edgelang 使用者手冊

我們自主設計的 EdgeLang 閘道器小語言是一種非常強大的語言，有很多特性。語言支援呼叫自定義 Lua 模組和 Lua 程式碼，或者任意 .so 動態連結庫。其編譯器支援跨規則深度最佳化。

如需瞭解更多，歡迎閱讀 Edgelang 使用者手冊。英文版更完整更新一些。

手冊裡有許多程式碼例項。

非常詳細地介紹了 Edgelang 的各種用法。

這就是我今天要講的內容。

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

申請試用 OpenResty Edge

關於本文和關聯影片

本文和相關聯的影片都是完全由我們的 OpenResty Showman 產品從一個簡單的劇本檔案自動生成的。

關於作者

章亦春是開源 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 多個開源軟體庫。