インストレーションとコンパイル時のオプション¶
ビルドは./configure
コマンドを使って設定されます。configureはNGINXが接続の処理時に使うことができるメソッドを含めたシステムのあらゆる特徴を定義します。最後にMakefileを作成します。
設定コマンドは以下のパラメータをサポートします:
ファイルとパーミッション¶
- –prefix=*path*
- ファイルを提供するディレクトリを定義します。This same directory will also be used for all relative paths set by configure (except for paths to libraries sources) and in the nginx.conf configuration file. デフォルトでは
/usr/local/nginx
ディレクトリに設定されます。 - –sbin-path=*path*
- NGINX実行ファイルの名前を設定します。この名前はインストールの間でのみ使われます。デフォルトではファイルは
prefix/sbin/nginx
という名前です。 - –conf-path=*path*
nginx.conf
設定ファイルの名前を設定します。必要であれば、コマンドラインパラメータ-c file
の中で指定することで、NGINXは異なる設定ファイルを使って常に開始されるように設定することができます。デフォルトでは、ファイルの名前はprefix/conf/nginx.conf
です。- –pid-path=*path*
- メインプロセスのプロセスIDを格納するnginx.pidファイルの名前を設定する。インストレーションの後で、ファイル名はpidディレクティブを使って
nginx.conf
設定ファイル内で常に変更することができます。デフォルトでは、ファイルの名前はprefix/logs/nginx.pid
です。 - –error-log-path=*path*
- 初期のerror, warning, および diagnosticファイルの名前を設定する。インストレーションの後で、ファイル名はerror logディレクティブを使って
nginx.conf
設定ファイル内で常に変更することができます。デフォルトでは、ファイルの名前はprefix/logs/error.log
です。特別な"stderr"値はNGINXに事前設定のメッセージを標準エラーに記録するように指示します。 - –http-log-path=*path*
- HTTPサーバの初期リクエストログの名前を設定する。インストレーションの後で、ファイル名はaccess logディレクティブを使って
nginx.conf
設定ファイル内で常に変更することができます。デフォルトでは、ファイルの名前はprefix/logs/access.log
です。 - –user=*name*
- ワーカープロセスによって使われる特権の無いユーザの名前を設定します。インストレーションの後で、その名前はuserディレクティブを使って
nginx.conf
設定ファイル内で常に変更することができます。デフォルトのユーザ名はnobodyです。 - –group=*name*
- ワーカープロセスによって使われる特権のないグループの名前を設定します。インストレーションの後で、その名前はuserディレクティブを使って
nginx.conf
設定ファイル内で常に変更することができます。デフォルトでは、権限が無いユーザののグループ名が設定されます。
イベントループ¶
- –with-select_module, –without-select_module
- サーバが
select()
メソッドを使うことができるモジュールのビルドを有効あるいは無効にします。プラットフォームがkqueue
,epoll
,rtsig
, あるいは/dev/poll
のようなもっと適切なメソッドをサポートしていないようであれば、このモジュールが自動的にビルドされます。 - –with-poll_module, –without-poll_module
- サーバが
poll()
メソッドを使うことができるモジュールのビルドを有効あるいは無効にします。プラットフォームがkqueue
,epoll
,rtsig
, あるいは/dev/poll
のようなもっと適切なメソッドをサポートしていないようであれば、このモジュールが自動的にビルドされます。
任意のモジュール¶
- –without-http_gzip_module
- HTTPサーバの応答を圧縮するモジュールをビルドすることを無効にします。このモジュールを構築して実行するにはzlibライブラリが必要になります。
- –without-http_rewrite_module
- HTTPサーバがリクエストをリダイレクトし、リクエストのURIを変更できるようにするモジュールのビルドを無効にします。このモジュールを構築して実行するにはPCREライブラリが必要です。モジュールは実験的なもので、そのディレクティブは将来変わるかもしれません。
- –without-http_proxy_module
- HTTPサーバのプロキシモジュールのビルドを無効にします。
- –with-http_ssl_module
- HTTPプロトコルのサポートをHTTPサーバに追加するモジュールのビルドを有効にします。このモジュールはデフォルトでは構築されません。このモジュールを構築して実行するにはOpenSSLライブラリが必要です。
- –with-pcre=*path*
- PCREライブラリのソースへのパスを設定します。ライブラリの配布物(バージョン 4.4-8.21)はPCRE サイトからダウンロードして解凍する必要があります。後はNGINXの
./configure
とmake
で終わります。ライブラリはlocationディレクティブ内での正規表現のサポートとngx_http_rewrite_moduleのために必要とされます。FreeBSDシステム上のsystem PCREについては、以下の注意 を見てください。 - –with-pcre-jit
- "jsut-in-time compilation"サポートを持つPCREライブラリをビルドします。
- –with-zlib=*path*
- zlibライブラリのソースへのパスを設定します。ライブラリの配布物(バージョン 1.1.3 - 1.2.5) はzlib サイトからダウンロードして解凍する必要があります。後はNGINXの
./configure
とmake
で終わります。ライブラリはngx_http_gzip_moduleモジュールのために必要です。
Compilation Controls¶
- –with-cc-opt=*parameters*
- CFLAGS 変数に追加される、追加のパラメータを設定します。
- –with-ld-opt=*parameters*
- linkの間に使われる追加のパラメータを設定します。
例¶
パラメータの使い方の例(これらは全て一行で記述される必要があります):
設定
--sbin-path=/usr/local/nginx/nginx
--conf-path=/usr/local/nginx/nginx.conf
--pid-path=/usr/local/nginx/nginx.pid
--with-http_ssl_module
--with-pcre=../pcre-4.4
--with-zlib=../zlib-1.1.3
注意¶
FreeBSDにおいてsystem PCREライブラリを使う場合は、以下のオプションが指定されなければなりません:
--with-ld-opt="-L /usr/local/lib" \
--with-cc-opt="-I /usr/local/include"
select()
によってサポートされるファイルの数が増加されなければならない場合は、以下のように指定することもできます:
--with-cc-opt="-D FD_SETSIZE=2048"