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 のリバースプロキシを配置する主なメリットは以下の通りです。
- ポート番号の統一と内部構造の隠蔽: 内部で
3000番や8080番ポートで動いているアプリに対し、外部からは標準の HTTPHTTP [エイチティーティーピー]HyperText Transfer Protocol。Webでのデータ転送プロトコル(80 番)・HTTPSHTTPS [エイチティーティーピーエス]HTTP Secure。暗号化されたHTTP(443 番)でアクセスさせることができます。 - URL パスやドメインごとの振り分け: 1 台のサーバー上で、
/はフロントエンドアプリ、/api/はバックエンド APIAPI [エーピーアイ]Application Programming Interface。異なるソフトウェア間の接続口 サーバーといった柔軟なルーティングが可能です。 - SSL/TLS 終端の一元化: HTTPS 通信の暗号化・復号処理を Nginx 側でまとめて行い、バックエンドアプリ側の証明書管理や処理負荷を軽減できます。
- 静的ファイル配信と負荷分散: 画像や CSSCSS [シーエスエス]Cascading Style Sheets。Webページのデザインを記述する言語・JavaScript などの静的配信を高速な Nginx に任せたり、複数のバックエンドサーバーへリクエストを分散させたりできます。
フォワードプロキシとリバースプロキシの概念的な違いや、Nginx のインストール手順については以下の記事で詳しく解説しています。

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

【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。基本ソフトウェア やパッケージ構成によって主に以下のディレクトリに配置します。
- Ubuntu / DebianDebian [デビアン]コミュニティ主導で開発される安定性の高いLinuxディストリビューション 系:
/etc/nginx/sites-available/に設定ファイルを作成し、/etc/nginx/sites-enabled/へシンボリックリンクを貼る(または/etc/nginx/conf.d/*.confに配置する) - AlmaLinux / Rocky Linux / RHEL 系・公式リポジトリ版:
/etc/nginx/conf.d/配下に<任意の名前>.conf(例:app.conf)を作成する
どちらの方式でも、最終的に /etc/nginx/nginx.conf の http ブロック内から include されて読み込まれます。
基本的な設定ファイルの記述例
ここでは、ドメイン example.com(80 番ポート)へのリクエストを、同一サーバー内の 127.0.0.1:3000 で稼働しているバックエンドアプリへ転送する基本設定を作成します。
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 ヘッダー情報を確認すると以下のようになります。
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 コマンドで構文エラーがないかテストします。
sudo nginx -tnginx: the configuration file /etc/nginx/nginx.conf syntax is oknginx: configuration file /etc/nginx/nginx.conf test is successfulsyntax is ok および test is successful と表示されたことを確認したら、現在の通信を切断せずに設定を再読み込みする reload を実行します。
sudo systemctl reload nginx3. 【重要】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/; | /users | location で一致した /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 へのリクエストを送信した際のバックエンド到達パスは以下の通りです。
{ "path": "/api-no-slash/users", "host": "127.0.0.1:3000"}{ "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 ヘッダーの転送 を追加します。
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 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 Gateway | Nginx からバックエンドへ接続できない | バックエンドの起動状態、待受ポート・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)になることがあります。その場合は以下のコマンドでネットワーク接続を許可します。
sudo setsebool -P httpd_can_network_connect 1エラーログの確認コマンド
エラーの詳細原因を調べる際は、以下のコマンドで 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番台)を分かりやすく解説
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コマンドの使い方|起動・停止・再起動
Linuxのsystemctlコマンドの使い方をわかりやすく解説。サービスの起動・停止・再起動・自動起動設定(enable/disable)から、ステータス確認、ログ確認(journalctl連携)、起動しないときのトラブルシューティングまで実務で役立つ操作を網羅。

ApacheとNginxの違い|処理モデル・速度・設定の比較
ApacheとNginxの違いがわからないと悩むエンジニア必見!現役エンジニアが処理モデル(マルチプロセス vs イベント駆動)・静的/動的コンテンツ性能・設定方法・セキュリティを徹底比較。プロジェクトに最適なWebサーバーを選定する判断基準とフローチャートを解説します。
以上で本記事の解説を終わります。
よいITライフを!
人気記事
- 1
- 2
- 3
- 4
- 5
設定の勘所が詳しく解説されている。Ubuntu運用の強い味方になってくれる一冊です。