ポート番号を隠す — nginxのリバースプロキシ

nginxのリバースプロキシ。入口となるサーバーと背後のアプリの箱、振り分ける通信線。

※本記事はアフィリエイト広告(PR)を含みます。

世の中のサイトにポート番号は付いていません。前にnginxを立てて、複数のサイトを1つの入口で振り分けます。

前回: nginxを入れたのに繋がらない — Webサーバーの導入 前回入れた nginx を、そのまま使います。作業場所は VM の中です。

ここまで、ページを開くときにポート番号を打っていました。

http://192.168.226.50:8000/

世の中のサイトに、この :8000 は付いていません。

https://obmes.com/

なぜか。 答えは「前に nginx が立っていて、後ろのアプリに渡している」からです。これをリバースプロキシと呼びます。

そしてもう一つ。1台のサーバーで、複数のサイトを配ることもできます。obmes.com もそうやって動いています。

対象レベル: 中級 / 区分: 必修

目次

この記事でわかること

  • ポート番号が消える仕組み(リバースプロキシ)
  • 1台のサーバーで複数のサイトを配れる理由と、その見分け方
  • 502 Bad Gateway が誰の責任なのか
  • X-Forwarded-For が要る理由(付けないとアクセス元が全部同じに見える)
  • 公開するファイルをホームディレクトリに置いてはいけない理由(権限を緩める羽目になる)

この記事でやること

  1. serverブロックを書いて、2つ目のサイトを追加する
  2. ホスト名で振り分けられていることを、curl で証明する
  3. 後ろにアプリを立てて、nginx 経由で開く
  4. わざと落として 502 を出し、原因の見方を確認する

先に知る言葉

この記事で初めて出てくる言葉です。 基本的な言葉は用語集にもまとめてあります。

言葉意味
リバースプロキシ利用者の前に立って要求を受け、後ろで動いているアプリに中継する役。URLからポート番号が消えるのはこれのおかげです。
server ブロックnginx の設定で server { ... } と囲んだ1かたまり。これが1サイト分で、増やせば1台で複数のサイトを配れます。
server_nameその server ブロックが担当するホスト名。nginx はリクエストの Host: を見て、どのブロックを使うか決めます。
proxy_pass「この場所に来たら、後ろのここへ渡す」という指定。リバースプロキシの本体はこの1行です。
www-dataUbuntu の nginx が使っている実行ユーザー名。ファイルを読めるかどうかは、このユーザーの権限で決まります。
502 Bad Gatewaynginx は生きているが、渡した先のアプリが応えないという返事。見るべきはアプリ側です。

serverブロック — 「1サイト = 1ブロック」

前回見た /etc/nginx/sites-available/default の中身です。コメントを除くと、こうなっています。

server {
    listen 80 default_server;
    listen [::]:80 default_server;

    root /var/www/html;
    index index.html index.htm index.nginx-debian.html;

    server_name _;

    location / {
        try_files $uri $uri/ =404;
    }
}

1行ずつ意味があります。

行意味
listen 8080番ポートで待つ
default_serverどれにも当てはまらないときの受け皿
root /var/www/htmlファイルを探す場所
index ...ディレクトリを指定されたときに返すファイル(この順に探す)
server_name _対象のホスト名。_ は「何でも」
location / { ... }URLのパスごとの設定
try_files $uri $uri/ =404ファイル → ディレクトリ の順に探し、無ければ404

server { ... } のかたまりが「1サイト分」です。これを増やせば、サイトが増えます。

2つ目のサイトを足す

root を自分のホームに置いて、sudo なしで更新できるようにします。

bash
$ mkdir -p ~/blog
$ cat > ~/blog/index.html <<'EOF'
  <!DOCTYPE html>
  <html lang="ja">
  <head><meta charset="UTF-8"><title>blog</title></head>
  <body><h1>これは blog 側です</h1></body>
  </html>
  EOF

cat > ファイル <<'EOF' は「ここから EOF までをファイルに書く」という書き方です。エディタを開かずに一気に作れます。

設定ファイルを新しく作ります。

bash
$ sudo nano /etc/nginx/sites-available/blog
server {
    listen 80;
    server_name blog.local;

    root /home/ユーザー名/blog;
    index index.html;

    location / {
        try_files $uri $uri/ =404;
    }
}

ユーザー名 は自分のものに置き換えてください。 whoami で確認できます。

有効にする

bash
$ sudo ln -s /etc/nginx/sites-available/blog /etc/nginx/sites-enabled/
$ sudo nginx -t
$ sudo systemctl reload nginx

ln -s がシンボリックリンクを作るコマンドです。前回見た「sites-enabled にあるのはリンク」を、自分で作ったことになります。

前回の3点セットを守ってください。 書いたら nginx -t で検査、通ったら reload。

権限でつまずくところ

ホームディレクトリを root に置くと、nginx が読めないことがあります。

bash
$ sudo -u www-data ls /home/ユーザー名/blog/

www-data は nginx が使っているユーザーです。そのユーザーになりきって読めるか試すのが、このコマンドです。

Permission denied が出たら、ホームディレクトリを通り抜ける権限が無いということです。権限の回で書いたとおり、ディレクトリの x は「中に入る権限」でした。読めるだけでは通り抜けられません。

bash
$ ls -ld /home/ユーザー名

Ubuntu の最近の版では drwxr-x---(750)になっています。末尾3文字が --- なので、自分とグループ以外は入れません。 www-data はここで止まっています。

直し方は2つあります。先に結論を書きます。

やり方何をするか評価
A. 置き場所を変える公開するファイルを /var/www の下に移すこちらを勧めます
B. 権限を緩めるchmod o+x /home/ユーザー名その場しのぎ。終わったら戻す

A. /var/www に置く(推奨)

そもそもホームディレクトリは、本人だけが使う場所です。 外に見せるファイルは、最初からそのための場所に置きます。

bash
$ sudo mkdir -p /var/www/blog
$ sudo cp ~/blog/index.html /var/www/blog/
$ sudo chown -R $USER:www-data /var/www/blog
$ sudo chmod 750 /var/www/blog

chown の $USER:www-data は「持ち主は自分、グループは nginx」という意味です。自分は sudo なしで書き換えられて、nginx は読める、という状態になります。

設定ファイルの root を書き換えます。

    root /var/www/blog;

確認: 書き換えたら検査と再読み込みをして、www-data で読めるかを見ます。

bash
$ sudo nginx -t
$ sudo systemctl reload nginx
$ sudo -u www-data ls /var/www/blog/

index.html が表示されれば成功です。この場合、ホームディレクトリの権限は一切触っていません。

B. ホームの権限を緩める(戻すことが前提)

この記事では「ディレクトリの x が通り抜けの権限だ」という話を実際に見たいので、あえてこちらもやります。

bash
$ chmod o+x /home/ユーザー名
$ sudo -u www-data ls /home/ユーザー名/blog/

確認: さっき Permission denied だったものが、ファイル名を返すようになれば成功です。

これは「自分のホームを、サーバー上の他の全員が通り抜けられる状態」にする変更です。 ホームの中身が丸見えになるわけではありません(通り抜けはできても、一覧を見る r は付けていないため)。 ですが、中のファイルやフォルダの名前を正確に知っていれば、そのファイル自身の権限しだいで読まれます。 練習用のVMなので実害は出ませんが、セキュリティに関わる変更を、意味を分からないまま残さないでください。

この記事の片づけで元に戻します。 実際に公開するサーバーでは、Aの /var/www を使ってください。

振り分けられていることを確かめる

blog.local という名前は、まだどこにも登録されていません。 それでも確認できます。

bash
$ curl -s http://localhost/ | grep '<h1>'
$ curl -s -H "Host: blog.local" http://localhost/ | grep '<h1>'
<h1>nginx が返しています</h1>
<h1>これは blog 側です</h1>

同じIP・同じポートに送っているのに、返ってくる中身が違います。

何が起きているか。 ブラウザは、リクエストに必ずホスト名を書いて送ります。

GET / HTTP/1.1
Host: blog.local        ← これ

nginx はこの Host: を見て、どの server ブロックを使うか決めています。

これが「1台のサーバーで何百ものサイトが動く」仕組みです。 DNSの回で「ドメイン名をIPに変換する」と書きましたが、IPが同じでも、ホスト名で行き先が分かれます。

-H "Host: ..." は、その Host: を手で指定するオプションです。DNSに登録しなくても、振り分けの動作確認ができます。

[スクリーンショット: 01_host振り分け.png] 2つの curl の結果が違っている画面を撮ってください。

ブラウザから開きたいとき

ホストのWindows側の hosts ファイルに1行足すと、ブラウザでも開けます。

C:\Windows\System32\drivers\etc\hosts
192.168.226.50  blog.local

メモ帳を「管理者として実行」して開く必要があります。

これは自分のPCの中だけの話です。 他人からは見えません。動作確認用の近道として使い、使い終わったら消してください。 消し忘れると、後日「なぜかこのドメインだけ変な場所に繋がる」と悩むことになります。

リバースプロキシ — 後ろにアプリを立てる

ここからが本題です。

Webサイトがファイルを返すだけなら、ここまでで足ります。しかしアプリケーション(この先で作る Node.js のAPIなど)は、自分でポートを持って動きます。

アプリが 3000番で動いている
        ↓
利用者に http://例:3000/ と打たせるのか?

打たせません。 代わりに、nginx が80番で受けて、中で3000番に渡します。

ブラウザ ──80──> nginx ──3000──> アプリ
                       <──────
         <──────

これがリバースプロキシです。

後ろ側を用意する

まだアプリを作っていないので、python3 -m http.server を「アプリのふり」に使います。

bash
$ mkdir -p ~/app
$ echo '<h1>後ろのアプリです(3000番)</h1>' > ~/app/index.html
$ cd ~/app
$ python3 -m http.server 3000 --bind 127.0.0.1

--bind 127.0.0.1 を付けています。 これでVMの外からは直接繋がりません。 後ろのアプリは外に晒さない、というのが正しい形です。入口は nginx だけにします。

このターミナルは動かしたままにして、別のターミナルを開いてください。(VS Code のターミナルなら + で増やせます)

確認します。

bash
$ curl -I http://127.0.0.1:3000/
HTTP/1.0 200 OK

前に nginx を立てる

bash
$ sudo nano /etc/nginx/sites-available/app
server {
    listen 80;
    server_name app.local;

    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;
    }
}
bash
$ sudo ln -s /etc/nginx/sites-available/app /etc/nginx/sites-enabled/
$ sudo nginx -t
$ sudo systemctl reload nginx

確認します。

bash
$ curl -s -H "Host: app.local" http://localhost/
<h1>後ろのアプリです(3000番)</h1>

80番に投げたのに、3000番の中身が返ってきました。 ポート番号が消えています。

[スクリーンショット: 02_リバースプロキシ.png] curl で 80番から3000番の中身が返っている画面を撮ってください。

proxy_set_header を書く理由

proxy_pass の1行だけでも動きます。 ではなぜ4行も足すのか。

そのまま渡すと、後ろのアプリから見た「相手」が nginx になってしまうからです。

ヘッダー付けないとどうなるか
Hostアプリが自分のドメイン名を知らない。リダイレクト先がおかしくなる
X-Real-IPアクセス元が全部 127.0.0.1 に見える
X-Forwarded-For同上。不正アクセスを調べるときに誰も特定できない
X-Forwarded-Protohttpsで来たのかhttpで来たのかが分からない

最後のものには、心当たりがあります。

https強制の回で、.htaccess にこう書きました。

RewriteCond %{HTTP:X-Forwarded-Proto} !=https

あれは、まさにこの仕組みの受け手側です。 前段のサーバーが「https で来ましたよ」と教えてくれるから、後ろが判断できる。書く側と読む側の両方を見たことになります。

リバースプロキシを書くときは、この4行をセットにしてください。

502 Bad Gateway を出してみる

後ろのアプリを止めます。 python3 -m http.server を動かしているターミナルで Ctrl + C。

bash
$ curl -I -H "Host: app.local" http://localhost/
HTTP/1.1 502 Bad Gateway
Server: nginx/1.24.0 (Ubuntu)

502 は「nginx は動いているが、後ろが応えない」という意味です。

ステータス誰の問題か
繋がらない・タイムアウトnginx が動いていない、または経路の問題
502 Bad Gatewaynginx は生きている。後ろのアプリが落ちている
504 Gateway Timeout後ろは生きているが、時間内に返せていない
404nginx がファイルを見つけられない(proxyしていない場合)

502 を見たら、nginx ではなくアプリ側を見る、と決めておくと調査が速くなります。

ログにも出ています。

bash
$ sudo tail -n 5 /var/log/nginx/error.log
connect() failed (111: Connection refused) while connecting to upstream, ...
upstream: "http://127.0.0.1:3000/"

Connection refused と、繋ごうとした先まで書いてあります。 推測は要りません。

[スクリーンショット: 03_502エラー.png] 502 が返っている状態と、error.log の該当行を撮ってください。

静的ファイルは nginx に返させる

画像やCSSまでアプリに取りに行かせるのは無駄です。nginx が直接返すほうが速い。

server {
    listen 80;
    server_name app.local;

    location /static/ {
        alias /home/ユーザー名/app/static/;
    }

    location / {
        proxy_pass http://127.0.0.1:3000;
        # ... proxy_set_header 4行 ...
    }
}

location は上から順ではなく、「より具体的なもの」が優先されます。/static/ で始まるURLだけが分岐します。

root と alias の違いに注意。
・root /var/www + location /static/ → /var/www/static/... を探す(パスが足される)
・alias /home/x/static/ + location /static/ → /home/x/static/... を探す(置き換わる)

alias は末尾のスラッシュを忘れると動きません。 ここは何度もやります。

片づけ

練習で作ったものを残すと、後で混乱します。

bash
$ sudo rm /etc/nginx/sites-enabled/blog
$ sudo rm /etc/nginx/sites-enabled/app
$ sudo nginx -t
$ sudo systemctl reload nginx

sites-enabled から消すだけにしてください。実体(sites-available)は残るので、後でまた有効にできます。

hosts ファイルに足した行も、忘れずに消してください。

緩めた権限を戻す

Bのやり方で chmod o+x を打った人は、必ず戻してください。 設定を消しても、権限だけは緩んだまま残ります。

bash
$ chmod o-x /home/ユーザー名
$ ls -ld /home/ユーザー名

確認: drwxr-x--- に戻っていれば成功です。末尾が --x のままなら、まだ緩んでいます。

bash
$ sudo -u www-data ls /home/ユーザー名/blog/

ここが Permission denied に戻れば、閉じられたということです。 練習で作った ~/blog と /var/www/blog は、消しても残しても構いません。

まとめ

  • server { ... } のかたまりが1サイト分。 増やせばサイトが増える
  • 振り分けはリクエストの Host: ヘッダーで行われる。 IPが同じでもサイトは分かれる
  • curl -H "Host: ..." で、DNSに登録せず振り分けを確認できる
  • sudo -u www-data ls ... で「nginxが読めるか」を確かめられる。 ディレクトリの x は通り抜ける権限
  • リバースプロキシ = 前で受けて、後ろのアプリに渡す。 これでURLからポート番号が消える
  • 後ろのアプリは --bind 127.0.0.1 で外に晒さない。 入口は nginx だけにする
  • proxy_set_header の4行はセット。 付けないとアクセス元が全部 127.0.0.1 に見える
  • X-Forwarded-Proto は、https強制の .htaccess で読んでいたものと同じ。 書く側と読む側が繋がった
  • 502 は「nginxは生きていて、後ろが死んでいる」。 アプリ側を見る
  • root はパスが足され、alias は置き換わる。 alias の末尾スラッシュを忘れない
  • 練習用の設定は sites-enabled から消す。 実体は残るのでやり直せる
  • 公開するファイルはホームではなく /var/www に置く。 chmod o+x ~ は他人が自分のホームを通り抜けられる状態を作る。やったら必ず chmod o-x で戻す

次はコンテナです。ここまでは VM に直接ソフトを入れてきましたが、「入れずに動かす」やり方に切り替えます。

→ 次の記事: コンテナは軽い仮想マシンではない — Dockerの導入


serverブロックで複数サイトを1台に載せる構成は、実際のドメインとVPSで組むと「Host: ヘッダで振り分ける」意味が身体で分かります。クラウド VPS byGMOは1GB(仮想2コア・50GB)が12ヶ月契約で月額858円(税込・2026年11月時点の公式表示)で、初めての申し込みなら1GB/2GB/4GBプランに15日間の無料お試しがあります。ただし表示月額とは別にサーチャージ費が毎月加算され、お試しは最終日の2営業日前までに解約しないと自動で本契約になるので、その2点は申し込み前に確認してください。

参考リンク


次に読む

この記事は 【第6段階】インフラとコンテナ の 2 / 25 本目です。

記事
← 前の記事nginxを入れたのに繋がらない — Webサーバーの導入
→ 次の記事コンテナは軽い仮想マシンではない — Dockerの導入

上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。

全体の順路は はじめに にあります。

roadmap.sh のどこをやっているか

DevOps›What is and how to setup — Web Servers
  • Nginx — Reverse Proxy
  • Forward Proxy との違い
  • Load Balancer の入口

この記事は、上の項目を実際に手を動かして確かめる回です。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

コメント

コメントする

目次