你可能已經用 NGINX 搭好了閘道器:接收請求、解除安裝 TLS、把流量轉發給後端,一切執行得很穩。但業務總會越長越複雜。慢慢地,新需求開始往閘道器上堆:收到請求後得先查一下 Redis,看看賬號有沒有被封禁;接著要根據租戶動態切換上游叢集;如果是呼叫大模型或核心 API 的介面,還得按賬號或 Token 額度做精細化限流、對流式響應做實時統計、甚至在後端故障時自動切備(Fallback)。原本只負責“指路”的閘道器,不知不覺背上了越來越多的業務邏輯。

當然,這些事不一定非得靠 OpenResty。現在的 NGINX 配合官方的 njs(NGINX JavaScript)模組、auth_request 模組或者自己寫 C 模組,也能處理不少動態需求。但當邏輯越來越重、對效能和底層控制的要求越來越高時,痛點就出來了:nginx.conf 和零散指令碼越來越難維護,外部鑑權服務平白多了一跳網路開銷,而動態改上游、換證書更是動不動就得 reload 程序——程式碼怎麼測?高併發怎麼扛?半夜出了問題又該去哪兒查?這正是 OpenResty 最擅長解決的問題。它以 NGINX 為核心,整合了 LuaJIT、ngx_lua 和一系列開箱即用的配套庫。簡單來說,它讓你能繼續保留 NGINX 強大的代理、TLS 和連線管理能力,同時直接用高效能的 Lua 程式碼來接管閘道器的各個生命週期。

這篇文章就從一個具體的閘道器場景出發,聊聊兩者的真實邊界,以及甚麼時候值得把 NGINX 換成 OpenResty。如果你想先了解它的整體定位,可以先讀讀這篇:OpenResty 是甚麼?從 Nginx、LuaJIT 到應用場景。

當閘道器不再只是“傳話筒”:一個典型場景

假設你要為 API 閘道器加上一套租戶鑑權與動態路由機制。一條請求打進來後,需要依次闖過這幾關:

  1. 從請求頭 X-API-Key 裡提取賬號標識。
  2. 查一下 Redis,確認賬號狀態正常,並拿到它對應的租戶配置與後端節點列表。
  3. 根據租戶等級動態選擇後端上游;如果賬號已停用或查詢異常,直接攔截並返回對應的錯誤碼。
  4. 統計呼叫次數或額度,觸發閾值時直接限流,透過後再把請求轉發給後端。

如果只是做一兩條簡單的 Header 校驗或發個輕量級的 HTTP 子請求,用原生配置加上 njs 或 auth_request 也能跑起來。但當閘道器需要高併發直連 Redis、配多級快取防擊穿,並且根據返回的資料實時接管底層的負載均衡時,拼湊出來的方案在效能和可維護性上就會迅速見頂。

把程式碼寫進閘道器:OpenResty 是怎麼破局的?

在 OpenResty 裡,你可以直接把 Lua 程式碼掛載到 NGINX 的 ssl_certificate、rewrite、access、balancer、body_filter 等幾乎所有關鍵階段。

比如前面提到的鑑權與路由邏輯,放到 OpenResty 中大概是這個樣子:

location /api/ {
    access_by_lua_block {
        local api_key = ngx.req.get_headers()["X-API-Key"]
        if not api_key then
            return ngx.exit(401)
        end

        -- 呼叫封裝好的 Lua 模組:透過非阻塞的 resty.redis 查庫、判權並計算路由
        local tenant_upstream, err = require("gateway.auth").verify_and_route(api_key)
        if not tenant_upstream then
            ngx.log(ngx.ERR, "auth failed: ", err)
            return ngx.exit(403)
        end

        -- 將計算出的目標上游賦給 NGINX 變數,交由後續階段或 balancer_by_lua 轉發
        ngx.var.target_upstream = tenant_upstream
    }

    proxy_pass http://$target_upstream;
}

你不需要把所有邏輯都塞進配置檔案,而是像寫普通後端應用一樣,把程式碼拆分成獨立的 Lua 模組(如上面的 gateway.auth),配合版本控制做單元測試和程式碼審查。

你可能會問:現在的 NGINX 配合 njs 不也能寫程式碼、用 ngx.fetch() 發非同步請求嗎?為甚麼還要用 OpenResty?

確實,njs 非常適合做輕量級的配置擴充套件和簡單的 HTTP 呼叫。但當閘道器進入深水區時,兩者的邊界就很清晰了:

  1. 原生協議的非阻塞客戶端生態:OpenResty 提供了底層的非阻塞 cosocket API。當 Lua 程式碼去查 Redis、MySQL、PostgreSQL 或 Kafka 時,等待網路返回的 Lua 協程會自動掛起,NGINX worker 轉頭就能去處理其他成千上萬個併發請求。更重要的是,這些原生二進位制協議客戶端(如 lua-resty-redis)自帶連線池且經過了十多年的高併發驗證,不用統統退化成 HTTP 介面去調。
  2. 零 Reload 的底層控制力:在開源版 NGINX 中,哪怕你用指令碼算出了新的上游節點或新租戶的 SSL 證書,也很難在不重啟(Reload)程序的前提下直接接管底層的連線重試與握手。而 OpenResty 的 balancer_by_lua 和 ssl_certificate_by_lua 可以直接在記憶體裡實現上游節點秒級擴縮容、自定義重試策略以及海量域名的動態證書下發,全程零 Reload。
  3. 開箱即用的閘道器級標準件:閘道器常見的痛點——比如漏桶/令牌桶複合限流(lua-resty-limit-traffic)、程序內 LRU + 共享記憶體多級快取防擊穿(lua-resty-mlcache)、主動健康檢查等,在 OpenResty 裡都是現成的官方或社群標準庫,拿來就能組裝,不必自己從頭造輪子。

選型邊界:甚麼時候該從 NGINX 切到 OpenResty?

如果你的 NGINX 閘道器開始出現下面這些需求,就說明該考慮 OpenResty 了:

  • 深度依賴外部儲存與多級快取:閘道器需要高併發直連 Redis、資料庫或訊息佇列,並且需要連線池與 Worker 內 LRU + 共享記憶體(Shared Dict)組成的多級快取來扛住流量峰值,而不是簡單發個 HTTP 鑑權子請求。
  • 需要全動態的底層控制(免 Reload):上游節點頻繁變動、需要根據業務狀態實時接管負載均衡策略,或者要為成千上萬個自定義域名動態載入 TLS 證書,不能忍受頻繁 nginx -s reload 帶來的連線抖動和效能損耗。
  • 計算密集或複雜流式處理:需要在閘道器層做大規模請求/響應體改寫、複雜加解密,或是對 AI 介面的 SSE 流式響應做逐塊審計與 Token 統計,需要 LuaJIT 級別的執行效率和透過 FFI 直接呼叫 C 庫的能力。
  • 希望工程化管理閘道器邏輯:原本散落在 nginx.conf、小指令碼和外部服務裡的規則越來越亂,團隊希望用模組化、可單測的應用程式碼來統一收口閘道器邏輯。

反過來,如果你的閘道器只是做做固定規則的反向代理、靜態檔案服務,或者用幾行 njs 指令碼改改 Header 就能輕鬆搞定,那保留原生 NGINX 就足夠了,沒必要為了換技術棧而折騰。

另外要提醒的是,OpenResty 賦予了閘道器寫業務程式碼的能力,也就意味著你要用對待應用程式碼的態度來對待它:Redis 超時怎麼降級?本地快取怎麼失效?程式碼怎麼釋出回滾?這些工程問題依然需要結合業務認真設計。

加了 Lua 會變慢嗎?聊聊真實場景下的效能

很多人好奇:引入了 Lua,OpenResty 會比原生 NGINX 慢嗎?或者反過來,它比 NGINX 的其他擴充套件方式更快嗎?這要分場景看:

  1. 純靜態轉發場景:如果大家都不跑額外邏輯,只做純粹的反向代理和 TLS 解除安裝,兩者的吞吐量和延遲基本沒有區別——畢竟 OpenResty 底下跑的就是同一個 NGINX 核心。
  2. 動態業務閘道器場景:一旦加上了高頻鑑權、動態路由、資料脫敏或流式響應處理,OpenResty 往往比“NGINX + auth_request 外部服務”甚至解釋執行的輕量指令碼更有優勢。一方面,它省去了跨程序、跨網路呼叫的序列化和通訊開銷;另一方面,LuaJIT 擁有真正的即時編譯器(JIT)和極低開銷的協程模型,在應對高併發、重邏輯時,CPU 消耗和記憶體 GC 表現都非常強悍。

當然,LuaJIT 再快,也救不了糟糕的外部依賴。如果你在每個請求裡都去跑一個沒有本地快取保護的慢速查詢,吞吐量照樣會掉下來。如果你準備用 wrk 等工具做對比壓測,記得讓兩邊實現完全對等的業務邏輯,並把快取命中率、下游超時等真實變數考慮進去。

已經在用 NGINX,平滑遷移的成本高嗎?

包袱很小。因為 OpenResty 完全相容標準 NGINX,你現有的 nginx.conf、各種 server、location、upstream 配置通常可以直接拿過來用。最穩妥的做法是:先把閘道器底層平替成 OpenResty,保持原有純代理配置不變;等跑穩了,再往特定的 location 裡逐步替換或新增 Lua 邏輯。

不過在動手替換前,有幾個細節得留心:雖然啟動命令可能都叫 nginx,但你要確認原 NGINX 用到的第三方編譯模組、動態模組路徑、執行許可權以及系統啟動指令碼,在目標 OpenResty 環境中是否對齊。

實操時,建議先匯出原例項的 nginx -V 編譯引數進行比對;然後在測試環境回放代表性流量,重點驗證錯誤處理、超時配置、日誌格式和上游連線池是否符合預期。等灰度切流驗證無誤後,再全量替換。

總結與下一步

如果原生 NGINX(配合簡單的配置或輕量指令碼)還能輕鬆應付,就保持現狀;如果閘道器裡的業務邏輯越來越重,開始觸及效能、外部儲存連線池或免 Reload 動態控制的瓶頸,那 OpenResty 絕對值得一試。

本文是 OpenResty 教程系列的一部分。如果你準備動手嘗試,接下來可以閱讀實操指南 從 NGINX 遷移到 OpenResty:配置檢查、並行驗證與回滾,或者先了解一下 OpenResty 包含哪些核心元件。

關注我們

歡迎訪問 OpenResty 官方部落格,也歡迎掃碼關注我們的微信公眾號。

OpenResty 部落格微信公眾號