コンテナ - Nginxのソースを表示

== 概要 ==
Nginxは、高性能なWebサーバおよびリバースプロキシサーバである。<br>
<br>
Dockerコンテナとして実行することにより、開発環境や本番環境で簡単に導入できる。<br>
静的ファイルの高速配信、リバースプロキシ、ロードバランサー等の様々な用途に適している。<br>
<br>
Nginxコンテナの主な機能を以下に示す。<br>
* HTTPサーバ機能
*: デフォルト : 80番ポート
* HTTPSサーバ機能
*: デフォルト : 443番ポート
* 静的ファイルの高速配信
* リバースプロキシ機能
* ロードバランサー機能
* キャッシュ機能
<br><br>

== Containerfile ==
Containerfileを作成する。<br>
<br>
 <syntaxhighlight lang="dockerfile">
 FROM nginx:latest
 
 COPY ./html/ /usr/share/nginx/html/
 COPY ./nginx.conf /etc/nginx/nginx.conf
 
 EXPOSE 80 443
 
 CMD ["nginx", "-g", "daemon off;"]
 </syntaxhighlight>
<br>
コンテナイメージをビルドする。<br>
 podman build -t nginx:custom -f Containerfile .
<br>
ビルドしたイメージからコンテナを実行する。<br>
 podman run -d                       \
   --name nginx                      \
   -p 0.0.0.0:8080:80                \
   -v ./html:/usr/share/nginx/html/  \
   nginx:custom
<br><br>

== Compose ==
Composeファイルを作成する。<br>
<br>
 <syntaxhighlight lang="yaml">
 version: '3'
 services:
   nginx:
     image: nginx:latest
     container_name: nginx
     ports:
       - "0.0.0.0:8080:80"    # HTTP用（すべてのIPでリッスン）
       - "0.0.0.0:8443:443"   # HTTPS用（すべてのIPでリッスン）
     volumes:
       - ./html:/usr/share/nginx/html/
       - ./nginx-conf:/etc/nginx/conf.d/
     restart: unless-stopped
 
 volumes:
   nginx-data:
 </syntaxhighlight>
<br>
Composeファイルを実行して、コンテナを作成および実行する。<br>
 podman-compose up -d
 # または
 podman-compose -f <Composeファイル名> up -d
<br><br>

== アクセス方法 ==
コンテナが起動した後、以下に示すURLでアクセスできる。<br>
<br>
* HTTP
*: http://localhost:8080
* HTTPS
*: https://localhost:8443
<br>
==== デフォルトページの確認 ====
コンテナ起動後、Webブラウザでアクセスすると Welcome to nginx! というメッセージが表示される。<br>
<br>
==== カスタムHTMLの配置 ====
ホスト側のディレクトリ (例 : ./html) にHTMLファイルを配置することにより、独自のコンテンツを表示できる。<br>
<br>
 mkdir -p html
 
 echo <nowiki>"<h1>Hello from Nginx Container</h1>"</nowiki> > html/index.html
<br><br>

== 設定ファイルのカスタマイズ ==
Nginxの設定ファイルをカスタマイズする場合は、nginx.confやサイト設定ファイルをホスト側に配置する。<br>
<br>
==== 設定ファイルのコピー ====
実行中のコンテナから設定ファイルをコピーする。<br>
 podman cp nginx:/etc/nginx/nginx.conf ./nginx-conf/nginx.conf
<br>
==== サイト設定の追加 ====
カスタム設定ファイルを作成する例を以下に示す。<br>
<br>
 <syntaxhighlight lang="nginx">
 server {
    listen 80;
    server_name localhost;
 
    location / {
       root /usr/share/nginx/html;
       index index.html index.htm;
    }
 
    error_page 404 /404.html;
    location = /404.html {
       internal;
    }
 }
 </syntaxhighlight>
<br>
==== 設定の反映 ====
設定ファイルを編集後、コンテナを再起動する。<br>
 podman restart nginx
<br>
または、設定の構文チェックとリロードを行う。<br>
 podman exec nginx nginx -t
 podman exec nginx nginx -s reload
<br><br>

== 仮想ホストの設定 ==
複数のサイトを1つのNginxコンテナで運用する場合、server ブロックを複数定義する。<br>
<br>
==== 仮想ホスト設定ファイルの作成 ====
各サイト用の設定ファイルを作成する。<br>
<br>
* site1.confファイル
 <syntaxhighlight lang="nginx">
 server {
    listen 80;
    server_name example.com www.example.com;
    root /usr/share/nginx/html/example.com;
    index index.html index.htm;
 
    access_log /var/log/nginx/example.com-access.log;
    error_log /var/log/nginx/example.com-error.log;
 
    location / {
       try_files $uri $uri/ =404;
    }
 
    location ~* \.(jpg|jpeg|png|gif|ico|css|js)$ {
       expires 1y;
       add_header Cache-Control "public, immutable";
    }
 }
 </syntaxhighlight>
<br>
* site2.confファイル
 <syntaxhighlight lang="nginx">
 server {
    listen 80;
    server_name test.local;
    root /usr/share/nginx/html/test.local;
    index index.html index.htm;
 
    access_log /var/log/nginx/test.local-access.log;
    error_log /var/log/nginx/test.local-error.log;
 
    location / {
       try_files $uri $uri/ =404;
    }
 }
 </syntaxhighlight>
<br>
==== Composeファイルでの設定例 ====
仮想ホストを使用する場合のCompose設定を以下に示す。<br>
<br>
 <syntaxhighlight lang="yaml">
 version: '3'
 services:
   nginx:
     image: nginx:latest
     container_name: nginx
     ports:
       - "0.0.0.0:8080:80"
     volumes:
       - ./sites/example.com:/usr/share/nginx/html/example.com
       - ./sites/test.local:/usr/share/nginx/html/test.local
       - ./conf.d:/etc/nginx/conf.d
       - nginx-logs:/var/log/nginx
     restart: unless-stopped
 
 volumes:
   nginx-logs:
 </syntaxhighlight>
<br><br>

== SSL / TLS設定 ==
HTTPS通信を有効化するための設定を行う。<br>
<br>
==== SSL証明書の準備 ====
自己署名証明書を作成する例を以下に示す。<br>
<br>
 mkdir -p ./ssl
 openssl req -x509 -nodes -days 365 -newkey rsa:2048 \
   -keyout ./ssl/server.key \
   -out ./ssl/server.crt \
   -subj "/C=JP/ST=Tokyo/L=Tokyo/O=MyCompany/CN=localhost"
<br>
==== SSL設定ファイルの作成 ====
HTTPS用のserver設定を作成する。<br>
<br>
 <syntaxhighlight lang="nginx">
 server {
    listen 443 ssl http2;
    server_name localhost;
    root /usr/share/nginx/html;
    index index.html index.htm;
 
    ssl_certificate /etc/nginx/ssl/server.crt;
    ssl_certificate_key /etc/nginx/ssl/server.key;
 
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers HIGH:!aNULL:!MD5;
    ssl_prefer_server_ciphers on;
 
    ssl_session_cache shared:SSL:10m;
    ssl_session_timeout 10m;
 
    access_log /var/log/nginx/ssl-access.log;
    error_log /var/log/nginx/ssl-error.log;
 
    location / {
       try_files $uri $uri/ =404;
    }
 }
 
 server {
    listen 80;
    server_name localhost;
    return 301 https://$server_name$request_uri;
 }
 </syntaxhighlight>
<br>
==== SSL有効化のCompose設定 ====
 <syntaxhighlight lang="yaml">
 version: '3'
 services:
   nginx:
     image: nginx:latest
     container_name: nginx
     ports:
       - "0.0.0.0:8080:80"
       - "0.0.0.0:8443:443"
     volumes:
       - ./html:/usr/share/nginx/html
       - ./ssl:/etc/nginx/ssl
       - ./conf.d:/etc/nginx/conf.d
     restart: unless-stopped
 </syntaxhighlight>
<br>
==== Let's Encryptの使用 ====
本番環境で無料SSL証明書を使用する場合の設定例を示す。<br>
<br>
 <syntaxhighlight lang="yaml">
 version: '3'
 services:
   nginx:
     image: nginx:latest
     container_name: nginx
     ports:
       - "0.0.0.0:80:80"
       - "0.0.0.0:443:443"
     volumes:
       - ./html:/usr/share/nginx/html
       - ./conf.d:/etc/nginx/conf.d
       - certbot-etc:/etc/letsencrypt
       - certbot-var:/var/lib/letsencrypt
     restart: unless-stopped
 
   certbot:
     image: certbot/certbot
     container_name: certbot
     volumes:
       - certbot-etc:/etc/letsencrypt
       - certbot-var:/var/lib/letsencrypt
       - ./html:/usr/share/nginx/html
     command: certonly --webroot --webroot-path=/usr/share/nginx/html --email admin@example.com --agree-tos --no-eff-email -d example.com -d www.example.com
 
 volumes:
   certbot-etc:
   certbot-var:
 </syntaxhighlight>
<br><br>

== リバースプロキシの設定 ==
Nginxをリバースプロキシとして使用する詳細な設定例を以下に示す。<br>
<br>
==== 基本的なリバースプロキシ設定 ====
 <syntaxhighlight lang="nginx">
 server {
    listen 80;
    server_name proxy.example.com;
 
    location / {
       proxy_pass http://backend:8000;
       proxy_set_header Host $host;
       proxy_set_header X-Real-IP $remote_addr;
       proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
       proxy_set_header X-Forwarded-Proto $scheme;
 
       proxy_buffering on;
       proxy_buffer_size 4k;
       proxy_buffers 8 4k;
       proxy_busy_buffers_size 8k;
    }
 }
 </syntaxhighlight>
<br>
==== WebSocketプロキシの設定 ====
WebSocketアプリケーション用のプロキシ設定を以下に示す。<br>
<br>
 <syntaxhighlight lang="nginx">
 server {
    listen 80;
    server_name ws.example.com;
 
    location / {
       proxy_pass http://websocket-backend:8080;
       proxy_http_version 1.1;
       proxy_set_header Upgrade $http_upgrade;
       proxy_set_header Connection "upgrade";
       proxy_set_header Host $host;
       proxy_set_header X-Real-IP $remote_addr;
       proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
 
       proxy_read_timeout 86400;
    }
 }
 </syntaxhighlight>
<br>
==== パスベースルーティング ====
異なるパスを異なるバックエンドにルーティングする設定を以下に示す。<br>
<br>
 <syntaxhighlight lang="nginx">
 server {
    listen 80;
    server_name app.example.com;
 
    location /api/ {
       proxy_pass http://api-backend:3000/;
       proxy_set_header Host $host;
       proxy_set_header X-Real-IP $remote_addr;
    }
 
    location /admin/ {
       proxy_pass http://admin-backend:4000/;
       proxy_set_header Host $host;
       proxy_set_header X-Real-IP $remote_addr;
    }
 
    location / {
       proxy_pass http://frontend:5000;
       proxy_set_header Host $host;
       proxy_set_header X-Real-IP $remote_addr;
    }
 }
 </syntaxhighlight>
<br><br>

== ロードバランサーの設定 ==
複数のバックエンドサーバに負荷分散する設定を以下に示す。<br>
<br>
==== ラウンドロビン方式 ====
デフォルトの負荷分散方式 (ラウンドロビン) の設定を以下に示す。<br>
<br>
 <syntaxhighlight lang="nginx">
 upstream backend_servers {
    server backend1:8000;
    server backend2:8000;
    server backend3:8000;
 }
 
 server {
    listen 80;
    server_name lb.example.com;
 
    location / {
       proxy_pass http://backend_servers;
       proxy_set_header Host $host;
       proxy_set_header X-Real-IP $remote_addr;
       proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
 }
 </syntaxhighlight>
<br>
==== 重み付きロードバランシング ====
サーバごとに重みを設定する例を以下に示す。<br>
<br>
 <syntaxhighlight lang="nginx">
 upstream backend_servers {
    server backend1:8000 weight=3;
    server backend2:8000 weight=2;
    server backend3:8000 weight=1;
 }
 
 server {
    listen 80;
    server_name lb.example.com;
 
    location / {
       proxy_pass http://backend_servers;
       proxy_set_header Host $host;
    }
 }
 </syntaxhighlight>
<br>
==== IPハッシュ方式 ====
クライアントIPに基づいて同じサーバに振り分ける設定を以下に示す。<br>
<br>
 <syntaxhighlight lang="nginx">
 upstream backend_servers {
    ip_hash;
    server backend1:8000;
    server backend2:8000;
    server backend3:8000;
 }
 
 server {
    listen 80;
    server_name lb.example.com;
 
    location / {
       proxy_pass http://backend_servers;
       proxy_set_header Host $host;
    }
 }
 </syntaxhighlight>
<br>
==== ヘルスチェックの設定 ====
バックエンドサーバの状態を監視する設定を以下に示す。<br>
<br>
 <syntaxhighlight lang="nginx">
 upstream backend_servers {
    server backend1:8000 max_fails=3 fail_timeout=30s;
    server backend2:8000 max_fails=3 fail_timeout=30s;
    server backend3:8000 backup;
 }
 
 server {
    listen 80;
    server_name lb.example.com;
 
    location / {
       proxy_pass http://backend_servers;
       proxy_next_upstream error timeout http_500 http_502 http_503;
       proxy_connect_timeout 5s;
       proxy_read_timeout 10s;
    }
 }
 </syntaxhighlight>
<br><br>

== PHP-FPMとの連携 ==
NginxコンテナでPHPアプリケーションを動作させる場合、PHP-FPMと連携する設定例を示す。<br>
<br>
==== Composeファイルでの連携設定 ====
 <syntaxhighlight lang="yaml">
 version: '3'
 services:
   nginx:
     image: nginx:latest
     container_name: nginx
     ports:
       - "0.0.0.0:8080:80"
     volumes:
       - ./html:/usr/share/nginx/html
       - ./conf.d:/etc/nginx/conf.d
     depends_on:
       - php-fpm
     restart: unless-stopped
 
   php-fpm:
     image: php:8.2-fpm
     container_name: php-fpm
     volumes:
       - ./html:/usr/share/nginx/html
     restart: unless-stopped
 </syntaxhighlight>
<br>
==== Nginx側のPHP設定 ====
PHP-FPMと連携するため、serverセクションの設定を以下に示す。<br>
<br>
 <syntaxhighlight lang="nginx">
 server {
    listen 80;
    server_name localhost;
    root /usr/share/nginx/html;
    index index.php index.html index.htm;
 
    location / {
       try_files $uri $uri/ /index.php?$query_string;
    }
 
    location ~ \.php$ {
       fastcgi_pass php-fpm:9000;
       fastcgi_index index.php;
       fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
       include fastcgi_params;
 
       fastcgi_buffer_size 128k;
       fastcgi_buffers 4 256k;
       fastcgi_busy_buffers_size 256k;
    }
 
    location ~ /\.ht {
       deny all;
    }
 }
 </syntaxhighlight>
<br>
==== WordPressの設定例 ====
WordPressを運用する場合の最適化された設定を以下に示す。<br>
<br>
 <syntaxhighlight lang="nginx">
 server {
    listen 80;
    server_name wordpress.example.com;
    root /usr/share/nginx/html;
    index index.php;
 
    client_max_body_size 100M;
 
    location / {
       try_files $uri $uri/ /index.php?$args;
    }
 
    location ~ \.php$ {
       try_files $uri =404;
       fastcgi_split_path_info ^(.+\.php)(/.+)$;
       fastcgi_pass php-fpm:9000;
       fastcgi_index index.php;
       include fastcgi_params;
       fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
       fastcgi_param PATH_INFO $fastcgi_path_info;
    }
 
    location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg)$ {
       expires 1y;
       log_not_found off;
    }
 
    location = /favicon.ico {
       log_not_found off;
       access_log off;
    }
 
    location = /robots.txt {
       log_not_found off;
       access_log off;
    }
 
    location ~ /\.ht {
       deny all;
    }
 }
 </syntaxhighlight>
<br><br>

== キャッシュの設定 ==
Nginxのキャッシュ機能を使用してパフォーマンスを向上させる設定を示す。<br>
<br>
==== プロキシキャッシュの設定 ====
リバースプロキシでのキャッシュ設定を以下に示す。<br>
<br>
* nginx.confに追加する設定
 <syntaxhighlight lang="nginx">
 http {
    proxy_cache_path /var/cache/nginx levels=1:2 keys_zone=my_cache:10m max_size=1g inactive=60m use_temp_path=off;
 
    server {
       listen 80;
       server_name cache.example.com;
 
       location / {
          proxy_cache my_cache;
          proxy_cache_valid 200 302 10m;
          proxy_cache_valid 404 1m;
          proxy_cache_use_stale error timeout updating http_500 http_502 http_503 http_504;
          proxy_cache_lock on;
 
          add_header X-Cache-Status $upstream_cache_status;
 
          proxy_pass http://backend:8000;
          proxy_set_header Host $host;
       }
    }
 }
 </syntaxhighlight>
<br>
==== FastCGIキャッシュの設定 ====
PHP-FPM用のキャッシュ設定を以下に示す。<br>
<br>
 <syntaxhighlight lang="nginx">
 http {
    fastcgi_cache_path /var/cache/nginx/fastcgi levels=1:2 keys_zone=php_cache:10m max_size=1g inactive=60m use_temp_path=off;
 
    server {
       listen 80;
       server_name php-cache.example.com;
       root /usr/share/nginx/html;
       index index.php;
 
       set $skip_cache 0;
 
       if ($request_method = POST) {
          set $skip_cache 1;
       }
 
       if ($query_string != "") {
          set $skip_cache 1;
       }
 
       location ~ \.php$ {
          fastcgi_cache php_cache;
          fastcgi_cache_valid 200 60m;
          fastcgi_cache_bypass $skip_cache;
          fastcgi_no_cache $skip_cache;
 
          add_header X-FastCGI-Cache $upstream_cache_status;
 
          fastcgi_pass php-fpm:9000;
          include fastcgi_params;
          fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
       }
    }
 }
 </syntaxhighlight>
<br>
==== 静的ファイルのキャッシュ設定 ====
ブラウザキャッシュを最適化する設定を以下に示す。<br>
<br>
<syntaxhighlight lang="nginx">
location ~* \.(jpg|jpeg|png|gif|ico|svg)$ {
    expires 1y;
    add_header Cache-Control "public, immutable";
}

location ~* \.(css|js)$ {
    expires 1M;
    add_header Cache-Control "public";
}

location ~* \.(woff|woff2|ttf|eot)$ {
    expires 1y;
    add_header Cache-Control "public, immutable";
}
</syntaxhighlight>
<br><br>

== 圧縮の設定 ==
Gzip圧縮を有効化してデータ転送量を削減する設定を示す。<br>
<br>
==== Gzip圧縮の基本設定 ====
nginx.confファイル、または、サイト設定ファイルに以下を追加する。<br>
<br>
 <syntaxhighlight lang="nginx">
 http {
    gzip on;
    gzip_vary on;
    gzip_proxied any;
    gzip_comp_level 6;
    gzip_types text/plain text/css text/xml text/javascript application/json application/javascript application/xml+rss application/rss+xml font/truetype font/opentype application/vnd.ms-fontobject image/svg+xml;
    gzip_disable "msie6";
    gzip_min_length 256;
 }
 </syntaxhighlight>
<br>
==== Brotli圧縮の設定 ====
高効率なBrotli圧縮を使用することができる。<br>
<br>
 <syntaxhighlight lang="nginx">
 http {
    brotli on;
    brotli_comp_level 6;
    brotli_types text/plain text/css application/json application/javascript application/x-javascript text/xml application/xml application/xml+rss text/javascript;
 }
 </syntaxhighlight>
<br><br>

== レート制限の設定 ==
DDoS攻撃やブルートフォース攻撃を防ぐためのレート制限設定を示す。<br>
<br>
==== リクエストレート制限 ====
 <syntaxhighlight lang="nginx">
 http {
    limit_req_zone $binary_remote_addr zone=mylimit:10m rate=10r/s;
 
    server {
       listen 80;
       server_name ratelimit.example.com;
 
       location / {
          limit_req zone=mylimit burst=20 nodelay;
          proxy_pass http://backend:8000;
       }
 
       location /api/ {
          limit_req zone=mylimit burst=5 nodelay;
          proxy_pass http://api-backend:3000/;
       }
    }
 }
 </syntaxhighlight>
<br>
==== 接続数制限 ====
 <syntaxhighlight lang="nginx">
 http {
    limit_conn_zone $binary_remote_addr zone=addr:10m;
 
    server {
       listen 80;
       server_name connlimit.example.com;
 
       location /download/ {
          limit_conn addr 1;
          limit_rate 500k;
          root /usr/share/nginx/html;
       }
    }
 }
 </syntaxhighlight>
<br><br>

== ログの管理 ==
Nginxのアクセスログとエラーログを管理する方法を示す。<br>
<br>
==== ログの確認 ====
コンテナ内のログをリアルタイムで確認する。<br>
<br>
 # アクセスログ
 podman exec nginx tail -f /var/log/nginx/access.log
 
 # エラーログ
 podman exec nginx tail -f /var/log/nginx/error.log
<br>
または、podman logsコマンドでコンテナログを確認する。<br>
 podman logs -f nginx
<br>
==== カスタムログフォーマット ====
詳細なログフォーマットを定義する例を以下に示す。<br>
<br>
 <syntaxhighlight lang="nginx">
 http {
    log_format main '$remote_addr - $remote_user [$time_local] "$request" '
                    '$status $body_bytes_sent "$http_referer" '
                    '"$http_user_agent" "$http_x_forwarded_for"';
 
    log_format detailed '$remote_addr - $remote_user [$time_local] "$request" '
                        '$status $body_bytes_sent "$http_referer" '
                        '"$http_user_agent" rt=$request_time '
                        'uct="$upstream_connect_time" uht="$upstream_header_time" urt="$upstream_response_time"';
 
    access_log /var/log/nginx/access.log detailed;
 }
 </syntaxhighlight>
<br>
==== ログのローテーション ====
ログファイルをホスト側で管理する場合の設定を以下に示す。<br>
<br>
 <syntaxhighlight lang="yaml">
 version: '3'
 services:
   nginx:
     image: nginx:latest
     container_name: nginx
     ports:
       - "0.0.0.0:8080:80"
     volumes:
       - ./html:/usr/share/nginx/html
       - ./logs:/var/log/nginx
     restart: unless-stopped
 </syntaxhighlight>
<br>
logrotateを使用したログローテーション設定を作成する。<br>
<br>
* /etc/logrotate.d/nginx ファイルの例
*: <syntaxhighlight lang="text">
 /path/to/logs/*.log {
    daily
    rotate 14
    compress
    delaycompress
    notifempty
    create 0640 nginx nginx
    sharedscripts
    postrotate
       podman exec nginx nginx -s reopen
    endscript
 }
 </syntaxhighlight>
<br>
==== 条件付きロギング ====
特定の条件でログを記録しないように設定する例を以下に示す。<br>
<br>
 <syntaxhighlight lang="nginx">
 map $request_uri $loggable {
    ~^/health$ 0;
    ~^/metrics$ 0;
    default 1;
 }
 
 server {
    listen 80;
    access_log /var/log/nginx/access.log combined if=$loggable;
 
    location /health {
       return 200 "OK\n";
       add_header Content-Type text/plain;
    }
 }
 </syntaxhighlight>
<br><br>

== パフォーマンスチューニング ==
Nginxのパフォーマンスを最適化するための設定を示す。<br>
<br>
==== ワーカープロセスの最適化 ====
nginx.confファイルにおいて、以下に示す設定を行う。<br>
<br>
 <syntaxhighlight lang="nginx">
 worker_processes auto;
 worker_rlimit_nofile 65535;
 
 events {
    worker_connections 4096;
    use epoll;
    multi_accept on;
 }
 
 http {
    sendfile on;
    tcp_nopush on;
    tcp_nodelay on;
    keepalive_timeout 65;
    keepalive_requests 100;
    reset_timedout_connection on;
    client_body_timeout 10;
    send_timeout 10;
 }
 </syntaxhighlight>
<br>
==== バッファサイズの最適化 ====
 <syntaxhighlight lang="nginx">
 http {
    client_body_buffer_size 128k;
    client_max_body_size 10m;
    client_header_buffer_size 1k;
    large_client_header_buffers 4 8k;
    output_buffers 1 32k;
    postpone_output 1460;
 }
 </syntaxhighlight>
<br>
==== ファイルディスクリプタキャッシュ ====
 <syntaxhighlight lang="nginx">
 http {
    open_file_cache max=200000 inactive=20s;
    open_file_cache_valid 30s;
    open_file_cache_min_uses 2;
    open_file_cache_errors on;
 }
 </syntaxhighlight>
<br><br>

== セキュリティ設定 ==
Nginxのセキュリティを強化するための設定を示す。<br>
<br>
==== サーバ情報の非表示 ====
レスポンスヘッダからNginxのバージョン情報を削除する。<br>
<br>
 <syntaxhighlight lang="nginx">
 http {
    server_tokens off;
 }
 </syntaxhighlight>
<br>
==== セキュリティヘッダの追加 ====
セキュリティ関連のHTTPヘッダを追加する。<br>
<br>
 <syntaxhighlight lang="nginx">
 server {
    listen 80;
    server_name secure.example.com;
 
    add_header X-Frame-Options "SAMEORIGIN" always;
    add_header X-Content-Type-Options "nosniff" always;
    add_header X-XSS-Protection "1; mode=block" always;
    add_header Referrer-Policy "no-referrer-when-downgrade" always;
    add_header Content-Security-Policy "default-src 'self' http: https: data: blob: 'unsafe-inline'" always;
    add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
 }
 </syntaxhighlight>
<br>
==== Basic認証の設定 ====
特定のディレクトリにBasic認証を設定する。<br>
<br>
パスワードファイルを作成する。<br>
 podman exec -it nginx sh
 
 apk add apache2-utils
 
 htpasswd -c /etc/nginx/.htpasswd <ユーザ名>
<br>
Nginx設定ファイルに認証を追加する。<br>
<br>
 <syntaxhighlight lang="nginx">
 location /admin {
    auth_basic "Restricted Area";
    auth_basic_user_file /etc/nginx/.htpasswd;
    proxy_pass http://admin-backend:4000;
 }
 </syntaxhighlight>
<br>
==== IPアドレスによるアクセス制限 ====
特定のIPアドレスからのみアクセスを許可する設定を以下に示す。<br>
<br>
 <syntaxhighlight lang="nginx">
 location /admin {
    allow 192.168.1.0/24;
    allow 10.0.0.0/8;
    deny all;
 
    proxy_pass http://admin-backend:4000;
 }
 </syntaxhighlight>
<br>
==== 機密ファイルへのアクセス制限 ====
特定のファイルやディレクトリへのアクセスを制限する。<br>
<br>
 <syntaxhighlight lang="nginx">
 location ~ /\.(?!well-known) {
    deny all;
 }
 
 location ~* \.(bak|config|sql|fla|psd|ini|log|sh|inc|swp|dist)$ {
    deny all;
 }
 </syntaxhighlight>
<br><br>

== トラブルシューティング ==
==== コンテナが起動しない ====
設定ファイルの構文エラーを確認する。<br>
<br>
 podman logs nginx
 podman exec nginx nginx -t
<br>
==== ポート番号の競合 ====
他のサービスとポート番号が競合している場合、別のポートを使用する。<br>
<br>
 podman run -d --name nginx -p 0.0.0.0:8081:80 nginx:latest
<br>
==== 502 Bad Gateway エラー ====
プロキシ設定でバックエンドサーバへの接続を確認する。<br>
<br>
 # バックエンドサーバの稼働確認
 podman exec nginx curl http://backend:8000
 
 # Nginxのエラーログを確認
 podman exec nginx tail -f /var/log/nginx/error.log
<br>
==== 413 Request Entity Too Large エラー ====
アップロードファイルサイズの上限を増やす。<br>
<br>
 <syntaxhighlight lang="nginx">
 http {
    client_max_body_size 100M;
 }
 </syntaxhighlight>
<br>
==== パーミッションエラー ====
ボリュームマウントしたディレクトリのパーミッションを確認する。<br>
<br>
 chmod -R 755 ./html
 chown -R 101:101 ./html
<br>
==== タイムアウトエラー ====
プロキシタイムアウト設定を調整する。<br>
<br>
 <syntaxhighlight lang="nginx">
 location / {
    proxy_pass http://backend:8000;
    proxy_connect_timeout 60s;
    proxy_send_timeout 60s;
    proxy_read_timeout 60s;
 }
 </syntaxhighlight>
<br><br>

== ファイヤーウォールの設定 ==
同一ネットワーク上の外部PCからアクセスする場合は、ファイヤーウォールのポート開放を行う。<br>
<br>
==== Linux ====
 # Firewalldを使用している場合
 sudo firewall-cmd --permanent --add-port=8080/tcp
 sudo firewall-cmd --permanent --add-port=8443/tcp
 sudo firewall-cmd --reload
 
 # UFWを使用している場合
 sudo ufw allow 8080/tcp
 sudo ufw allow 8443/tcp
<br>
==== Windows 11 ====
PowerShellを管理者権限で起動して、以下に示すコマンドを実行する。<br>
<br>
HTTPポートの受信ルールを追加する。<br>
 New-NetFirewallRule -DisplayName "Nginx HTTP" -Direction Inbound -Protocol TCP -LocalPort <ポート番号  例: 8080> -Action Allow
<br>
HTTPSポートの受信ルールを追加する。<br>
 New-NetFirewallRule -DisplayName "Nginx HTTPS" -Direction Inbound -Protocol TCP -LocalPort <ポート番号  例: 8443> -Action Allow
<br>
正常にポート開放が行われているかどうかを確認する場合、別PCからPowerShellを起動して、以下のコマンドを実行する。<br>
 Test-NetConnection -ComputerName <Windows PCのIPアドレス> -Port <ポート番号  例: 8080>
 Test-NetConnection -ComputerName <Windows PCのIPアドレス> -Port <ポート番号  例: 8443>
<br>
ファイアウォールルールを削除する場合は、以下に示すコマンドを実行する。<br>
 # HTTPポートのルール削除
 Remove-NetFirewallRule -DisplayName "Nginx HTTP" -ErrorAction SilentlyContinue
 
 # HTTPSポートのルール削除
 Remove-NetFirewallRule -DisplayName "Nginx HTTPS" -ErrorAction SilentlyContinue
<br>
==== Windows 10 ====
PowerShellを管理者権限で起動して、以下に示すコマンドを実行する。<br>
<br>
HTTPポートの受信ルールを追加する。<br>
 New-NetFirewallRule -DisplayName "Nginx HTTP" -Direction Inbound -Protocol TCP -LocalPort <ポート番号  例: 8080> -Action Allow
<br>
HTTPSポートの受信ルールを追加する。<br>
 New-NetFirewallRule -DisplayName "Nginx HTTPS" -Direction Inbound -Protocol TCP -LocalPort <ポート番号  例: 8443> -Action Allow
<br>
正常にポート開放が行われているかどうかを確認する場合、別PCからPowerShellを起動して、以下のコマンドを実行する。<br>
 Test-NetConnection -ComputerName <Windows PCのIPアドレス> -Port <ポート番号  例: 8080>
 Test-NetConnection -ComputerName <Windows PCのIPアドレス> -Port <ポート番号  例: 8443>
<br>
ファイアウォールルールを削除する場合は、以下に示すコマンドを実行する。<br>
 # HTTPポートのルール削除
 Remove-NetFirewallRule -DisplayName "Nginx HTTP" -ErrorAction SilentlyContinue
 
 # HTTPSポートのルール削除
 Remove-NetFirewallRule -DisplayName "Nginx HTTPS" -ErrorAction SilentlyContinue
<br><br>


__FORCETOC__
[[カテゴリ:コンテナ]]