【Nginx】リバースプロキシの設定方法!proxy_pass徹底解説

【Nginx】リバースプロキシの設定方法!proxy_pass徹底解説

PR Amazonのアソシエイトとして、ITナレッジライフは適格販売により収入を得ています。

記事の文字数:6,518

Nginxでリバースプロキシを設定する方法を初心者向けにわかりやすく解説!proxy_passディレクティブの基本構文や末尾スラッシュの有無による挙動の違い、proxy_set_headerによるヘッダー転送、WebSocket対応や502エラー対策まで実例付きで紹介します。

Ubuntuユーザにお勧めの本 ↗

Ubuntuサーバー徹底入門

難易度
実用性
網羅性

設定の勘所が詳しく解説されている。Ubuntu運用の強い味方になってくれる一冊です。

ゼロからわかるLinuxサーバー超入門 Ubuntu対応版 かんたんIT基礎講座

難易度
実用性
読みやすさ

非常に丁寧に手順が示されている。独学で初めてサーバーを立てるならこの本が最適です。

Node.js(Express / Next.jsNext.js [ネクストジェーエス]React製のフルスタックWebフレームワーク)や PythonPython [パイソン]汎用プログラミング言語(FastAPI / DjangoDjango [ジャンゴ]Python製のWebフレームワーク。Dは発音しない)、GoGo [ゴー]Google開発のシンプルで高速な言語、あるいは DockerDocker [ドッカー]コンテナ型仮想化プラットフォーム コンテナで Web アプリケーションを構築した際、「外部からは標準の 80 番・443 番ポートでアクセスを受け付け、内部の 3000 番や 8080 番ポートへ転送したい」という場面は数多くあります。

そこで活躍するのが、Web サーバー NginxNginx [エンジンエックス]高性能なWebサーバー・リバースプロキシ(エンジンエックス)のリバースプロキシ機能 です。Nginx をフロント段に配置してリクエストを中継させることで、ポート番号の隠蔽や SSLSSL [エスエスエル]Secure Sockets Layer。インターネット上の通信を暗号化して盗聴を防ぐプロトコル(現在はTLSに移行)/TLSTLS [ティーエルエス]Transport Layer Security。SSLの後継となる安全性の高い暗号化通信プロトコル 終端、複数アプリケーションの振り分け、負荷分散などを柔軟に実装できます。

一方で、実務では「 proxy_pass の末尾にスラッシュ(/)を付けるかどうかで転送先パスが変わってしまう 」「 バックエンド側でクライアントの元 IPIP [アイピー]Internet Protocol。インターネット通信の基本プロトコル アドレスが取得できない 」といった設定上のつまずきもよく発生します。

本記事では、Nginx でリバースプロキシを構築する基本手順から、proxy_pass や proxy_set_header の正確な仕組み、WebSocketWebSocket [ウェブソケット]クライアントとサーバー間の双方向リアルタイム通信プロトコル 対応・負荷分散などの応用設定、よくあるエラー(502 Bad Gateway 等)の対処法まで実機検証を交えて解説します。

この記事のポイント

  • リバースプロキシの基本は location ブロック内の proxy_pass ディレクティブで転送先 URLURL [ユーアールエル]Uniform Resource Locator。Webページのアドレス を指定する
  • クライアントの元ホスト名や IP アドレスをバックエンドへ伝えるには proxy_set_header の設定が必要
  • proxy_pass の末尾スラッシュ(/)の有無 によって、バックエンドへ渡される URL パスが変化するため要注意
  • 設定変更後は必ず sudo nginx -t で構文チェックを行ってから sudo systemctl reload nginx で反映する

1. Nginx のリバースプロキシとは?(仕組みと役割)

リバースプロキシ(Reverse Proxyproxy [プロキシ]クライアントとサーバーの間に立って通信を中継するサーバー) とは、クライアント(ブラウザ等)とバックエンドのアプリケーションサーバーの間に立ち、クライアントからのリクエストを代理で受け取って背後のサーバーへ転送する仕組みです。

【Nginx リバースプロキシの基本構成】
[ クライアント(ブラウザ) ]
│
│ https://example.com/ (80 / 443番ポート)
▼
[ Nginx(リバースプロキシ) ]
│
│ http://127.0.0.1:3000 (内部転送:proxy_pass)
▼
[ バックエンドアプリ(Node.js / Python / Go / Docker 等) ]

アプリケーションサーバーを直接インターネットに公開せず、前段に Nginx のリバースプロキシを配置する主なメリットは以下の通りです。

フォワードプロキシとリバースプロキシの概念的な違いや、Nginx のインストール手順については以下の記事で詳しく解説しています。

フォワードプロキシとリバースプロキシの違いとは?
ITナレッジライフ

フォワードプロキシとリバースプロキシの違いとは?

「フォワードプロキシ」と「リバースプロキシ」の違いに迷っていませんか?中継する対象(クライアント側 vs サーバー側)、IP匿名化・キャッシュ・負荷分散・WAF・SSL終端などの役割の違いを、初心者にもわかりやすい図解と表で徹底解説します。

【Ubuntu】nginxとは、インストール・再起動や停止方法
ITナレッジライフ

【Ubuntu】nginxとは、インストール・再起動や停止方法

nginxはオープンソースのWebサーバです。本記事では、Webサーバー「Nginx」のインストール方法と基本的な起動・管理方法について解説します。Ubuntuの環境での導入手順を紹介し、Apacheとの違いや、設定ファイルの基本構造についても詳しく説明します。

スポンサーリンク

2. リバースプロキシの基本設定手順(proxy_pass と proxy_set_header)

UbuntuUbuntu [ウブントゥ]人気のLinuxディストリビューション 24.04 LTS などの LinuxLinux [リナックス / ライナックス]オープンソースのOSカーネル 環境において、Nginx でリバースプロキシを設定する基本的な手順を見ていきましょう。

設定ファイルの配置場所

Nginx の設定ファイルは、OSOS [オーエス]Operating System。基本ソフトウェア やパッケージ構成によって主に以下のディレクトリに配置します。

どちらの方式でも、最終的に /etc/nginx/nginx.conf の http ブロック内から include されて読み込まれます。

基本的な設定ファイルの記述例

ここでは、ドメイン example.com(80 番ポート)へのリクエストを、同一サーバー内の 127.0.0.1:3000 で稼働しているバックエンドアプリへ転送する基本設定を作成します。

/etc/nginx/conf.d/reverse-proxy.conf(または sites-available/default)
server {
listen 80;
server_name example.com;
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;
}
}

最も重要なディレクティブが proxy_pass と proxy_set_header の 2 つです。それぞれの役割を詳しく確認しましょう。

なぜ proxy_set_header が必要なのか?

Nginx がリバースプロキシとしてバックエンドへリクエストを転送する際、デフォルトでは バックエンドへの接続元 IP アドレスは Nginx 自身(127.0.0.1 等) になり、 Host ヘッダーも転送先アドレス($proxy_host、上記例では 127.0.0.1:3000)に書き換えられます 。

そのため、proxy_set_header を設定しないまま運用すると、バックエンドのアプリケーション側で「アクセスログの接続元 IP がすべて 127.0.0.1 になる」「元のドメイン名(example.com)や HTTPS かどうかの判定ができず、リダイレクト URL が壊れる」といった問題が発生します。

これを防ぐために指定するのが、以下の 4 つのヘッダー設定です。

指定するヘッダーと変数設定内容と役割
Host $hostクライアントがリクエストした元のホスト名(例: example.com)を Host ヘッダーとして引き継ぎます。
X-Real-IP $remote_addrクライアントの実際の IP アドレス($remote_addr)を X-Real-IP ヘッダーに格納してバックエンドへ伝えます。
X-Forwarded-For $proxy_add_x_forwarded_for既存の X-Forwarded-For ヘッダーの末尾にクライアントの IP アドレスをカンマ区切りで追記し、経由したプロキシの経路情報を保持します。
X-Forwarded-Proto $schemeクライアントが Nginx にアクセスした際のプロトコル(http または https)をバックエンドへ伝えます。SSL 終端を行う構成で特に重要です。

実際に上記の設定を行った Nginx を経由して /users へアクセスした際、バックエンド側で受け取る HTTP ヘッダー情報を確認すると以下のようになります。

Nginx経由でリクエストを送信(動作確認)
curl -s -H "Host: example.com" http://127.0.0.1:80/users
バックエンド側が受け取ったリクエスト情報
{
"path": "/users",
"host": "example.com",
"x_real_ip": "127.0.0.1",
"x_forwarded_for": "127.0.0.1",
"x_forwarded_proto": "http"
}

元の Host(example.com)やクライアント IP、プロトコル(http)が正確にバックエンドへ引き渡されていることがわかります。

構文チェックと設定の反映(nginx -t / reload)

設定ファイルを保存したら、いきなり Nginx を再起動するのではなく、必ず事前に nginx -t コマンドで構文エラーがないかテストします。

Nginx 設定ファイルの構文チェック
sudo nginx -t
実行結果(正常時)
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

syntax is ok および test is successful と表示されたことを確認したら、現在の通信を切断せずに設定を再読み込みする reload を実行します。

Nginx の設定を再読み込み
sudo systemctl reload nginx

3. 【重要】proxy_pass の末尾スラッシュ(/)の有無による挙動の違い

Nginx のリバースプロキシ設定において、初心者から経験者まで最もつまずきやすいポイントが proxy_pass に指定する URL の末尾にスラッシュ(/)などの URIURI [ユーアールアイ]Uniform Resource Identifier。リソースを識別する文字列 パスを含めるかどうか です。

特に location /api/ のようにサブディレクトリ単位でプロキシする場合、末尾スラッシュの有無によってバックエンドに渡されるリクエストパスが大きく変わります。

設定パターンlocation /api/ での記述例/api/users へのアクセス時に転送されるパス挙動の仕組み
末尾スラッシュなし (URI なし)proxy_pass http://127.0.0.1:3000;/api/usersクライアントがリクエストした URI パスが そのまま バックエンドへ渡される
末尾スラッシュあり (URI あり)proxy_pass http://127.0.0.1:3000/;/userslocation で一致した /api/ の部分が proxy_pass 末尾の / に 置換(削除) されて渡される

実際の設定コードと動作の違いを比較してみましょう。

パターンA:末尾にスラッシュを付けない場合(パスをそのまま転送)

バックエンドのアプリケーション自体が /api/users というルーティングを持っている場合は、ポート番号の後ろにスラッシュ(/)を 付けません 。

末尾スラッシュなしの設定例
location /api/ {
# 末尾に「/」を付けない → /api/users はそのまま /api/users として転送される
proxy_pass http://127.0.0.1:3000;
}

パターンB:末尾にスラッシュを付ける場合(プレフィックスを削って転送)

一方、バックエンドのアプリケーションはルート(/users)で待ち受けており、外部公開時だけ /api/ というプレフィックスを付けたい場合は、ポート番号の後ろに / を付けます。

末尾スラッシュありの設定例
location /api/ {
# 末尾に「/」を付ける → /api/users の「/api/」が「/」に置換され、/users として転送される
proxy_pass http://127.0.0.1:3000/;
}

実機で両方のロケーションを用意し、それぞれ /users へのリクエストを送信した際のバックエンド到達パスは以下の通りです。

末尾スラッシュなし(/api-no-slash/users へアクセス時)
{
"path": "/api-no-slash/users",
"host": "127.0.0.1:3000"
}
末尾スラッシュあり(/api-with-slash/users へアクセス時)
{
"path": "/users",
"host": "127.0.0.1:3000"
}

「リバースプロキシを設定したのにバックエンドから 404 Not Found が返ってくる」というトラブルの大半は、この末尾スラッシュの有無によるパスのズレが原因です。バックエンド側が期待しているパス構造に合わせて使い分けましょう。

スポンサーリンク

4. 実務でよく使う応用設定パターン

基本的なリクエスト転送に加えて、実務の Web システム構築でよく求められる 3 つの応用設定を紹介します。

4.1 WebSocket 通信をプロキシする設定

チャット機能やリアルタイム通知、開発サーバーの HMR(ホットリロード)などで WebSocket(ws:// / wss://) を使用する場合、通常の proxy_pass だけではプロトコルの切り替え(ハンドシェイク)がうまくいかず通信が切断されてしまいます。

Ubuntu 24.04 LTS の標準パッケージ(Nginx 1.24 系)など 1.29.6 以前の Nginx は、デフォルトでバックエンドとの通信に HTTP/1.0 を使用します(1.29.7 以降はデフォルトが HTTP/1.1 に変更)。また、Upgrade / Connection はホップバイホップヘッダーのため、バージョンにかかわらず自動ではバックエンドへ転送されません。そのため WebSocket を中継するには HTTP/1.1 の明示 と Upgrade / Connection ヘッダーの転送 を追加します。

WebSocket 対応のリバースプロキシ設定
location /ws/ {
proxy_pass http://127.0.0.1:3000;
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;
}

4.2 upstream ディレクティブによる複数サーバーへの負荷分散

バックエンドサーバーを複数台(または複数ポートのコンテナ)用意し、Nginx で負荷分散(ロードバランシング)を行いたい場合は、http ブロック直下に upstream ブロックを定義します。

upstream を使った負荷分散設定
upstream backend_app {
# デフォルトはラウンドロビン(順番に均等振り分け)
server 127.0.0.1:3001;
server 127.0.0.1:3002;
}
server {
listen 80;
server_name example.com;
location / {
# upstream で定義したグループ名を指定
proxy_pass http://backend_app;
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;
}
}

特別なアルゴリズムを指定しない場合、リクエストは 3001 番と 3002 番へ順番に振り分けられます(ラウンドロビン方式)。また、片方のサーバーがダウンした際には自動的に稼働中のサーバーへリクエストを迂回させることも可能です。

4.3 タイムアウトとリクエストサイズ上限の調整

大きなファイルのアップロードや、AIAI [エーアイ]Artificial Intelligence。人工知能 推論・レポート生成など時間のかかる API 処理をプロキシする場合、Nginx のデフォルト上限に引っかかってエラーになることがあります。用途に応じて以下のディレクティブを調整します。

アップロード上限とタイムアウトの調整例
server {
listen 80;
server_name example.com;
# リクエストボディ(ファイルアップロード等)の最大サイズを 20MB に変更(デフォルト: 1m)
client_max_body_size 20m;
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;
# バックエンドへの接続・送受信タイムアウト(デフォルト: 各 60s)
proxy_connect_timeout 60s;
proxy_send_timeout 120s;
proxy_read_timeout 120s;
}
}

5. よくあるエラー(502 Bad Gateway 等)の原因と対処法

リバースプロキシの設定後にブラウザでエラーが表示された場合は、HTTP ステータスコードと Nginx のエラーログ(/var/log/nginx/error.log)を確認することで原因を素早く特定できます。

ステータスコード主な発生原因確認ポイントと対処法
502 Bad GatewayNginx からバックエンドへ接続できないバックエンドの起動状態、待受ポート・IP(127.0.0.1 と ::1 の不一致)、SELinux 設定を確認する
504 Gateway Timeoutバックエンドからの応答が時間内に返らないバックエンド処理の詰まりを確認するか、長時間処理なら proxy_read_timeout を延長する
413 Request Entity Too Largeアップロードしたデータが上限を超えているserver または location ブロックに client_max_body_size を追加して上限を引き上げる
404 Not Found転送先の URL パスが一致していないセクション 3 で解説した proxy_pass 末尾のスラッシュ(/)の有無を見直す

localhost 指定による IPv6 / IPv4 の不一致に注意

proxy_pass http://localhost:3000; と記述した場合、OS の名前解決設定(/etc/hosts)によっては localhost が IPv6IPv6 [アイピーブイシックス]インターネットプロトコル第6版。128ビットでIPアドレスを表現し枯渇問題を解決する アドレス([::1])に解決されることがあります。このとき、バックエンドアプリ側が IPv4IPv4 [アイピーブイフォー]インターネットプロトコル第4版。32ビットでIPアドレスを表現する(127.0.0.1)のみで待ち受けていると、Connection refused となり 502 Bad Gateway が発生します。

ローカルのバックエンドへ転送する際は、ホスト名の localhost ではなく明示的に http://127.0.0.1:3000 と IPv4 アドレスで指定しておくと、名前解決の揺れによるトラブルを防げます。

AlmaLinux / Rocky Linux での SELinux による通信ブロック

AlmaLinux や Rocky Linux などの RHEL 系ディストリビューションでは、SELinux のデフォルト設定により Nginx(httpd_t)からバックエンドポートへのネットワーク接続が拒否され、 502 Bad Gateway (エラーログ上は 13: Permission denied)になることがあります。その場合は以下のコマンドでネットワーク接続を許可します。

SELinux で Nginx からのネットワーク接続を許可(RHEL系)
sudo setsebool -P httpd_can_network_connect 1

エラーログの確認コマンド

エラーの詳細原因を調べる際は、以下のコマンドで Nginx のエラーログ末尾を確認しましょう。

Nginx のエラーログをリアルタイムで確認
sudo tail -f /var/log/nginx/error.log

たとえば 502 Bad Gateway 発生時に connect() failed (111: Connection refused) while connecting to upstream と記録されていれば、「指定した IP・ポートでバックエンドが待ち受けていない」ことが即座に判別できます。

HTTPステータスコードの覚え方(100〜500番台)を分かりやすく解説
ITナレッジライフ

HTTPステータスコードの覚え方(100〜500番台)を分かりやすく解説

Web開発や基本情報技術者試験で頻出の「HTTPステータスコード」の覚え方を解説します。100番台から500番台までの意味を、語呂合わせや直感的なイメージで楽しく暗記しましょう。

6. まとめ

本記事では、Nginx でリバースプロキシを設定する方法と実務で役立つ設定パターンを解説しました。

  • 基本構文: location ブロック内で proxy_pass を指定し、クライアントの情報を引き継ぐために proxy_set_header (Host、X-Real-IP、X-Forwarded-For、X-Forwarded-Proto)を合わせて設定する。
  • 末尾スラッシュの挙動: location /api/ に対して proxy_pass http://127.0.0.1:3000; は /api/ を残したまま転送し、proxy_pass http://127.0.0.1:3000/; は /api/ を削ってルートへ転送する。
  • 応用とトラブル対策: WebSocket 通信時は Upgrade ヘッダーと proxy_http_version 1.1 を追加し、ファイルサイズ上限(413 エラー)やタイムアウト(504 エラー)は用途に応じて調整する。
  • 安全な反映手順: 設定編集後は必ず sudo nginx -t で構文チェックを行い、問題がなければ sudo systemctl reload nginx で反映する。

Nginx のサービス管理に使われる systemctl コマンドや、ApacheApache [アパッチ]世界中で広く利用されているオープンソースのWebサーバーソフトウェア と Nginx のアーキテクチャの違いについては以下の記事もあわせて参考にしてください。

【Linux】systemctlコマンドの使い方|起動・停止・再起動
ITナレッジライフ

【Linux】systemctlコマンドの使い方|起動・停止・再起動

Linuxのsystemctlコマンドの使い方をわかりやすく解説。サービスの起動・停止・再起動・自動起動設定(enable/disable)から、ステータス確認、ログ確認(journalctl連携)、起動しないときのトラブルシューティングまで実務で役立つ操作を網羅。

ApacheとNginxの違い|処理モデル・速度・設定の比較
ITナレッジライフ

ApacheとNginxの違い|処理モデル・速度・設定の比較

ApacheとNginxの違いがわからないと悩むエンジニア必見!現役エンジニアが処理モデル(マルチプロセス vs イベント駆動)・静的/動的コンテンツ性能・設定方法・セキュリティを徹底比較。プロジェクトに最適なWebサーバーを選定する判断基準とフローチャートを解説します。


以上で本記事の解説を終わります。
よいITライフを!
スポンサーリンク
ITナレッジライフ 運営者
この記事を書いた人

Z (ITナレッジライフ)

現役のITエンジニア。Linux、プログラミング、IT用語など、日々の業務で得た「痒いところに手が届く」技術情報を発信しています。

プロフィールと編集ポリシーを見る →
スポンサーリンク

Ubuntuユーザにお勧めの本 ↗

Ubuntuサーバー徹底入門

難易度
実用性
網羅性

設定の勘所が詳しく解説されている。Ubuntu運用の強い味方になってくれる一冊です。

スポンサーリンク

人気記事


記事を評価

Thanks!
目次
Scroll to Top