【Node.js24.x】Object::maxHeaderSizeプロパティの使い方

maxHeaderSizeプロパティは、Node.jsのHTTPまたはHTTPSサーバーが受信するリクエストヘッダーの最大許容サイズ（バイト単位）を保持するプロパティです。このプロパティは、主にセキュリティ上の理由から導入されており、悪意のある攻撃によってサーバーのメモリが過剰に消費されるのを防ぐことを目的としています。

Node.jsのHTTPサーバーがクライアントからのリクエストを受け取った際、そのリクエストのヘッダー部分のサイズがこのmaxHeaderSizeプロパティで設定された値を超過した場合、サーバーはそのリクエストを拒否します。これにより、大規模なヘッダーを持つ不正なリクエストや、意図的にサーバーを停止させようとするサービス拒否（DoS）攻撃からシステムを保護することができます。

このプロパティは、http.createServer()やhttps.createServer()などのサーバーインスタンスを作成する際に、オプションオブジェクトの一部として設定することが可能です。例えば、http.createServer({ maxHeaderSize: 32768 }, ...)のように指定することで、最大ヘッダーサイズを32KBに設定できます。設定しない場合のデフォルト値は通常16KB（16384バイト）ですが、Node.jsのバージョンによって異なる場合があります。

ウェブアプリケーションによっては、セッション情報や認証トークンなどで大きなクッキーやカスタムヘッダーが必要となる場合があります。その際には、このmaxHeaderSizeの値を適切に調整する必要があります。ただし、値を過度に大きく設定すると、サーバーのメモリ使用量が増加し、潜在的なセキュリティリスクが高まる可能性があるため、システムエンジニアはアプリケーションの具体的なニーズとセキュリティのバランスを考慮して慎重に値を決定することが重要です。

Copy
1const http = require('http');
2
3http.createServer({ maxHeaderSize: 16384 }, () => {});

引数なし

引数はありません

戻り値なし

戻り値はありません