OpenResty は、NGINX をコアに LuaJIT、ngx_lua、各種 Lua ライブラリを統合したプラットフォームです。リバースプロキシや静的ファイル配信だけなら両者の性能差はほとんどなく、標準 NGINX で十分です。Redis を使った認証、テナントごとの動的ルーティング、reload なしでのアップストリームや証明書の切り替えなど、ゲートウェイがビジネスロジックを担うようになったときが、OpenResty に切り替えるタイミングです。

リクエストごとに Redis でアカウントの停止状態を確認する、テナントに応じてアップストリームクラスタを切り替える、トークンの利用枠に基づいてレート制限する、バックエンド障害時に自動でフェイルオーバーする。NGINX でも njs(NGINX JavaScript)、auth_request、独自 C モジュールで対応できますが、ロジックが重くなると、nginx.conf と散在するスクリプトの保守、外部認証サービスによる余計なネットワークホップ、アップストリームや証明書を変えるたびの reload が課題になります。OpenResty なら、NGINX のプロキシ、TLS、接続管理を維持したまま、高速な Lua コードでゲートウェイの各フェーズを制御できます。

具体的なゲートウェイの例を通して、両者の実際の守備範囲と、NGINX を OpenResty に切り替えるべきタイミングを見ていきます。全体像についてはOpenResty とは?Nginx・LuaJIT との関係から主な用途までをご覧ください。

ゲートウェイが単なる「交通整理役」ではなくなるとき

API ゲートウェイにテナント認証と動的ルーティングを追加するとします。リクエストごとに次の処理が必要です。

  1. リクエストヘッダー X-API-Key からアカウント識別子を取得する。
  2. Redis でアカウントが有効か確認し、テナント設定とバックエンドノード一覧を取得する。
  3. テナントのランクに応じてアップストリームを動的に選択する。アカウントが停止中、または問い合わせに失敗した場合は、対応するエラーコードを返して拒否する。
  4. 呼び出し回数や利用枠を集計し、しきい値を超えたらレート制限を適用し、許可されたリクエストをバックエンドへ転送する。

単純なヘッダー検証や軽量な HTTP サブリクエストであれば、NGINX 標準のディレクティブ、njs、auth_request でも実現できます。しかし、同時接続数の多い状況で Redis に直接アクセスし、多段キャッシュでキャッシュスタンピードを防ぎ、取得したデータに応じてロードバランシングをリアルタイムに制御するとなると、寄せ集めの構成は性能と保守性の両面ですぐに限界を迎えます。

ゲートウェイにコードを書く:OpenResty の解決方法

OpenResty では ssl_certificate、rewrite、access、balancer、body_filter など、ほぼすべての主要な NGINX フェーズに Lua コードを組み込めます。

先ほどの認証とルーティングは、たとえば次のように記述できます。

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

        -- 非ブロッキングの resty.redis を使い、Redis への問い合わせ、認可、ルーティングを行う Lua モジュール
        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;
}

すべてのロジックを設定ファイルに詰め込む必要はありません。通常のバックエンドアプリケーションと同じように、上記の gateway.auth のような独立した Lua モジュールに分割し、バージョン管理、単体テスト、コードレビューを行えます。

NGINX の njs との違い

「NGINX の njs でもコードを書けるし、ngx.fetch() で非同期リクエストもできるのでは? なぜ OpenResty が必要なのか」と思うかもしれません。

確かに njs は軽量な設定拡張や単純な HTTP 呼び出しに適しています。しかし、ゲートウェイが本格的な処理を担うようになると、両者の違いが明確になります。

  1. ネイティブプロトコル向けの非ブロッキングクライアント: OpenResty は低レベルの非ブロッキング cosocket API を提供します。Lua が Redis、MySQL、PostgreSQL、Kafka に問い合わせている間、ネットワークの応答を待つ Lua コルーチンは自動的に一時停止(yield)し、NGINX ワーカーは他の何千もの同時リクエストを処理できます。lua-resty-redis などのネイティブバイナリプロトコル用クライアントには接続プールがあり、10 年以上にわたり高負荷環境で使われてきました。すべてを HTTP API 経由にする必要はありません。
  2. reload なしの低レベル制御: オープンソース版 NGINX では、新しいアップストリームノードや新規テナントの SSL 証明書をスクリプトで決定できても、プロセスを reload せずに接続リトライやハンドシェイクまで制御するのは困難です。OpenResty の balancer_by_lua と ssl_certificate_by_lua を使えば、アップストリームノードの秒単位での増減、独自のリトライ戦略、大量ドメインへの証明書の動的配布をメモリ上で実現でき、reload は一切不要です。
  3. すぐ使えるゲートウェイ向け標準ライブラリ: リーキーバケット/トークンバケットによる複合レート制限(lua-resty-limit-traffic)、ワーカープロセス内の LRU と共有メモリを組み合わせ、キャッシュスタンピードを防ぐ多段キャッシュ(lua-resty-mlcache)、アクティブヘルスチェックなど、ゲートウェイでよく必要になる機能には公式またはコミュニティの定番ライブラリが用意されています。自前で一から作らずに組み合わせられます。

NGINX から OpenResty に切り替えるべきタイミング

次のような要件が NGINX ゲートウェイに現れたら、OpenResty を検討しましょう。

  • 外部ストレージや多段キャッシュへの依存度が高い: Redis、データベース、メッセージキューへ同時接続数の多い状況でアクセスし、接続プールと、ワーカープロセス内の LRU と共有メモリ(Shared Dict)を組み合わせた多段キャッシュでピーク時のトラフィックをさばく。単純な HTTP 認証サブリクエストでは足りない。
  • reload なしで低レベルまで動的に制御したい: アップストリームノードが頻繁に変わる、サービスの状態に応じてロードバランシングの方式をリアルタイムに切り替える、あるいは多数のカスタムドメインに TLS 証明書を動的に読み込む必要があり、頻繁な nginx -s reload による接続の瞬断や性能低下を許容できない。
  • 計算負荷の高い処理や複雑なストリーミング: ゲートウェイ層での大量のリクエスト/レスポンスボディの書き換え、複雑な暗号化・復号、AI API の SSE ストリーミングレスポンスをチャンクごとに監査してトークンを集計する必要があり、LuaJIT の実行性能や FFI による C ライブラリの直接呼び出しが求められる。
  • ゲートウェイロジックを体系的に管理したい: nginx.conf、小さなスクリプト、外部サービスにルールが分散して管理しづらくなり、モジュール化されたテスト可能なアプリケーションコードに集約したい。

一方、ゲートウェイが固定ルールのリバースプロキシや静的ファイル配信だけを行う場合や、数行の njs でヘッダーを変更できる場合は、標準 NGINX で十分です。技術スタックを変えること自体を目的にする必要はありません。

OpenResty を使えば、ゲートウェイ内にビジネスロジックをコードとして書けます。そのコードもアプリケーションコードとして扱いましょう。Redis がタイムアウトしたときにどう縮退運転するか、ローカルキャッシュをどう無効化するか、コードをどうリリースしてロールバックするか。こうした運用上の設計は引き続き必要です。

OpenResty と NGINX の性能差:Lua を加えると遅くなるか

Lua を導入した OpenResty は、標準 NGINX より遅くなるのでしょうか。あるいは、NGINX の他の拡張方法より速いのでしょうか。処理内容によります。

  1. 静的なプロキシ処理: どちらも追加ロジックを実行せず、リバースプロキシと TLS 終端だけを行うなら、スループットとレイテンシにほとんど差はありません。OpenResty の基盤も同じ NGINX コアだからです。
  2. ビジネスロジックを担う動的ゲートウェイ: 高頻度の認証、動的ルーティング、データマスキング、ストリーミングレスポンスの処理を加えると、OpenResty は「NGINX + 外部 auth_request サービス」やインタープリター型の軽量スクリプトより有利になることが多くあります。まず、プロセス間やネットワーク越しの呼び出しに伴うシリアライズと通信のコストを省けます。また、LuaJIT の本格的な JIT コンパイラと低オーバーヘッドなコルーチンにより、高負荷かつ重いロジックでも CPU 消費と GC の面で高い性能を発揮します。

もちろん、LuaJIT がいくら高速でも、遅い外部依存の問題は解決できません。ローカルキャッシュなしで各リクエストが遅いクエリを実行すれば、スループットは低下します。wrk などで負荷テストを行って比較する場合は、両方に同じビジネスロジックを実装し、キャッシュヒット率や下流のタイムアウトなど実際の条件も考慮してください。

NGINX から OpenResty への移行コスト

移行の負担は小さく抑えられます。OpenResty は標準 NGINX と完全な互換性があるため、既存の nginx.conf、server、location、upstream 設定は通常そのまま使えます。最も安全な方法は、まずゲートウェイの基盤を OpenResty に置き換え、既存のプロキシ設定は維持することです。安定してから、特定の location に Lua ロジックを少しずつ追加または置き換えます。

切り替え前に、元の NGINX 用にコンパイルされたサードパーティモジュール、動的モジュールのパス、実行権限、システム起動スクリプトが、移行先の OpenResty 環境と合っているか確認してください。起動コマンドがどちらも nginx でも、環境が同じとは限りません。

実作業では、まず元のインスタンスで nginx -V を実行してビルドオプションを出力し、比較します。テスト環境で代表的なトラフィックを再生し、エラー処理、タイムアウト設定、ログ形式、アップストリームへの接続プールを重点的に確認します。カナリアリリースで問題がないことを確かめてから、全面移行します。

よくある質問

OpenResty は NGINX より遅いですか?

リバースプロキシや TLS 終端だけなら、ほとんど差はありません。OpenResty の基盤も同じ NGINX コアだからです。認証や動的ルーティングなどのロジックを加える場合は、外部の auth_request サービスやインタープリター型の軽量スクリプトより有利になることが多くあります。ただし、ローカルキャッシュなしで遅い外部依存を呼べば、スループットは低下します。

NGINX の設定は OpenResty でそのまま使えますか?

通常は使えます。既存の nginx.conf、server、location、upstream 設定はそのまま動作するため、まず基盤だけを OpenResty に置き換え、安定してから特定の location に Lua を追加するのが安全です。ただし、元の NGINX 用にコンパイルしたサードパーティモジュール、動的モジュールのパス、起動スクリプトは事前に確認してください。

njs と OpenResty はどちらを選ぶべきですか?

軽量な設定拡張や単純な HTTP 呼び出しなら njs で十分です。Redis や MySQL への非ブロッキングな直接アクセスと接続プール、reload なしでのアップストリームや証明書の動的制御、レート制限や多段キャッシュといった既製ライブラリが必要なら、OpenResty が向いています。

まとめと次のステップ

標準 NGINX と簡単な設定や軽量スクリプトで対応できているなら、そのまま使い続けましょう。ゲートウェイロジックが増え、性能、外部ストレージ接続プール、reload なしの動的制御に限界を感じたら、OpenResty を試す価値があります。

本記事はOpenResty チュートリアルシリーズの一部です。実際に試す方は、NGINX から OpenResty への移行:設定確認、並行検証、ロールバックをご覧ください。先にOpenResty の構成要素を確認しておくのもおすすめです。

このチュートリアルが気に入っていただけましたら、ぜひ本ブログサイトおよび弊社の YouTube チャンネルをご購読ください。ありがとうございます!

著者について

章亦春(GitHub ハンドル: agentzh)は、OpenResty® オープンソースプロジェクトのオリジナル作成者であり、OpenResty Inc. の CEO です。

章亦春は「オープンソース技術」の最も初期の提唱者およびリーダーの一人です。Cloudflare や Yahoo! など、国際的に著名な複数のテック企業で勤務しました。「エッジコンピューティング」「動的トレーシング」「マシンコーディング」の先駆者であり、22 年以上のプログラミング経験と 16 年のオープンソース経験を持ちます。章亦春はオープンソース界で OpenResty® のプロジェクトリーダーとして広く知られており、同プロジェクトは全世界で 4,000 万以上のWeb サイトドメインに採用されています。

OpenResty Inc. は章亦春が 2017 年に設立したエンタープライズソフトウェアスタートアップで、世界最大級の企業を顧客に持ちます。フラッグシップ製品の OpenResty XRay は、動的トレーシング技術を大幅に強化・活用する非侵入型のプロファイリングおよびトラブルシューティングツールです。また、OpenResty Edge 製品は、強力な分散トラフィック管理およびプライベート CDN ソフトウェア製品です。

熱心なオープンソースコントリビューターとして、章亦春は Linux カーネル、Nginx、LuaJIT、GDB、SystemTap、LLVM、Perl など、数多くのオープンソースプロジェクトに 100 万行以上のコードを貢献しています。また、60 以上のオープンソースソフトウェアライブラリを開発しています。

翻訳

英語版の原文と日本語訳版(本文)をご用意しております。読者の皆様による他の言語への翻訳版も歓迎いたします。全文翻訳で省略がなければ、採用を検討させていただきます。心より感謝申し上げます!