nginx 設定生成ツール

シンプルなトグルから完全なnginxのサーバーブロックを、ブラウザー内でリアルタイムに作成します。入力はお使いのデバイスに留まります。

あなたのドメイン・パス・証明書の場所は、設定を作成するためにブラウザー内でのみ使われ、アップロードされることはありません。それでも、実際の秘密鍵の内容をどのツールにも貼り付けないようにしてください。

開発・運営:Udit Agarwal

ウェブルートのファイル権限が必要ですか?chmod計算ツールをお試しください。

nginx 設定生成ツール について

このnginx設定生成ツールは、いくつかの入力とトグルを、sites-availableにそのまま置ける完全で有効なnginxのサーバーブロックに変換します。静的サイト(root + index に try_files)か、リバースプロキシ(標準の Host・X-Real-IP・X-Forwarded-For・X-Forwarded-Proto ヘッダーを備えた proxy_pass、加えて任意のWebSocketアップグレード行)を選べます。SSLをオンにすると443でリッスンし、ssl_certificate と ssl_certificate_key を設定し、HTTPをHTTPSへ301でリダイレクトする2つ目のサーバーブロックを出力します。gzip、長期間の静的アセットキャッシュ、client_max_body_size の上限、www→非wwwの正規化リダイレクトを、それぞれワンクリックで追加できます。nginx設定生成ツールとして、波括弧のバランスとインデントをきれいに保ち、結果をコピーするか <domain>.conf としてダウンロードできます。すべてはブラウザー内で動作するため、ドメインとパスはお使いのデバイスに留まります。

機能

  • root・index・try_files のlocationブロックを備えた静的サイトモード
  • proxy_pass と標準の proxy_set_header 行を備えたリバースプロキシモード
  • proxy_http_version・Upgrade・Connection ヘッダーによる任意のWebSocketサポート
  • listen 443 ssl とHTTP→HTTPSの301リダイレクトサーバーを追加するSSLトグル
  • text・JSON・JavaScript・CSS・XML・SVG 向けに調整されたgzipブロック
  • expires と immutable な Cache-Control を備えた静的アセットキャッシュのlocation
  • client_max_body_size の入力と、www↔非wwwの正規化リダイレクト
  • サーバーブロックをコピー、または example.com.conf としてダウンロード

nginx 設定生成ツール の使い方

  1. ドメインとリッスンポートを入力し、静的サイトかリバースプロキシかを選びます。
  2. rootとindex、またはアプリ向けの proxy_pass のアップストリームを入力します。
  3. 必要に応じてSSL・gzip・キャッシュ・ボディサイズ・wwwリダイレクトを切り替えます。
  4. 右側でリアルタイムのnginx設定を読み、.conf を「コピー」または「ダウンロード」します。

例

入力

Domain: example.com
Mode: Reverse proxy
Upstream: http://127.0.0.1:3000
SSL: on

出力

server {
    listen 443 ssl;
    listen [::]:443 ssl;
    server_name example.com www.example.com;

    ssl_certificate /etc/ssl/certs/example.com.crt;
    ssl_certificate_key /etc/ssl/private/example.com.key;

    location / {
        proxy_pass http://127.0.0.1:3000;
        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;
    }
}

server {
    listen 80;
    listen [::]:80;
    server_name example.com www.example.com;

    return 301 https://$host$request_uri;
}

443のリバースプロキシと、対応するHTTP→HTTPSのリダイレクトブロックです。

よくあるエラーとトラブルシューティング

  • nginx -t が「cannot load certificate」を報告する、またはSSLブロックが起動に失敗する。 — ssl_certificate をfullchainファイルに、ssl_certificate_key を対応する秘密鍵に向け、両方のパスが存在しnginxから読めることを確認してください。
  • リバースプロキシ先のアプリが誤ったクライアントIPを表示する、またはHTTPS背後で壊れる。 — 生成された proxy_set_header 行を残し、Host・X-Real-IP・X-Forwarded-For・X-Forwarded-Proto がアップストリームに届くようにし、アプリ側で正しいヘッダーから読んでください。
  • WebSocket接続が400で切れる、またはアップグレードに失敗する。 — WebSocketサポートをオンにして、locationに proxy_http_version 1.1 と、nginxがws/wssをプロキシするのに必要な Upgrade・Connection "upgrade" ヘッダーを追加してください。
  • 大きなアップロードが413 Request Entity Too Largeを返す。 — client_max_body_size を最大のアップロードより大きな値(例:20Mや100M)に設定し、nginxをリロードしてください。

よくある質問

nginxでリバースプロキシを設定するには?
「リバースプロキシ」を選び、proxy_pass にアップストリーム(例:http://127.0.0.1:3000)を入力すると、生成ツールが標準の Host・X-Real-IP・X-Forwarded-For・X-Forwarded-Proto ヘッダーを備えた location / ブロックを追加します。アプリがws/wssを使う場合はWebSocketサポートを有効にしてください。
nginxのサーバーブロックはどこに置きますか?
DebianやUbuntuでは、生成したファイルを /etc/nginx/sites-available/example.com として保存し、sites-enabled にシンボリックリンクします。他の多くのディストリビューションでは /etc/nginx/conf.d/example.com.conf に置き、nginx -t を実行してリロードします。
SSLトグルは設定をどう変えますか?
メインのサーバーを 443 ssl でリッスンするように切り替え、ssl_certificate と ssl_certificate_key を追加し、ポート80上にすべてのリクエストを https:// へ301でリダイレクトする2つ目のサーバーブロックを出力するため、訪問者は常に安全なサイトに到達します。
ここでの静的サイトとリバースプロキシの違いは何ですか?
静的モードは index と try_files の location を使い root ディレクトリからファイルを配信し、HTML・SPA・ビルド済みアセットに最適です。リバースプロキシモードはファイルを配信する代わりに、proxy_pass とプロキシヘッダーでリクエストをアップストリームのアプリサーバーへ転送します。
gzipと静的アセットのキャッシュを追加できますか?
はい。gzipトグルは text・JSON・JavaScript・CSS・XML・SVG 向けに調整されたgzipブロックを追加し、キャッシュトグルは一般的なアセット拡張子に対し30日の expires と immutable な Cache-Control ヘッダーを設定する location を追加します。
私のドメインや設定はどこかに送信されますか?
いいえ。このnginx設定生成ツールは完全にブラウザー内で動作するため、入力したドメイン・パス・証明書の場所はお使いのデバイス上で処理され、生成されたファイルがアップロードされることはありません。

関連ツール

Web & DevOpsの他のツール

Web & DevOpsのツールをすべて見る (27) · すべてのツール