トップ | リロード | 新規 | 一覧 | 単語検索 | 最終更新 | ヘルプ

nginxとは。 †

nginxはロシアのIgor Sysoev氏によって開発されているHTTPサーバ兼リバースProxyのソフトウェアであり、「エンジン エックス」（engine x）と発音する。apacheと違い、リクエストに対してスレッドを起動しない為、メモリやCPUのオーバーヘッドが極力まで抑えられており、大量のリクエストを幅くことができる。反面、１つのリクエストが無限ループに入ると、システム全体が停止する。そのため、主にサーバー群のフロントサーバーとして、リバースプロキシ＋静的コンテンツのhttpサーバー（画像や静的なページなど）として利用するのが適切である。（要するに確実に停止しない処理で膨大なリクエストを捌く必要があるものを担当させる） 公式ページ

導入 †

インストール †

必要とするモジュール †

下記のライブラリが必要となるため、先にインストールしておく必要がある。

1. PCREライブラリ
2. OpenSSL（SSLを利用する場合）

ソースからのインストール手順 †

＜初期準備＞

# yum install pcre-devel zlib-devel expat-devel

＜dav extを利用する場合＞

# cd /usr/local/src
# git clone https://github.com/arut/nginx-dav-ext-module

※但し、nginx ではWebDavとしての機能は十分でなく参照のみ機能

＜Luaを利用する場合＞

# cd /usr/local/src
# git clone https://github.com/openresty/lua-nginx-module

＜安定版＞※オプションで不必要なものは外してください。

# wget http://nginx.org/download/nginx-1.16.1.tar.gz
# tar zxvf nginx-1.16.1.tar.gz
# cd nginx-1.16.1
# ./configure 
              --with-http_ssl_module 
              --with-openssl=/usr/local/src/openssl-1.0.2n
              --with-http_gzip_static_module
              --with-http_stub_status_module 
              --with-http_dav_module
              --with-http_v2_module
              --with-http_realip_module
              --with-http_gzip_static_module
              --with-http_stub_status_module
              --with-http_addition_module
              --with-cc-opt=-Wno-error
              --with-ld-opt=
              --add-module=/usr/local/lib/ruby/gems/2.4.0/gems/passenger-5.1.11/src/nginx_module
              --add-module=/usr/local/src/nginx-dav-ext-module
              --add-module=/usr/local/src/lua-nginx-module
# make
# make install

※1.5.10からは、Googleが提唱するHTTP速度向上プロトコルSPDYに対応している。
※opensslのパス指定はインストールフォルダではなく、ソースフォルダを指定する。
※ほかのオプションはここが参考になる。

＜Passenger付き＞

# gem install passenger
# passenger-install-nginx-module          <- configureはここで行われるため下の行は参考
# ./configure --prefix='/usr/local/nginx'
                    --with-http_ssl_module
                    --with-http_v2_module
                    --with-http_realip_module
                    --with-http_gzip_static_module
                    --with-http_stub_status_module
                    --with-http_addition_module
                    --with-cc-opt=-Wno-error
                    --with-ld-opt='' --add-module='/usr/local/lib/ruby/gems/2.2.0/gems/passenger-5.1.3/src/nginx_module

nginx cache purgeをモジュールとして追加 †

nginxのキャッシュクリア方法には、「時間経過による削除」と「全削除」の２種類しかないため、キャッシュクリアのモジュールを追加するため以下もインストールする。

# cd <nginxのフォルダ>
# mkdir srclib
# cd srclib
# wget http://labs.frickle.com/files/ngx_cache_purge-2.1.tar.gz
# tar zxvf ngx_cache_purge-2.1.tar.gz
# ./configure --with-http_ssl_module --add-module=srclib/ngx_cache_purge-2.1

ngx_pagespeedをモジュール †

pagespeedは元は apache用でgoogleによって作られたものであるが、現在 nginx用にも存在する。機能としては以下のとおり。（詳細は公式サイトを参照のこと）

• Web ページのキャッシュ保持時間の変更
• ページ内に埋め込まれている CSS や JavaScript の外部ファイル化
• 複数の CSS ファイルの連結
  • サイズの小さい CSS や JavaScript ファイルをページ内に埋め込み
• 冗長なホワイトスペースの削除
• タグ内の冗長な属性の削除
• コメントの削除
• 不要なクォート文字の削除
• CSS や JavaScript の minify

※インストールは、公式サイトから git や zip でダウンロードし、ngx_cache_purgeと同じ方法でモジュール追加する。
設定のサンプルページ

stub_statusモジュール †

nginxの現在の接続数などを表示するモジュール。nginx をコンパイルする時に指定。

--with-http_stub_status_module

nginx.conf 内では、locationディレクティブで指定

location /status {
    stub_status on;
}

これによって該当ページに接続情報が表示される。

Active connections: 1                                         <- 現在の接続数
server accepts handled requests
 5 5 4                                                                   <- 受け付けた接続総数, 制御した接続総数, 制御した要求総数
Reading: 0 Writing: 1 Waiting: 0                           <- リクエストヘッダー読込中, リクエストボディの処理中, keep-alive接続数

その他のモジュール †

stickey ディレクティブの追加 †

stickeyディレクティブは、upstream モジュールによって、接続サーバーに複数のサーバーを指定し、ロードバランシングを行う際に、ステートフルな websocket 接続などの場合に、cookieを利用して自動的に同一接続であることを判定し、同じのサーバーに再接続させるためのものである。

現状、このディレクティブは追加モジュールとなっているので下記の手順で追加が必要となる。（下記操作は nginx のソースフォルダ内で実行）

# mkdir modules
# cd modules
# wget https://bitbucket.org/nginx-goodies/nginx-sticky-module-ng/get/f2adff04b8e3.zip
# unzip f2adff04b8e3.zip
# mv nginx-goodies-nginx-sticky-module-ng-f2adff04b8e3 sticky
# rm -f f2adff04b8e3.zip

これでモジュール追加の準備ができたので、configure のオプションに下記を追加する。

--add-module=./modules/sticky

stickeyモジュールの公式ページ

Luaモジュール †

解説ページ１
公式ソースページ

# mkdir modules
# cd modules
# wget https://github.com/openresty/lua-nginx-module/archive/master.zip
# unzip master.zip
# rm -f master.zip
# mv lua-nginx-module-master lua

これでモジュール追加の準備ができたので、configure のオプションに下記を追加する。

--add-module=./modules/lua

※Luaは、LuaJIT2.0.3がおすすめ。また so ファイルのライブラリパスを /etc/ld.so.conf.d/に設置して、ldconfig を実行することを忘れないこと。

Lua-resty-redisモジュール †

公式ページ

これは、pure Lua のライブラリなので、Lua のライブラリパスに設置すれば利用できます。

http Redisモジュール。 †

Redis v.1 の公式ページ
Redis v.2 の公式ページ１ Redis v.2 の公式ページ２

Redis1

# wget http://people.freebsd.org/~osa/ngx_http_redis-0.3.7.tar.gz

Redis2

# wget https://github.com/agentzh/redis2-nginx-module/archive/v0.11.tar.gz

参考例１

参考２

location /redis {
    internal;
    set            $redis_key $host;
    redis_pass     127.0.0.1:6379;
}
location /redis2 {
    internal;
    redis2_query get testkey;
    redis2_pass localhost:6379;
}

※internal をつけると、内部からのみ呼び出し可能となる。

misc モジュール †

但し misc モジュールには、ngx_devel_kit が必要になる。

devel-kit公式ページ misc公式ソースページ

# wget https://github.com/simpl/ngx_devel_kit/archive/v0.2.19.tar.gz
# wget https://github.com/openresty/set-misc-nginx-module/archive/v0.26.tar.gz

コンパイル時のオプション等の表示 †

# nginx -V

定義ファイルの設定 †

nginx.confの設定 †

設定ファイルは、apache に比べてば非常にシンプルとなっている。

参考ページ

基本設定 †

イベント設定 †

events { } で囲われた部分がイベントに関する設定を行う。

httpサーバー設定 †

http { } （以下、httpブロックと呼ぶ）で囲われた部分がhttpサーバーに関する設定を行う。

バーチャルサーバーブロック †

httpの中で、server{} と、複数のバーチャルサーバーの設定を行うことができる。通常ここは別ファイルにしておくとわかりやすい。

※sslのサーバーブロックで指定するサーバー名は、SSLのサーバ証明書で指定したCN（Common Name）と同じサーバ名を指定する事。

またサーバーブロックでは、それぞれの location 設定を下記のような指定で行うことができる。

location / {
    root   html;
    index  index.html index.htm;
}
location = /50x.html {
    root   html;
}
location ~ \.php$ {
    proxy_pass   http://127.0.0.1;
}
location ~ /\.ht {
    deny  all;
}

sslの設定サンプル †

ssl_prefer_server_ciphers  on;
ssl_protocols                      SSLv3 TLSv1 TLSv1.1 TLSv1.2;
ssl_ciphers                          AESGCM:RC4:HIGH:!MD5:!aNULL;

location構文 †

location構文はサーバーに到着したURIを解析し処理を振り分ける為の構文で、locaton の中に location を記述することもできる。

※４番の正規表現解説：^を指定することで行の先頭からチェックを行う宣言をし、/path/ という文字が行の先頭から合致し、「 .* 」 の組み合わせで、改行を除く任意の１文字（ピリオド）を、０回以上の繰り返し（アスタリスク）チェック。その後ろに エスケープにピリオド 「 \. 」 でピリオドの文字として認識したうえで、php と文字をいれているので、要するに「 .php 」という拡張子を指定しており、最後のドルマークが行の最後であることから、「 .php 」で最後終わる文字列であることが指定されている。また丸括弧で囲った/path/以降の文字列と拡張子の部分は、後で $1 として参照できる。

例：http://www.mydomain.com/path/login_form/passcheck/key_check.php

上記４番とこの例は合致し、下記の変数に値が入る

• $scheme = http
• $host = www.mydomain.com
• $request_uri = /path/login_form/passcheck/key_check.php
• $1 = login_form/passcheck/key_check.php

nginxでの正規表現 †

ここではよく利用させる規則のみ説明する。注意：~ マークの行は正規表現扱いとなるため、ピリオドなどは振る舞いが下記の形にかわる。

upstream設定 †

upstreamは、リバースプロキシーやロードバランサなどに利用するサーバーセットを記述するディレクティブであり、upstream 名を、location ディレクティブの中の、 proxy_pass に指定することで作動する。基本は、httpブロックの中に以下のように設定する。公式解説

upstream load_balancer {                          <- upstream 名はなんでもOK。
     ip_hash;                                              <- IPをhashして、接続元ＩＰが同じ場合、接続するサーバーを同じにする。
     least_conn;                                          <- 一番少ない接続サーバーへの接続優先
     server 127.0.0.3:8000 down;
     server 127.0.0.3:8001 weight=5;          <- weight は複数サーバーの時のバランス確率。
     server 192.168.0.1:8000 max_fails=3  fail_timeout=30s;
     server 192.168.0.1:8001 backup;
}
server {
     listen                80;
     server_name     big.server.com;
     access_log       logs/access.log;
     location / {
       proxy_pass      http://load_balancer;
     }
}

rewrite構文 †

rewtite文はよく使われると思うが、正規表現の関係で意味不明な文になりやすく、説明もすでに正規表現を理解している前提が多いのでここでは簡単にわかるように説明したい。

例） rewrite ^$ http://$host/chnge/$1;

initスクリプト †

サンプルサイト

PHPの利用 †

nginxでは、apacheでいう、mod_php のようなものが存在しません。そのためphpの展開処理は、php-fpm というプロセスを起動し、nginx側からはポートを利用してアクセスする形になります。そのため、php の処理部分だけを、他のサーバーに処理させることも容易です。

pnp-fpm のインストール †

# yum install php-fpm
# chkconfig php-fpm on

※phpをソースからインストールする場合は、configur 設定で、php-fpm を enable にすると一緒にインストールされる。

php-fpm の設定 †

修正箇所の例（すでに初期値が設定されているので設定の必要はないが参考までに）

# vi /etc/php-fpm.d/www.conf
  user = nginx
  group = nginx
  pm.max_children = 5
  pm.start_servers = 1
  pm.min_spare_servers = 1
  pm.max_spare_servers = 2
  pm.max_requests = 200

※php-fpmの標準ポートは9000番です。また最初は127.0.0.1 （自分）にだけ、アクセス許可されています。

nginx側の設定 †

nginx.conf のサーバー設定の中に、以下のlocationディレクティブを追加する。

ポートによる接続 †

 location ~ \.php$ {
      root           /usr/local/nginx/html;
      fastcgi_pass   127.0.0.1:9000;
      fastcgi_index  index.php;
      fastcgi_param  SCRIPT_FILENAME  $request_filename;
      include        fastcgi_params;
   }

※またサーバ設定の index 設定にも、index.php を追加しておくこと。

socketによる接続。 †

 location ~ \.php$ {
      root           /usr/local/nginx/html;
      fastcgipass    unix:/var/run/php-fpm/www.sock;
      fastcgi_index  index.php;
      fastcgi_param  SCRIPT_FILENAME  $request_filename;
      include        fastcgi_params;
   }

また /etc/php-fm.conf もそれに合わせて修正する。

; listen = 127.0.0.1:9000
listen = /var/run/php-fpm/www.sock

php-fpmの起動 †

yumで、php-fpmをインストールしている場合は、servceコマンドで起動できる。

# service php-fpm start

その後、nginxも再起動させる。

# service nginx restart

nginxの起動 †

再起動

# nginx -s reload

nginx.confの文法チェック †

# nginx -t -c ./nginx.conf

nginx のセキュリティ設定 †

なぜか location ディレクティブ内でしか認識されない。バグ？

※autoindex off;は初期値だが、むやみに on にしない。

ヘッダーチェックのサイト †

• https://securityheaders.com/
• http://cyh.herokuapp.com/cyh

plugins †

• Wiki Extention

Tips&トラブルシューティング †

Request Entity Too Largeというエラーが表示される。 †

nginxの通信 body サイズの初期値が1MB であるため、ファイル転送などで これを超えるファイルサイズを転送しようとすると発生する。

# vi nginx.conf
 server {
     client_max_body_size 20M;
 }

上記のようにサーバーディレクティブにbodyサイズの上限を変更する。

リンク切れをチェックする。 †

• http://www.dead-link-checker.com/ja/
• http://validator.w3.org/checklink

参考リンク †

nginx連載3回目: nginxの設定