MochiuWiki : SUSE, EC, PCB

「NginX- serverコンテキスト」の版間の差分

📢 Webサイト閉鎖と移転のお知らせ
このWebサイトは2026年9月に閉鎖いたします。
新しい記事は移転先で追加しております。（旧サイトでは記事を追加しておりません）

← 古い編集
ビジュアルウィキテキスト
 
(同じ利用者による、間の2版が非表示)
26行目: 26行目:


== listenディレクティブ ==
== listenディレクティブ ==
ポート番号を指定する。<br>
IPアドレスとポート番号を指定する。<br>
複数指定することもできる。<br>
<br>
IPv4 / IPv6、ポート、UNIXドメインソケットをサポートしている。<br>
<br>
  <syntaxhighlight lang="nginx">
  <syntaxhighlight lang="nginx">
  server {
  server {
     listen 80;
     listen 80;
    listen 443 ssl;
    listen [::]:80;
   
   
     # ...略
     # ...略
37行目: 43行目:


== server_nameディレクティブ ==
== server_nameディレクティブ ==
サーバ名を指定する。<br>
サーバ名 (バーチャルホストの識別も可) を指定する。<br>
<br>
完全修飾ドメイン名、ワイルドカード、正規表現をサポートしている。<br>
<br>
  <syntaxhighlight lang="nginx">
  <syntaxhighlight lang="nginx">
  server {
  server {
43行目: 52行目:
   
   
     server_name example.com;
     server_name example.com;
    # 正規表現で記述する場合
    # 例: server_name *.example.com ~^www\d+\.example\.com$;
  }
  }
  </syntaxhighlight>
  </syntaxhighlight>
49行目: 61行目:
== rootディレクティブ ==
== rootディレクティブ ==
ドキュメントルートを指定する。<br>
ドキュメントルートを指定する。<br>
これは、全てのリクエストに対する相対パスの基準点となる。<br>
<br>
  <syntaxhighlight lang="nginx">
  <syntaxhighlight lang="nginx">
  server {
  server {
58行目: 72行目:
<br><br>
<br><br>


== locationコンテキスト ==
== indexディレクティブ ==
==== 基本的なディレクティブ ====
デフォルトページを指定する。<br>
* root
指定順に検索され、最初に見つかったファイルが使用される。<br>
*: ドキュメントルートの指定
<br>
* alias
これは、locationコンテキストでも設定することができる。<br>
*: 特定のパスへのエイリアス設定
* index
*: インデックスファイルの指定
<br>
<br>
  <syntaxhighlight lang="nginx">
  <syntaxhighlight lang="nginx">
  # 静的ファイルの配信例
  server {
    # ...略
   
   
location / {
     index index.php index.html;
    root  /var/www/html;
     index index.html;
  }
  }
</syntaxhighlight>
<br><br>
== アクセス制御 ==
==== 許可 ====
特定のIPアドレス / 範囲からのアクセスを許可する。<br>
<syntaxhighlight lang="nginx">
allow 10.0.0.0/8;
  </syntaxhighlight>
  </syntaxhighlight>
<br>
<br>
==== アクセス制御 ====
==== 拒否 ====
* allow / deny
特定のIPアドレス / 範囲からのアクセスを禁止する。<br>
*: IPベースのアクセス制限
* auth_basic
*: Basic認証の設定
* auth_request
*: 外部認証の設定
<br>
  <syntaxhighlight lang="nginx">
  <syntaxhighlight lang="nginx">
  # 特定ファイルへのアクセス制限例
  deny 192.168.1.0/24;
# ドキュメントルートの".ht"から始まるファイルはアクセス不可
  </syntaxhighlight>
location ~ /\.ht {
    deny all;
  }
<br>
<br>
==== ファイルアップロード等の制限 ====
クライアントリクエストボディの最大サイズを指定する。<br>
  <syntaxhighlight lang="nginx">
  <syntaxhighlight lang="nginx">
  # BASIC認証の設定例
  client_max_body_size 10M;  # 最大10[MB]に制限する場合
location /admin {
    auth_basic          "Restricted Area";
    auth_basic_user_file /etc/nginx/.htpasswd;
  }
  </syntaxhighlight>
  </syntaxhighlight>
<br><br>
== ログ設定 ==
サーバ固有のログフォーマットを指定する。<br>
serverコンテキストで設定することにより、特定の仮想ホストにのみ異なるログフォーマットを使用することができる。<br>
<br>
<br>
  <syntaxhighlight lang="nginx">
  <syntaxhighlight lang="nginx">
  # ダイジェスト認証の設定例
  # 以下の例では、custom_formatという名前のフォーマットを定義している
  # より安全な認証方式であり、パスワードをハッシュ化して送信する
  # 一般的なアクセスログの形式を定義しており、IPアドレス、時刻、リクエスト内容、ステータスコード、ユーザエージェント等の情報を記録している
server {
    log_format custom_format '$remote_addr - [$time_local] '
                          '"$request" $status $body_bytes_sent '
                          '"$http_referer" "$http_user_agent"';
   
   
location /secure {
    access_log /var/log/nginx/custom_access.log custom_format;
    auth_digest          "Private Area";
    auth_digest_user_file /etc/nginx/htdigest;
    auth_digest_timeout  30s;
    auth_digest_expires  300s;
  }
  }
  </syntaxhighlight>
  </syntaxhighlight>
<br>
<br>
これは、httpコンテキストでも定義することが可能である。<br>
その場合は、NginX全体の設定となる。(serverコンテキストで上書き可能)<br>
  <syntaxhighlight lang="nginx">
  <syntaxhighlight lang="nginx">
  # 外部認証の設定例
  http {
# サーバでユーザ認証を行い、その結果に基づいてアクセスを制御する
    log_format main '$remote_addr - $remote_user [$time_local] "$request" '
                    '$status $body_bytes_sent "$http_referer" '
                    '"$http_user_agent"';
   
   
location /private {
     access_log /var/log/nginx/access.log main;
    auth_request /auth;
    auth_request_set $auth_status $upstream_status;
     location = /auth {
      internal;
      proxy_pass http://auth-server/verify;
      proxy_pass_request_body off;
      proxy_set_header Content-Length "";
    }
  }
  }
  </syntaxhighlight>
  </syntaxhighlight>
<br>
<br>
==== プロキシ関連 ====
==== アクセスログの保存先とフォーマットの指定 ====
* proxy_pass
<syntaxhighlight lang="nginx">
*: リバースプロキシの設定
access_log /var/log/nginx/access.log main;
* proxy_set_header
</syntaxhighlight>
*: プロキシヘッダの設定
* proxy_redirect
*: リダイレクトの制御
<br>
<br>
==== エラーログの保存先とログレベルの指定 ====
  <syntaxhighlight lang="nginx">
  <syntaxhighlight lang="nginx">
  # プロキシ設定例
  error_log /var/log/nginx/error.log warn;
   
  </syntaxhighlight>
location /api {
<br><br>
    proxy_pass      http://backend_server;
 
    proxy_set_header Host $host;
== タイムアウト関連 ==
    proxy_set_header X-Real-IP $remote_addr;
==== client_body_timeoutディレクティブ ====
  }
リクエストボディ受信のタイムアウトを指定する。<br>
これは、クライアントからのデータ受信間隔を制限する。<br>
<syntaxhighlight lang="nginx">
  client_body_timeout 60s;
  </syntaxhighlight>
  </syntaxhighlight>
<br>
<br>
==== ファイル処理 ====
==== client_header_timeoutディレクティブ ====
* try_files
リクエストヘッダ受信のタイムアウトを指定する。<br>
*: ファイル検索順序の指定
これは、ヘッダ受信の制限時間のことである。<br>
* autoindex
<syntaxhighlight lang="nginx">
*: ディレクトリリスティングの制御
client_header_timeout 60s;
* expires
</syntaxhighlight>
*: キャッシュ制御
<br>
<br>
==== keepalive_timeoutディレクティブ ====
Keep-Alive接続のタイムアウトを指定する。<br>
これは、持続的接続の維持時間のことである。<br>
  <syntaxhighlight lang="nginx">
  <syntaxhighlight lang="nginx">
  # キャッシュ制御の例
  keepalive_timeout 75s;
location /static {
    expires    30d;
    add_header Cache-Control "public, no-transform";
}
  </syntaxhighlight>
  </syntaxhighlight>
<br>
<br>
==== FastCGI設定 ====
==== send_timeoutディレクティブ ====
* fastcgi_pass
レスポンス送信のタイムアウトを指定する。<br>
*: FastCGIサーバの指定
これは、クライアントへの送信処理のタイムアウトのことである。<br>
* fastcgi_param
<syntaxhighlight lang="nginx">
*: FastCGIパラメータの設定
send_timeout 60s;
</syntaxhighlight>
<br><br>
 
== バッファ設定 ==
==== client_body_buffer_sizeディレクティブ ====
リクエストボディのバッファサイズを指定する。<br>
<syntaxhighlight lang="nginx">
client_body_buffer_size 128k;
</syntaxhighlight>
<br>
<br>
==== client_header_buffer_sizeディレクティブ ====
リクエストヘッダのバッファサイズを指定する。<br>
  <syntaxhighlight lang="nginx">
  <syntaxhighlight lang="nginx">
  # FastCGIの設定例
  client_header_buffer_size 1k;
# PHPアプリケーションとの連携に必要なバッファ設定やパス情報の処理を含む
location ~ \.php$ {
    fastcgi_pass            unix:/var/run/php/php-fpm.sock;
    fastcgi_split_path_info ^(.+\.php)(/.+)$;
    fastcgi_param          SCRIPT_FILENAME $document_root$fastcgi_script_name;
    fastcgi_param          PATH_INFO $fastcgi_path_info;
    fastcgi_buffers        16 16k;
    fastcgi_buffer_size    32k;
    include                fastcgi_params;
}
  </syntaxhighlight>
  </syntaxhighlight>
<br>
<br>
==== エラー処理 ====
==== large_client_header_buffersディレクティブ ====
様々なHTTPエラーに対してカスタムレスポンスが設定できる。<br>
大きなヘッダ用のバッファを指定する。<br>
<syntaxhighlight lang="nginx">
large_client_header_buffers 4 8k;
</syntaxhighlight>
<br><br>
 
== SSL / TLS設定ディレクティブ ==
==== ssl_certificateディレクティブ ====
SSL証明書ファイルのパスを指定する。<br>
ssl_certificate /path/cert.pem;
<br>
<br>
* error_page
==== ssl_certificate_keyディレクティブ ====
*: エラーページの指定
秘密鍵ファイルのパスを指定する。<br>
* return
<syntaxhighlight lang="nginx">
*: HTTPリターンコードとURLの設定
ssl_certificate_key /path/key.pem;
</syntaxhighlight>
<br>
<br>
==== ssl_protocolsディレクティブ ====
使用するSSL / TLSプロトコルを指定する。<br>
  <syntaxhighlight lang="nginx">
  <syntaxhighlight lang="nginx">
  # エラーページとリターン例
  ssl_protocols TLSv1.2 TLSv1.3;
location /download {
    error_page 404 /404.html;
    error_page 500 502 503 504 /50x.html;
    location = /404.html {
      internal;
      return 404 "File not found.\n";
    }
    location = /50x.html {
      internal;
      return 500 "Server error occurred.\n";
    }
}
  </syntaxhighlight>
  </syntaxhighlight>
<br>
<br>
==== リライト / リダイレクト ====
==== ssl_ciphersディレクティブ ====
* rewrite
暗号化スイートを指定する。<br>
*: URLリライトルールの設定
<syntaxhighlight lang="nginx">
* redirect
ssl_ciphers HIGH:!aNULL:!MD5;
*: リダイレクトの設定
</syntaxhighlight>
<br>
<br>
==== ssl_session_timeoutディレクティブ ====
SSLセッションのタイムアウトを指定する。<br>
  <syntaxhighlight lang="nginx">
  <syntaxhighlight lang="nginx">
  # リライトとリダイレクトの設定例
  ssl_session_timeout 1d;
# URLの書き換えやリダイレクトが設定できる
# 以下の例では、lastフラグで処理を終了して、permanentフラグで301リダイレクトを指定している
location /old-page {
    # 301永続的リダイレクト
    return 301 /new-page;
}
location /blog {
    # URLの書き換え
    rewrite ^/blog/(\d{4})/(\d{2})/(\d{2})/(.*)$ /posts/$1-$2-$3-$4 last;
    # 条件付きリライト
    if ($host ~* ^www\.(.*)) {
      rewrite ^(.*)$ http://$1$1 permanent;
    }
}
  </syntaxhighlight>
  </syntaxhighlight>
<br>
<br>
==== CORS設定 ====
==== ssl_session_cacheディレクティブ ====
* add_header
SSLセッションキャッシュを設定する。<br>
*: クロスオリジン制御用ヘッダの追加
<br>
==== SSI (Server Side Includes) ====
* ssi
*: SSIの有効化 / 無効化
<br>
==== PHP-FPM連携 ====
  <syntaxhighlight lang="nginx">
  <syntaxhighlight lang="nginx">
  # PHP-FPM連携例
  ssl_session_cache shared:SSL:50m;
location ~ \.php$ {
    fastcgi_pass  unix:/var/run/php/php8.3-fpm.sock;
    fastcgi_index index.php;
    fastcgi_param SCRIPT_FILENAME  $realpath_root$fastcgi_script_name;
    include      fastcgi_params;
}
  </syntaxhighlight>
  </syntaxhighlight>
<br>
==== $realpath_root / $document_rootの違い ====
* $realpath_root
*: シンボリックリンクを解決して実際の物理パスを返す。
*: より安全で確実な参照が可能となる。
*: <br>
* $document_root
*: 設定ファイルで指定されたrootディレクティブの値をそのまま使用する。
*: シンボリックリンクが解決されない
<br>
一般的な環境では両者は同じ結果になる。<br>
<br>
<u>しかし、セキュリティを重視する場合は$realpath_rootが推奨される。</u><br>
特に、シンボリックリンクを使用している環境では、この違いが重要になる。<br>
<br>
* fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
* fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
<br>
<br><br>
<br><br>


「http://mochiuwiki.e2.valueserver.jp/index.php?title=NginX-_serverコンテキスト」から取得