nginx JavaScript モジュール

nginx JavaScript モジュール

njs は nginx のモジュールで、JavaScript スクリプティングによってサーバーの機能を拡張し、独自のカスタムサーバーサイドロジックとさらに多くの機能を作成できます。

ユースケース

リクエストがアップストリームサーバーに届く前に、njs で複雑なアクセス制御とセキュリティチェックをする
レスポンスヘッダーを操作する
柔軟な非同期コンテンツハンドラーとフィルターを書く

例を参照して、njs のユースケースの詳細をご覧ください。

HTTPの基本的な例

nginx で njs を使用するには

njs スクリプティング言語をインストールする
たとえば http.js などの njs スクリプトファイルを作成する。njs のプロパティとメソッドのリストについては、リファレンスを参照してください。
```
function hello(r) {
    r.return(200, "Hello world!");
}

export default {hello};
```

nginx.conf ファイルで、ngx_http_js_module モジュールを有効にして、http.js スクリプトファイルを使用して js_import ディレクティブを指定する

load_module modules/ngx_http_js_module.so;

events {}

http {
    js_import http.js;

    server {
        listen 8000;

        location / {
            js_content http.hello;
        }
    }
}

njs の開発とデバッグに関して、nginx とは別に使用できるスタンドアロンのコマンドラインユーティリティもあります。

テスト済みの OS とプラットフォーム

FreeBSD / amd64;
Linux / x86, amd64, arm64, ppc64el;
Solaris 11 / amd64;
macOS / x86_64;

nginx.conf 2018 でのプレゼンテーション