※本記事はアフィリエイト広告(PR)を含みます。
roadmap.sh のどこをやっているか
- Nginx
- 静的ファイルの配信
- systemd によるサービス管理
この記事は、上の項目を実際に手を動かして確かめる回です。
前回: 短縮URL APIを自力で作る — コードは1行も載せません ここから第6段階(インフラとコンテナ)です。 ビルドツールの回で作った
~/vite-demo/dist/を、この回で nginx に載せます。 前提: VMware に Ubuntu Server を入れる と、第1段階のLinux が終わっていること。 作業場所は VM の中(Ubuntu Server)です。Windows 本体では打ちません。
ここまでの記事では、ページを python3 -m http.server で表示していました。あれは動作確認用のおもちゃです。
前回: バックエンドの制作演習|APIを設計して動き続ける状態にする ここから第6段階(インフラとコンテナ)です。 Viteでビルドする|dist/の中身とESモジュールの仕組みで作った
~/vite-demo/dist/を、この回で nginx に載せます。 前提: VMware WorkstationにUbuntu Serverを入れる手順|VM作成とスナップショット と、aptの使い方|updateとupgradeの違いとパッケージ管理の基本 が終わっていること。 作業場所は VM の中(Ubuntu Server)です。Windows 本体では打ちません。
世の中のサイトは、ほぼ nginx か Apache で配られています。 このサイト(obmes.com)もそうです。
そして nginx を入れること自体は、コマンド1行で終わります。 詰まるのはそこではありません。
入れたのに、ブラウザで開いても繋がらない。
自分もここで止まりました。 原因は3つのどれかで、切り分ける順番が決まっています。
似たタイトルの記事があります。役割が違います。 この記事はnginx を入れて動かすを扱います。Apache・Caddyとnginxの違い|設計の差と使い分け はApache・Caddy と比べた設計の違いと使い分けを扱います。
対象レベル: 中級 / 区分: 必要に応じて読む
この記事でわかること
- Webサーバーが何をしているのか(
python3 -m http.serverと何が違うのか) - 「繋がらない」の原因が3つしかないこと、そして見分ける順番
- nginx の設定ファイルがどこにあり、どういう構造か
- 設定を壊したときに、反映される前に気づく方法
この記事でやること
- VM に nginx を入れる
- VMの中から → ホストのブラウザから、の順に繋がるか確かめる
- 繋がらないときの3つの原因を順に潰す
- 表示するファイルを自分のものに差し替える
- 設定を検査してから反映する、という習慣を作る
先に知る言葉
この記事で初めて出てくる言葉です。 基本的な言葉は用語集にもまとめてあります。
| 言葉 | 意味 |
|---|---|
| nginx(エンジンエックス) | 本番で使われるWebサーバーのソフト。大量の同時アクセスをさばき、URLごとの動きを設定ファイルで細かく決められます。 |
| Apache(アパッチ) | nginx と並ぶ、もう1つの代表的なWebサーバーのソフト。世の中のサイトはだいたいこのどちらかで配られています。 |
sites-available / sites-enabled | サイトごとの設定を書いておく場所と、そのうち実際に有効にしたものを並べる場所。設定を消さずに無効化できます。 |
nginx -t | 設定ファイルが文法的に正しいかを、反映せずに検査するコマンド。壊れていれば行番号付きで教えてくれます。 |
reload | サービスを止めずに設定だけ読み直させること。restart と違い、その間も接続が切れません。 |
Webサーバーは何をしているのか
やっていることは単純です。
「このURLに来たら、このファイルを返す」を延々とやっている。
DNSとHTTPの回で見た GET / HTTP/1.1 というリクエストを受け取って、ファイルの中身を返す。それだけです。
では python3 -m http.server と何が違うのか。
python3 -m http.server | nginx | |
|---|---|---|
| 用途 | 動作確認用 | 本番 |
| 同時アクセス | 少しならさばける(Python 3.7 以降はスレッドで並行処理。本番の負荷は想定していない) | 数千を同時にさばける |
| 停止したら | 終わり | 自動で再起動する(systemd) |
| 設定 | ほぼ無い | URLごとに細かく決められる |
| HTTPS | 非対応 | 対応 |
「遅くて、落ちたら終わりで、設定できない」 のが http.server です。学習の入口としては良いのですが、それ以上には使えません。
入れる
aptの回で書いたとおり、apt update は「一覧の更新」で、これ自体は何もアップグレードしません。 入れる前に必ず打ちます。
続けて 80番を開ける
入れた直後にこれをやります。飛ばすと、このあとの「③ ホストのブラウザから」で必ず止まります。
Ubuntu Server の初期設定で ufw を有効(22番だけ許可) にしてあるので、いまのVMは 80番を塞いでいます。
Available applications:
Nginx Full
Nginx HTTP
Nginx HTTPS
OpenSSH
nginx を入れると、この一覧に Nginx が追加されます。 番号ではなく名前で許可できます。
Status: active
To Action From
-- ------ ----
22/tcp ALLOW Anywhere
Nginx HTTP ALLOW Anywhere
Nginx HTTP の行が出れば準備完了です。
| 名前 | 開くポート |
|---|---|
Nginx HTTP | 80番だけ(今回はこれ) |
Nginx HTTPS | 443番だけ |
Nginx Full | 80番と443番の両方 |
まだ https は設定していないので Nginx HTTP で十分です。 使っていないポートは開けません。
入ったか確かめる
nginx version: nginx/1.24.0 (Ubuntu)
バージョンが出れば入っています。
動いているか確かめる
入っていることと、動いていることは別です。 systemdの回でやったとおりに見ます。
● nginx.service - A high performance web server and a reverse proxy server
Loaded: loaded (/usr/lib/systemd/system/nginx.service; enabled; preset: enabled)
Active: active (running) since Tue 2026-09-01 10:12:03 UTC; 8s ago
見るのは2つです。
| 表示 | 意味 |
|---|---|
Active: active (running) | いま動いている |
enabled | 再起動しても自動で立ち上がる |
Ubuntu の nginx は、入れた瞬間に起動して enabled にもなります。 つまり何もしなくても、もう動いています。
[スクリーンショット: 01_nginx起動確認.png] systemctl status nginx が active (running) になっている画面を撮ってください。
繋がるか確かめる — 順番が大事
いきなりブラウザで開かないでください。 繋がらなかったときに、原因が絞れなくなります。
内側から外側へ、1段ずつ確かめます。
① VMの中から localhost ← nginx自体が動いているか
② VMの中から 自分のIP ← 外向きに待ち受けているか
③ ホストのブラウザから ← ネットワークとファイアウォール
① VMの中から
HTTP/1.1 200 OK
Server: nginx/1.24.0 (Ubuntu)
200 OK が返れば、nginx は正常です。 ここで失敗するなら、外の話ではありません。systemctl status nginx に戻ります。
curl -Iは「ヘッダーだけ見せろ」という意味です。HTMLの本文が流れてこないので、確認に向いています。
② VMの中から、自分のIPで
ネットワークの回で見た方法です。192.168.x.x のようなアドレスを控えます。
ここまで通れば、nginx は外向きにも応えています。
③ ホストのブラウザから
Windows 側のブラウザで開きます。
http://192.168.226.50/
「Welcome to nginx!」 と出れば成功です。
[スクリーンショット: 02_welcome画面.png] ホストのブラウザに Welcome to nginx! が表示されている画面を撮ってください。
繋がらないときの3つの原因
①で失敗したのか、③で失敗したのかで、見る場所が変わります。
| どこで失敗したか | 原因 | 確認 |
|---|---|---|
| ①で失敗 | nginx が動いていない | systemctl status nginx |
| ①は通るが②で失敗 | 待ち受けアドレスの問題(稀) | ss -tlnp |
| ②は通るが③で失敗 | ファイアウォールかネットワーク方式 | sudo ufw status |
① nginx が動いていない
多いのは「ポート80が既に使われている」です。
LISTEN 0 511 0.0.0.0:80 0.0.0.0:* users:(("nginx",pid=1421,fd=5))
nginx 以外の名前が出たら、それが犯人です。 python3 -m http.server 80 を動かしっぱなしにしていた、というのがありがちです。先に止めてから nginx を起動します。
0.0.0.0:80 は「どのアドレス宛でも80番で受ける」という意味です。ここが 127.0.0.1:80 だと、VMの中からしか繋がりません。
③ ファイアウォール(ufw)
この順路の読者は ufw が active です。 「入れる」のところで Nginx HTTP を許可したはずですが、③で止まったならまずここを疑ってください。
Status: active
To Action From
-- ------ ----
22/tcp ALLOW Anywhere
Nginx HTTP ALLOW Anywhere
Nginx HTTP の行が無ければ、それが原因です。
症状で見分けられます。 ufw が塞いでいるとき、ブラウザは読み込み中のまま待ち続けてタイムアウトします。すぐに「接続が拒否されました」が出るなら、それは ufw ではなく nginx が動いていない(①)ほうです。待たされるか、即断られるかで切り分けてください。
ufw を有効にする前に、必ず OpenSSH を許可してください。
sudo ufw allow OpenSSH sudo ufw enable順番を逆にすると、SSH接続ごと切れて入れなくなります。 VMware のコンソール画面(VMのウィンドウ)からは入れるので復旧できますが、リモートのサーバーで同じことをやると本当に締め出されます。 この順路ではすでに有効にしてあるので、いまやる必要はありません。
③ ネットワーク方式
ufw を確認しても繋がらないなら、VMのネットワーク方式です。
Ubuntu Server を入れた回で書いたとおり、
| 方式 | ホストのブラウザから VM に繋がるか | 注意 |
|---|---|---|
| NAT(この順路の既定) | 繋がる | ホストからは繋がるが、LAN内の別のPCからは繋がらない |
| ブリッジ | 繋がる | LANに直接出るので、社内ネットワークだと機器側で弾かれることがある |
| ホストオンリー | 繋がる | VMがインターネットに出られないので apt install ができない |
3方式ともホストからは繋がるので、これは切り分けには使えません。 ここまで来て駄目なら、IPアドレスを見間違えている可能性がほとんどです。ip a をもう一度確認してください。
特に多いのが、VMを作り直したのに古いIPを開いているケースです。ブラウザのアドレス欄が補完してくれるので気づきにくい。
ファイルはどこにあるか
Welcome ページの実体はここです。
index.nginx-debian.html
設定ファイルはここです。
conf.d fastcgi.conf mime.types nginx.conf sites-available sites-enabled ...
構造はこうなっています。
| 場所 | 役割 |
|---|---|
/etc/nginx/nginx.conf | 本体。全体の設定 |
/etc/nginx/sites-available/ | サイトごとの設定を置く場所 |
/etc/nginx/sites-enabled/ | そのうち「有効にしたもの」(リンクが置かれる) |
/var/www/html/ | 公開するファイルの置き場所 |
sites-availableとsites-enabledが分かれている理由は、設定を消さずに無効化できるようにするためです。sites-enabledにあるのはシンボリックリンク(ディレクトリの回で触れた「別名」)で、実体はsites-availableにあります。
確かめてみます。
lrwxrwxrwx 1 root root 34 Sep 1 10:12 default -> /etc/nginx/sites-available/default
l で始まり、-> が付いています。 これがリンクです。
表示するものを差し替える
Welcome ページのままでは面白くないので、自分のHTMLに差し替えます。
<!DOCTYPE html>
<html lang="ja">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>nginx から配信中</title>
</head>
<body>
<h1>nginx が返しています</h1>
<p>これは /var/www/html/index.html です。</p>
</body>
</html>
保存してブラウザを再読み込みすると、切り替わります。
なぜ sudo が要るのか
drwxr-xr-x 2 root root 4096 Sep 1 10:12 /var/www/html/
権限の回のとおりに読みます。所有者が root、その他は r-x(読めるが書けない)。 だから一般ユーザーでは書き込めません。
毎回 sudo を打つのが面倒なら、自分のホームに置いて設定でそちらを指すほうが健全です。次の回でやります。
index.nginx-debian.htmlは消さなくて大丈夫です。 nginx はindex index.html index.htm index.nginx-debian.html;の順に探すので、index.htmlを置いた時点でそちらが優先されます。
[スクリーンショット: 03_自作ページ.png] 差し替えた自分のページが表示されている画面を撮ってください。
前回の dist/ を、そのまま置く
ビルドツールの回で作った ~/vite-demo/dist/ を、ここに載せます。
あのとき「ビルド成果物はただの静的ファイルなので、置けば動く」と書きました。本物のWebサーバーで確かめます。
戻せるようにしてからやります。
置きます。
-rw-r--r-- index.html
drwxr-xr-x assets
-rw-r--r-- vite.svg
ホストのブラウザで http://192.168.226.50/ を開きます(ポート番号なし=80番)。Vite のページが出れば成功です。
nginx の設定は1文字も変えていません。 置いただけです。reload すら要りません。
Node.js は動いていません。 確かめられます。
ps aux | grep -c "[n]ode"0本番サーバーに Node.js も npm も Vite も要らない、というのはこういう意味です。フロントエンドの「デプロイ」は、
dist/をWebサーバーの置き場にコピーすることでしかありません。
戻します。
~/web/ の素のHTMLでも同じことができます。 置き換えて試してみてください。「素のHTML」も「ビルド成果物」も、nginx から見ればまったく同じ「ただのファイル」です。
設定を壊す前に検査する
ここが、この記事で一番伝えたいことです。
nginx の設定を書き換えたあと、いきなり再起動してはいけません。設定が壊れていると、nginx が起動しなくなり、サイトが止まります。
先に検査します。
正常なら、
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful
わざと壊してみます。
先にバックアップを取ります。壊す前に必ずやってください。
/etc/nginx/sites-available/default を開いて、listen 80 default_server; の行末のセミコロンを1つ消して保存します。
nginx: [emerg] invalid parameter "listen" in /etc/nginx/sites-enabled/default:23
nginx: configuration file /etc/nginx/nginx.conf test failed
sites-enabled/default:23— ファイル名と行番号が出ます。 セミコロンが無いので次の行のlistenまでが1つの命令として読まれ、「listenは不正な引数」と言われています。行番号は環境によって多少ずれます。
これを打たずに再起動していたら、サイトが落ちてから気づくことになります。
戻します。
nginx: configuration file /etc/nginx/nginx.conf test is successful
syntax is ok と test is successful の2行に戻ってから、先に進んでください。 壊れたまま次の節に行くと、何が原因か分からなくなります。
反映するときは restart ではなく reload
| コマンド | 何が起きるか |
|---|---|
restart | 一度止めて、起動し直す(その間は繋がらない) |
reload | 止めずに設定だけ読み直す(接続が切れない) |
設定変更なら reload です。restart が要るのは nginx 自体を入れ替えたときくらいです。
この3つをセットで覚えてください。
壊したときに戻す
設定ファイルを触る前に、必ずコピーを取ってください。
戻すときは、
&& は「前が成功したときだけ次を実行する」です。シェルスクリプトの回で出てきました。検査に失敗したら reload しないので、事故が減ります。
それでも駄目なら、VMのスナップショットに戻せます。 ここが VM で作業している最大の利点です。ホストのWindowsで同じことをやったら、こうはいきません。
動かなくなったらログを見る
別のターミナルからアクセスすると、リアルタイムで流れます。
| ログ | 中身 |
|---|---|
/var/log/nginx/access.log | 誰が何を見に来たか |
/var/log/nginx/error.log | 失敗した理由 |
404 や 403 が出たら、まず error.log です。 「どのファイルを探して見つからなかったのか」がフルパスで書いてあります。
2026/09/01 10:31:02 [error] 1421#1421: *1 open() "/var/www/html/about.html" failed (2: No such file or directory)
推測しなくて済みます。
まとめ
- Webサーバーの仕事は「このURLに来たらこのファイルを返す」だけ。
python3 -m http.serverとの差は、速さ・自動復帰・設定の細かさ apt install nginxは入れた瞬間に起動し、enabledにもなる- 繋がらないときは、内側から外側へ1段ずつ。 ①localhost → ②自分のIP → ③ホストのブラウザ
- 原因は3つ。 nginxが動いていない / ポート80が別のものに使われている / ファイアウォールかネットワーク方式
ss -tlnpで「誰が80番を持っているか」が分かる。0.0.0.0:80なら外向き、127.0.0.1:80なら内側だけ- ufw を有効にする前に、必ず
sudo ufw allow OpenSSH。 逆順は締め出しになる - 設定は
/etc/nginx/sites-available/に書き、sites-enabled/のリンクで有効化する - 公開ファイルは
/var/www/html/。所有者が root なのでsudoが要る sudo nginx -tで検査してからsudo systemctl reload nginx。restartと違い接続が切れない- 触る前に
.bakをコピー。 最後の手段はVMのスナップショット - 困ったら
/var/log/nginx/error.log。 探して失敗したパスがそのまま書いてある
次は、1台のサーバーで複数のサイトを配る方法と、リバースプロキシです。「ポート番号付きのURL」を消す話でもあります。
→ 次の記事: ポート番号を隠す — nginxのリバースプロキシ
VMの中で nginx が動くようになったら、次は本当にインターネットから届く場所で同じことをやると、ufwと「繋がらない」の原因の理解が一段深まります。シンVPS
なら1GB(1コア・30GB)プランが1ヶ月契約で月額750円(税込・2026年9月1日の料金改定後)ですが、無料のお試し期間は無く最低利用期間は3ヶ月なので、まずは手元のVMで手順を固めてからで十分です。
参考リンク
次に読む
この記事は 【第6段階】インフラとコンテナ の 1 / 25 本目です。
| 記事 | |
|---|---|
| ← 前の記事 | 起動しただけでは動き続けない — Backendの到達作品 |
| → 次の記事 | ポート番号を隠す — nginxのリバースプロキシ |
上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。
全体の順路は はじめに にあります。

コメント