Open LiteSpeed Web Serverユーザーズマニュアル
サーバー全般
目次
サーバープロセス
一般設定
インデックスファイル
期限切れの設定
Rewrite制御
ファイルアップロード
MaxMind GeoIP DB
IP2Location DB
ワーカーの数
説明
httpdワーカーの数を指定します。
構文
整数値は1〜16です。
ヒント
[パフォーマンス]ニーズに合わせて適切な番号を設定します。 より多くのワーカーを追加することは、必ずしもより良いパフォーマンスを意味するとは限りません。
実行ユーザ・グループ
説明
サーバープロセスが実行されるユーザー/グループを指定します。 これは、インストールの前にconfigureコマンドを実行するときに、 "--with-user"と "--with-group"というパラメータを使用して設定されます。これらの値をリセットするには、configureコマンドを再実行して再インストールする必要があります。
適用
再インストールが必要です。
ヒント
[セキュリティ]サーバーは、"root"のような特権ユーザーとして実行しないでください。 サーバーが、ログイン/シェルアクセスを持たない特権のないユーザー/グループの組み合わせで実行するように構成されていることが重要です。 一般的にnobodyのユーザー/グループが良い選択です。
プライオリティ
説明
サーバープロセスの優先度を指定します。値の範囲は-20〜20です。 数値が小さいほど優先度が高くなります。
構文
整数
ヒント
[パフォーマンス]通常、ビジー状態のサーバーで優先度を高くすると、Webパフォーマンスが若干高くなります。 データベースプロセスの優先度よりも高い優先度を設定しないでください。
参照
CPUアフィニティ
説明
CPUアフィニティは、プロセスを1つ以上のCPU（コア）にバインドします。 プロセスが常に同じCPUを使用できると、CPUキャッシュに残ったデータを利用できるため有利です。 プロセスが別のCPUへ移動するとCPUキャッシュを利用できず、不要なオーバーヘッドが発生します。
CPUアフィニティ設定は、1つのサーバープロセスを関連付けるCPU（コア）の数を制御します。 最小値は0で、この機能を無効にします。最大値はサーバーのコア数です。 一般に1が最適です。CPUアフィニティを最も厳密に使用し、CPUキャッシュを最大限に活用できるためです。
デフォルト値：0
構文
0から64までの整数値。（0はこの機能を無効にします）
適用
再インストールが必要です。
CloudLinux
説明
CloudLinuxのLightweight Virtual Environment(LVE)が存在する場合に有効にするかどうかを指定します。 LiteSpeedをLVEと併用すると、より優れたリソース管理を実現できます。 詳細については、 http://www.cloudlinux.com を参照してください。
構文
ドロップダウンリストから選択
メモリI/Oバッファサイズ
説明
要求本体およびその動的生成応答を格納するために使用される最大バッファー・サイズを指定します。 この制限に達すると、サーバーはスワッピングディレクトリの下に一時的なスワップファイルを作成し始めます。
構文
整数
ヒント
[パフォーマンス]メモリとディスクのスワップを避けるために、すべての同時要求/応答を収容できる大きさのバッファサイズを設定します。 スワップディレクトリに頻繁にI/Oアクティビティがある場合（デフォルトでは/tmp/lshttpd/swap/）、このバッファサイズは小さすぎるため、LiteSpeedはディスクにスワップします。
参照
スワッピングディレクトリ
説明
スワッピングファイルを配置するディレクトリを指定します。サーバーがchrootモードで起動されている場合、 このディレクトリは新しいルートディレクトリからの相対パスになります。それ以外の場合は、実際のルートディレクトリからの相対パスになります。
サーバーは独自のバーチャルメモリを使用してシステムメモリ使用量を削減します。 バーチャルメモリとディスクスワッピングは、大きなリクエストボディと動的に生成されたレスポンスを保存するために使用されます。 スワッピングディレクトリは十分な空き容量があるディスク上に配置してください。
デフォルト値：/tmp/lshttpd/swap
構文
絶対パス
ヒント
[パフォーマンス] スワッピングをなくすには、スワッピングディレクトリを別のディスクに配置するか、最大I/Oバッファサイズを増やします。
参照
503エラーの自動修復
説明
サーバーをグレースフルリスタートすることで"503 Service Unavailable"エラーの修復を試みるかどうかを指定します。 "503"エラーは通常、外部アプリケーションの誤動作によって発生し、Webサーバーの再起動で一時的に修復できることがあります。 有効にすると、30秒以内に"503"エラーが30件を超えた場合、サーバーは自動的に再起動します。
デフォルト値：No
構文
ラジオボックスから選択
グレースフルリスタートタイムアウト（秒）
説明
グレースフルリスタート時には、新しいサーバーインスタンスが起動した後でも、古いインスタンスは既存の要求を引き続き処理します。 このタイムアウトは、前のインスタンスが終了するまでの待機時間を定義します。 デフォルト値は300秒です。 -1は永遠に待つことを意味します。 0は待機しないことを意味し、直ちに中止します。
構文
整数
統計出力ディレクトリ
説明
Real-Time Statsレポートファイルが書き込まれるディレクトリを指定します。 デフォルトのディレクトリは/tmp/lshttpd/です。
構文
絶対パス。
ヒント
Information サーバーの操作中に.rtreportファイルが1秒ごとに書き込まれます。 不必要なディスク書き込みを避けるには、これをRAMディスクに設定します。
.rtreportファイルはサードパーティ製の監視ソフトウェアと一緒に使用してサーバーの状態を追跡できます。
JSONレポートを出力
説明
.json拡張子を持つ追加のJSON形式レポートファイルを/tmp/lshttpdディレクトリへ出力します。
デフォルト値：No
構文
ラジオボックスから選択
例
ヒント
[情報] これは、ほとんどのプログラミング言語に組み込まれている標準JSON処理ツールを使用して、 LiteSpeedステータスとリアルタイムレポートを自分のアプリケーションへ統合したいアプリケーション開発者に便利です。
MIME設定
説明
このサーバーのMIME設定を含むファイルを指定します。 chrootモードで絶対パスが指定されている場合、実際のルートと常に相対的です。 詳細なMIMEエントリを表示/編集するには、ファイル名をクリックします。
構文
ファイル名への絶対パス又は$SERVER_ROOTからの相対パス
ヒント
Information ファイル名をクリックしてMIME設定を編集します。
初期ログローテーションを無効にする
説明
起動時にサーバーエラーログファイルのローテーションを有効/無効にするかどうかを指定します。 値が「未設定」の場合、初期ログローテーションはデフォルトで有効になっています。
構文
ラジオボタンから選択
サーバー署名
説明
サーバーの署名とバージョン番号を次の場所に表示するかどうかを指定します。 レスポンスヘッダーの「Server」値。 3つのオプションがあります： バージョンを隠すに設定すると、LiteSpeedのみが表示されます。 バージョンを表示するに設定すると、LiteSpeedとバージョン番号が表示されます。 フルヘッダーを隠すに設定すると、サーバーヘッダー全体がレスポンスヘッダーに表示されなくなります。
構文
ドロップダウンリストから選択
ヒント
[セキュリティ]サーバのバージョン番号を公開したくない場合は、バージョンを隠すに設定します。
GeoLocationルックアップを有効にする
説明
IPジオロケーション検索を有効または無効にするかどうかを指定します。 サーバー、バーチャルホスト、またはコンテキストレベルで設定できます。"Not Set"値を使用すると、IPジオロケーションはデフォルトで無効になります。
構文
ラジオボックスから選択
参照
ヘッダー内のクライアントIPを使用
説明
"X-Forwarded-For"HTTPリクエストヘッダーに記載された最初の有効なIPアドレスを、 接続/帯域幅スロットリング、アクセス制御、IPジオロケーションなど、すべてのIPアドレス関連機能に使用するかどうかを指定します。
この機能は、Webサーバーがロードバランサまたはプロキシサーバーの背後にある場合に便利です。 Trusted IP Onlyを選択すると、サーバーレベルの許可リストで定義された信頼済みIPからリクエストが来た場合にのみ、 X-Forwarded-For IPが使用されます。
Keep Header from Trusted IPはTrusted IP Onlyと同じですが、バックエンドで使用されるX-Forwarded-Forヘッダーは、 接続元ピアアドレスを含めるようには変更されません。
Use Last IP (for AWS ELB)は、"X-Forwarded-For"リスト内の最後のIPアドレスを使用します。 AWS Elastic Load Balancerを使用している場合、または実IPが"X-Forwarded-For"リストの末尾に追加されることを想定している場合は、このオプションを選択してください。
構文
ドロップダウンリストから選択
管理者Eメール
説明
サーバー管理者の電子メールアドレスを指定します。 このオプションを指定すると、重大イベントが電子メールで管理者に通知されます（例えば、LiteSpeedサービスがクラッシュを検出したために自動的に再開された場合、またはライセンスの期限切れになった時など）。
構文
Eメールアドレスのカンマ区切りリスト。
ヒント
Information メールアラート機能は、サーバにpostfix、exim、sendmailなどのアクティブなMXサーバがある場合にのみ機能します。
インデックスファイル
説明
URLがディレクトリにマップされたときに順番に検索されるインデックスファイルの名前を指定します。 サーバー、バーチャルホスト、コンテキストレベルでカスタマイズできます。
構文
インデックスファイル名のカンマ区切りリスト。
ヒント
[パフォーマンス]必要なインデックスファイルのみを設定します。
自動インデックス
説明
インデックスファイルにリストされているインデックスファイルがディレクトリで使用できないときに、その場でディレクトリインデックスを生成するかどうかを指定します。 このオプションは、バーチャルホストおよびコンテキストレベルでカスタマイズ可能で、明示的に上書きされるまでディレクトリツリーに沿って継承されます。 生成された索引ページをカスタマイズできます。 オンラインWikiのHow-toを確認してください。
構文
ラジオボックスから選択
ヒント
[セキュリティ] 可能であれば、自動インデックスをオフにして、機密データの漏えいを防ぐことをお勧めします。
参照
自動インデックスURI
説明
インデックスファイルにリストされているインデックスファイルがディレクトリで使用できない場合に、インデックスページを生成するために使用されるURIを指定します。 LiteSpeed Webサーバーは外部スクリプトを使用してインデックスページを生成し、最大限のカスタマイズの柔軟性を提供します。 デフォルトスクリプトは、Apacheと同じ外観のインデックスページを生成します。 生成されたインデックスページをカスタマイズするには、オンラインWikiのHow-toを読んでください。 インデックス対象のディレクトリは、環境変数"LS_AI_PATH"を介してスクリプトに渡されます。
構文
URI
参照
有効期限を有効にする
説明
静的ファイルのExpiresヘッダーを生成するかどうかを指定します。 有効にすると、デフォルトの期限とタイプ別の期限に基づいてExpiresヘッダーが生成されます。
これは、サーバー、バーチャルホスト、コンテキストレベルで設定できます。 下位レベルの設定は上位レベルの設定を上書きします。 コンテキスト設定はバーチャルホストの設定を上書きし、バーチャルホストの設定はサーバーの設定を上書きします。
構文
ラジオボタンから選択
デフォルトの期限
説明
Expiresヘッダー生成のデフォルト設定を指定します。 この設定は、有効期限を有効にするが "はい"に設定されているときに有効になります。 タイプ別の期限で上書きできます。 すべてのページのExpiresヘッダーが生成されるため、必要がない限り、このデフォルトをサーバーまたはバーチャルホストレベルで設定しないでください。 ほとんどの場合、これは頻繁に変更されない特定のディレクトリのコンテキストレベルで設定する必要があります。 デフォルト設定がない場合、タイプ別の期限で指定されていないタイプに対してExpiresヘッダーは生成されません。
構文
A|M秒
このファイルは、基本時間（A | M）に指定された秒を加えた後に期限切れになります。 ベース時刻 "A"はクライアントのアクセス時間に値を設定し、 "M"はファイルの最終変更時刻を設定します。
タイプ別の期限
説明
各MIMEタイプのExpiresヘッダー設定を指定します。
構文
"MIME-type=A|Mseconds"のカンマで区切られたリスト。 このファイルは、基本時間（A|M）に指定された秒を加えた後に期限切れになります。
ベース時刻 "A"はクライアントのアクセス時間に値を設定し、 "M"はファイルの最終変更時刻を設定します。 MIMEタイプはimage/*のようなワイルドカード "*"を受け入れます。
.htaccessから自動読み込み
説明
そのディレクトリに最初にアクセスしたとき、rewritefileディレクティブを使用するHttpContextがそのディレクトリにまだ存在しない場合、 ディレクトリの.htaccessファイルに含まれるRewriteルールを自動的に読み込みます。初回読み込み後にその.htaccessファイルへさらに変更を反映するには、 グレースフルリスタートを実行する必要があります。
バーチャルホストレベルの設定はサーバーレベルの設定を上書きします。デフォルト値：
サーバーレベル：No
VHレベル：サーバーレベル設定を継承
構文
ラジオボックスから選択
ファイルアップロード
説明
Request Body Parserを使用してファイルをアップロードしてサーバーのローカルディレクトリにファイルを解析し、第三者のモジュールによる悪意のある行為を簡単にスキャンできるようにする、追加のセキュリティ機能を提供します。 Request Body Parserは、ファイルパスによるアップロードデータの転送が有効になっているか、モジュールがLSI_HKPT_HTTP_BEGINレベルでLSIAPIのset_parse_req_bodyを呼び出すときに使用されます。 ソースパッケージで提供されるAPIの例
参照
一時ファイルパス
説明
要求本体パーサーが動作している間に、サーバーにアップロードされるファイルが格納される一時ディレクトリ。 デフォルト値は/tmp/lshttpd/です。
構文
絶対パス、または$SERVER_ROOTで始まるパス（ServerおよびVHostレベル）、または$VH_ROOTで始まるパス（VHostレベル）。
一時ファイルのアクセス許可
説明
一時ディレクトリに格納されるファイルに使用するファイル権限を決定します。 サーバーレベルの設定はグローバルで、VHostレベルでオーバーライドできます。
構文
3桁の8進数。デフォルト値は666です。
ファイルパスによるアップロードデータの転送
説明
ファイルデータをパスでアップロードするかどうかを指定します。 有効にすると、アップロード時にファイル自体ではなく、バックエンドハンドラにファイルパスと他の情報が送信されます。 これにより、CPUリソースとファイル転送時間が節約されますが、実装するためにバックエンドに若干の更新が必要です。 無効にすると、ファイルの内容はバックエンドハンドラに転送され、要求本文は引き続きファイルに解析されます。
構文
ラジオボタンから選択
ヒント
[パフォーマンス]下位互換性が問題にならないようにするには、これを有効にしてファイルのアップロード処理を高速化します。
MaxMind GeoIP DB
説明
複数のMaxMindジオロケーションデータベースをここで指定できます。MaxMindには、 Country、Region、City、Organization、ISP、NetspeedタイプのDBがあります。 "Country"、"Region"、"City"タイプの複数のデータベースが設定されている場合、最後の設定が有効になります。
DB名
説明
MaxMind GeoIPデータベース名です。GeoIP2以降、この設定は必須です。
GeoIPからGeoIP2へアップグレードする場合、この設定に"COUNTRY_DB"、"CITY_DB"、または"ASN_DB"を使用すると、 移行を容易にするため、PHPの$_SERVER変数にGeoIP互換エントリ（以下のDB名値別一覧）が自動的に設定されます。
CITY_DB: 'GEOIP_COUNTRY_CODE', 'GEOIP_COUNTRY_NAME', 'GEOIP_CONTINENT_CODE', 'GEOIP_COUNTRY_CONTINENT', 'GEOIP_DMA_CODE', 'GEOIP_METRO_CODE', 'GEOIP_LATITUDE', 'GEOIP_LONGITUDE', 'GEOIP_POSTAL_CODE', and 'GEOIP_CITY'.
COUNTRY_DB: 'GEOIP_COUNTRY_CODE', 'GEOIP_COUNTRY_NAME', 'GEOIP_CONTINENT_CODE', and 'GEOIP_COUNTRY_CONTINENT'.
ASN_DB: 'GEOIP_ORGANIZATION' and 'GEOIP_ISP'.