nginxを入れたのに繋がらない — Webサーバーの導入

nginxでWebサーバー導入。サーバーとWebブラウザ、接続を確認する虫眼鏡。

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

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

DevOps›What is and how to setup — Web Servers
  • 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 の設定ファイルがどこにあり、どういう構造か
  • 設定を壊したときに、反映される前に気づく方法

この記事でやること

  1. VM に nginx を入れる
  2. VMの中から → ホストのブラウザから、の順に繋がるか確かめる
  3. 繋がらないときの3つの原因を順に潰す
  4. 表示するファイルを自分のものに差し替える
  5. 設定を検査してから反映する、という習慣を作る

先に知る言葉

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

言葉意味
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.servernginx
用途動作確認用本番
同時アクセス少しならさばける(Python 3.7 以降はスレッドで並行処理。本番の負荷は想定していない)数千を同時にさばける
停止したら終わり自動で再起動する(systemd)
設定ほぼ無いURLごとに細かく決められる
HTTPS非対応対応

「遅くて、落ちたら終わりで、設定できない」 のが http.server です。学習の入口としては良いのですが、それ以上には使えません。

入れる

bash
$ sudo apt update
$ sudo apt install nginx

aptの回で書いたとおり、apt update は「一覧の更新」で、これ自体は何もアップグレードしません。 入れる前に必ず打ちます。

続けて 80番を開ける

入れた直後にこれをやります。飛ばすと、このあとの「③ ホストのブラウザから」で必ず止まります。

Ubuntu Server の初期設定で ufw を有効(22番だけ許可) にしてあるので、いまのVMは 80番を塞いでいます。

bash
$ sudo ufw app list
Available applications:
  Nginx Full
  Nginx HTTP
  Nginx HTTPS
  OpenSSH

nginx を入れると、この一覧に Nginx が追加されます。 番号ではなく名前で許可できます。

bash
$ sudo ufw allow 'Nginx HTTP'
$ sudo ufw status
Status: active

To                         Action      From
--                         ------      ----
22/tcp                     ALLOW       Anywhere
Nginx HTTP                 ALLOW       Anywhere

Nginx HTTP の行が出れば準備完了です。

名前開くポート
Nginx HTTP80番だけ(今回はこれ)
Nginx HTTPS443番だけ
Nginx Full80番と443番の両方

まだ https は設定していないので Nginx HTTP で十分です。 使っていないポートは開けません。

入ったか確かめる

bash
$ nginx -v
nginx version: nginx/1.24.0 (Ubuntu)

バージョンが出れば入っています。

動いているか確かめる

入っていることと、動いていることは別です。 systemdの回でやったとおりに見ます。

bash
$ systemctl status nginx
● 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の中から

bash
$ curl -I http://localhost/
HTTP/1.1 200 OK
Server: nginx/1.24.0 (Ubuntu)

200 OK が返れば、nginx は正常です。 ここで失敗するなら、外の話ではありません。systemctl status nginx に戻ります。

curl -I は「ヘッダーだけ見せろ」という意味です。HTMLの本文が流れてこないので、確認に向いています。

② VMの中から、自分のIPで

bash
$ ip a | grep inet

ネットワークの回で見た方法です。192.168.x.x のようなアドレスを控えます。

bash
$ curl -I http://192.168.226.50/

ここまで通れば、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が既に使われている」です。

bash
$ sudo ss -tlnp | grep :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 を許可したはずですが、③で止まったならまずここを疑ってください。

bash
$ sudo ufw status
Status: active

To                         Action      From
--                         ------      ----
22/tcp                     ALLOW       Anywhere
Nginx HTTP                 ALLOW       Anywhere

Nginx HTTP の行が無ければ、それが原因です。

bash
$ sudo ufw allow '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 ページの実体はここです。

bash
$ ls /var/www/html/
index.nginx-debian.html

設定ファイルはここです。

bash
$ ls /etc/nginx/
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 にあります。

確かめてみます。

bash
$ ls -l /etc/nginx/sites-enabled/
lrwxrwxrwx 1 root root 34 Sep  1 10:12 default -> /etc/nginx/sites-available/default

l で始まり、-> が付いています。 これがリンクです。

表示するものを差し替える

Welcome ページのままでは面白くないので、自分のHTMLに差し替えます。

bash
$ sudo nano /var/www/html/index.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 が要るのか

bash
$ ls -ld /var/www/html/
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サーバーで確かめます。

戻せるようにしてからやります。

bash
$ sudo cp -r /var/www/html /var/www/html.bak

置きます。

bash
$ sudo rm -rf /var/www/html/*
$ sudo cp -r ~/vite-demo/dist/* /var/www/html/
$ ls -la /var/www/html/
-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サーバーの置き場にコピーすることでしかありません。

戻します。

bash
$ sudo rm -rf /var/www/html
$ sudo mv /var/www/html.bak /var/www/html

~/web/ の素のHTMLでも同じことができます。 置き換えて試してみてください。「素のHTML」も「ビルド成果物」も、nginx から見ればまったく同じ「ただのファイル」です。

設定を壊す前に検査する

ここが、この記事で一番伝えたいことです。

nginx の設定を書き換えたあと、いきなり再起動してはいけません。設定が壊れていると、nginx が起動しなくなり、サイトが止まります。

先に検査します。

bash
$ sudo nginx -t

正常なら、

nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

わざと壊してみます。

先にバックアップを取ります。壊す前に必ずやってください。

bash
$ sudo cp /etc/nginx/sites-available/default /etc/nginx/sites-available/default.bak

/etc/nginx/sites-available/default を開いて、listen 80 default_server; の行末のセミコロンを1つ消して保存します。

bash
$ sudo nano /etc/nginx/sites-available/default
$ sudo nginx -t
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 は不正な引数」と言われています。行番号は環境によって多少ずれます。

これを打たずに再起動していたら、サイトが落ちてから気づくことになります。

戻します。

bash
$ sudo cp /etc/nginx/sites-available/default.bak /etc/nginx/sites-available/default
$ sudo nginx -t
nginx: configuration file /etc/nginx/nginx.conf test is successful

syntax is ok と test is successful の2行に戻ってから、先に進んでください。 壊れたまま次の節に行くと、何が原因か分からなくなります。

反映するときは restart ではなく reload

bash
$ sudo systemctl reload nginx
コマンド何が起きるか
restart一度止めて、起動し直す(その間は繋がらない)
reload止めずに設定だけ読み直す(接続が切れない)

設定変更なら reload です。restart が要るのは nginx 自体を入れ替えたときくらいです。

この3つをセットで覚えてください。

bash
$ sudo nano /etc/nginx/sites-available/default   # 直す
$ sudo nginx -t                                  # 検査する
$ sudo systemctl reload nginx                    # 反映する

壊したときに戻す

設定ファイルを触る前に、必ずコピーを取ってください。

bash
$ sudo cp /etc/nginx/sites-available/default /etc/nginx/sites-available/default.bak

戻すときは、

bash
$ sudo cp /etc/nginx/sites-available/default.bak /etc/nginx/sites-available/default
$ sudo nginx -t && sudo systemctl reload nginx

&& は「前が成功したときだけ次を実行する」です。シェルスクリプトの回で出てきました。検査に失敗したら reload しないので、事故が減ります。

それでも駄目なら、VMのスナップショットに戻せます。 ここが VM で作業している最大の利点です。ホストのWindowsで同じことをやったら、こうはいきません。

動かなくなったらログを見る

bash
$ sudo tail -f /var/log/nginx/error.log

別のターミナルからアクセスすると、リアルタイムで流れます。

ログ中身
/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のリバースプロキシ

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

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

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

コメント

コメントする

目次