サーバーとは待ち続けるプログラム — 手で書いて確かめる

サーバーの仕組み。待ち受けるサーバーと端末、往復するリクエストの封筒。

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

サーバーとは、要求が来るまで待ち続けるプログラムです。15行のNode.jsで書いて、その正体を確かめます。

前回: オフラインでも動かす — PWAとService Worker ここから第5段階(バックエンドとデータベース)です。作業場所はVMの中(Ubuntu)です。

第2段階から、繰り返しこう打ってきました。

bash
$ python3 -m http.server 8000 --bind 0.0.0.0

打てば動くので、そのまま使ってきました。 でも、これが何をしているのかは説明していません。

そして「サーバー」という言葉には、たぶん間違ったイメージが付いています。

データセンターに並んでいる、黒くて高そうな機械。

違います。 いま自分のVMの中で動いていたそれも、サーバーです。この回で、その正体を手で確かめます。

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

目次

この記事でわかること

  • サーバーは機械ではなく「終わらないプログラム」だということ
  • Webサーバーがやっていることは4つだけ(掴む・待つ・受ける・返す)
  • 静的と動的の違いが、コードのどこに現れるのか
  • Ctrl + C で消えるものは、まだサーバーではないということ

この記事でやること

  1. netcat で、自分が手でサーバーになる(HTTPを手打ちで返す)
  2. Node.js で15行のWebサーバーを書く
  3. ポートが取り合いになったときの EADDRINUSE を、わざと出して読む
  4. systemd に登録して、再起動しても動き続ける状態にする

先に知る言葉

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

言葉意味
netcat(nc)指定したポートで待って、繋がってきた相手と文字をやりとりするだけの道具。人間が手でサーバーの役をやるために使います。
bind / listenbind は「そのポートを自分のものとして掴む」、listen は「掴んだまま接続を待ち続ける」こと。ss -tlnp に出てくる LISTEN がその状態です。
静的 / 動的静的はディスクにあるファイルをそのまま返すこと。動的はリクエストのたびにプログラムが中身を作って返すこと。
EADDRINUSE「そのポートはもう他のプロセスが掴んでいる」というエラー。ポートは1つのプロセスしか掴めません。
ユニットファイル(.service)systemd に「何を、どう起動して、落ちたらどうするか」を教える設定ファイル。これを置くと自作プログラムも常駐サービスになります。

サーバーとは「終わらないプログラム」

先に結論を書きます。

サーバーとは、ポートを掴んで、終わらずに待ち続けているプログラムのことです。

それ以上でも以下でもありません。やっていることは4つです。

順番やることLinuxの言葉でいうと
①ポートを掴むbind(そのポートを自分のものにする)
②待つlisten(ss -tlnp に出てくるのがこの状態)
③繋がってきたら受けるaccept
④返すwrite して、また②に戻る

②に戻る、というのが重要です。 1回返して終わりなら、それはただのプログラムです。戻って待ち続けるから、サーバーと呼ばれます。

「サーバー」という単語は、3つの違うものを指しています。

使われ方意味例
プログラム待ち続けているプロセスnginx、python3 -m http.server
役割そのプログラムを動かしている機械「あのサーバーが落ちた」
商品ラックに入る形の機械家電量販店で売っている「サーバー」

この記事で扱うのは1行目だけです。 そして、プログラムさえ動けば、機械が何であるかは関係ありません。 いま使っているVMも、レンタルサーバーも、やっていることは同じです。

プロセスとサービスの回で systemctl を触り、ネットワークの回で ss -tlnp を見ました。あれが全部ここに繋がります。

準備 — 3000番を開ける

新しいポートを使うので、いつもどおり開けます。

bash
$ sudo ufw allow 3000/tcp
$ sudo ufw status
Status: active

To                         Action      From
--                         ------      ----
22/tcp                     ALLOW       Anywhere
3000/tcp                   ALLOW       Anywhere

3000/tcp の行が出れば準備完了です。 記事の最後で閉じ方も書きます。

なぜ3000番なのか。 決まりはありません。1024番より大きい番号なら、sudo なしで掴めます(1023番以下は特権が要る、というLinuxの決まりです)。3000番は Node.js の世界で慣習的によく使われるので、それに合わせます。

道具が揃っているか確認します。

bash
$ which nc || sudo apt install -y netcat-openbsd
$ which curl || sudo apt install -y curl
$ node -v

node -v が v22.x.x のように返れば大丈夫です。 返らない場合は npm の回で入れた nvm が読み込まれていないので、いったんログインし直してください。

① 自分が手でサーバーになる

いちばん効くのがこれです。 プログラムを書く前に、人間がサーバーの役をやります。

使うのは netcat(nc)。「指定したポートで待って、繋がってきた相手と文字をやりとりするだけ」の道具です。

VMの中で:

bash
$ nc -l 3000

何も表示されずに止まります。 これが②の「待っている」状態です。別のターミナルで確認できます。

bash
$ sudo ss -tlnp | grep 3000
LISTEN 0  1  0.0.0.0:3000  0.0.0.0:*  users:(("nc",pid=3182,fd=3))

nc がポート3000を掴んで待っています。 ネットワークの回で見た LISTEN そのものです。

ブラウザから話しかけてもらう

ホストの Windows のブラウザで開きます。

http://192.168.226.50:3000/

IPは自分のVMの値に読み替えてください(VMの中で ip a)。

ブラウザはぐるぐる回ったままになります。 そして nc を動かしているターミナルに、こんな文字が流れてきます。

GET / HTTP/1.1
Host: 192.168.226.50:3000
Connection: keep-alive
User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) ...
Accept: text/html,application/xhtml+xml,...
Accept-Encoding: gzip, deflate
Accept-Language: ja,en-US;q=0.9

これがHTTPリクエストの実物です。

DNSとHTTPの回で curl.exe -I を使って返事のほうを見ましたが、今度は送られてくるほうです。ブラウザは、ただのテキストを送っているだけでした。

行意味
GET / HTTP/1.1メソッド(GET)とパス(/)とバージョン
Host:どのドメイン宛か(1つのサーバーが複数サイトを持てる理由)
User-Agent:どのブラウザかを名乗っている
Accept:どの形式なら受け取れるか

ブラウザが待っているのは、この続きです。 相手(=いまのあなた)が返事を書くまで、ぐるぐる回り続けます。

手で返事を書く

nc のターミナルに、そのまま打ち込んでください。

HTTP/1.1 200 OK
Content-Type: text/html; charset=UTF-8

<h1>私が手で返しました</h1>

3行目の空行を、絶対に忘れないでください。

打ち終わったら Ctrl + C で nc を止めます。その瞬間、ブラウザに文字が出ます。

[スクリーンショット: 01_手でHTTPを返す.png] 左に nc のターミナル(ブラウザからのリクエストと、自分が打った返事が両方見えている状態)、右にホストのブラウザ(「私が手で返しました」が表示されている)を並べて撮ってください。

いま何が起きたのか

あなたはWebサーバーでした。 ブラウザから見れば、nginx が返そうが人間が手で打とうが、区別が付きません。

HTTPレスポンスの形は、これだけです。

HTTP/1.1 200 OK          ← ① ステータス行
Content-Type: text/html  ← ② ヘッダー(何行でもよい)
                         ← ③ 空行(ここでヘッダーの終わり)
<h1>本文</h1>            ← ④ 本文

③の空行が、この形の心臓です。 HTTPには「ヘッダーは何行あるか」という情報がありません。空行が来たら終わり、という決まりだけで区切っています。 だから空行を忘れると、相手は「まだヘッダーの途中だ」と思って待ち続けます。 ブラウザが延々とぐるぐる回るのは、これが原因のことがあります。

なぜ Ctrl + C を押すまで表示されなかったのか。 本文がどこで終わるかを伝えていないからです。伝える方法は2つあります。

1. Content-Length: 24 のように長さを先に言う 2. 接続を切って「これで終わり」と示す ← いまやったのはこちら

本物のサーバーは1番を使います。接続を切らずに使い回せるので速いからです(Connection: keep-alive はそのための宣言です)。この判断を毎回やってくれるのが、次に書くライブラリの仕事です。

② Node.js で書き直す

手打ちは1回しか返せません。 ②に戻れないので、まだサーバーではありませんでした。プログラムにします。

bash
$ mkdir -p ~/server
$ cd ~/server
$ nano server.js
const http = require("node:http");

const server = http.createServer((req, res) => {
  console.log(`${req.method} ${req.url}`);

  res.writeHead(200, { "Content-Type": "text/html; charset=UTF-8" });
  res.end("<h1>Node.js が返しています</h1>");
});

server.listen(3000, "0.0.0.0", () => {
  console.log("http://0.0.0.0:3000/ で待っています");
});

動かします。

bash
$ node server.js
http://0.0.0.0:3000/ で待っています

ホストのブラウザで http://192.168.226.50:3000/ を開いてください。 表示されます。そして今度は、何回更新しても返ってきます。

ターミナルには、更新するたびに行が増えます。

GET /
GET /favicon.ico

/favicon.ico は誰も頼んでいないのに来ます。 ブラウザが「タブに出すアイコンをください」と勝手に取りに来るからです。開発者ツールの回の Network タブに出ていたのと同じものです。サーバー側から見ると、こう見えていました。

4つの仕事が、どこに書いてあるか

最初の表と見比べてください。

仕事コードのどこか
① ポートを掴むserver.listen(3000, ...)
② 待つlisten した後、プログラムが終了しないこと自体
③ 受けるcreateServer((req, res) => { ... }) の中が呼ばれる
④ 返すres.writeHead(...) と res.end(...)

res.writeHead が、さっき手で打った「ステータス行とヘッダー」です。 res.end が本文で、空行の挿入と Content-Length の計算は Node.js がやっています。

--bind 0.0.0.0 の話が、ここでも出ます。 server.listen(3000, "0.0.0.0", ...) の "0.0.0.0" を消すか "127.0.0.1" にすると、VMの中からしか繋がりません。 HTMLの回の --bind 0.0.0.0、ビルドツールの回の --host 0.0.0.0 と、まったく同じ設定を、今度は自分で書いています。

sudo ss -tlnp | grep 3000

0.0.0.0:3000 か 127.0.0.1:3000 か。 迷ったら毎回これを見ます。

[スクリーンショット: 02_node_server.png] 左にVMのターミナル(GET / のログが増えていく様子)、右にホストのブラウザ(表示されたページ)を並べて撮ってください。

③ 静的と動的の違いは、ここに出る

python3 -m http.server と、いま書いたものの違いは何か。

server.js を書き換えます。res.end の行だけです。

  res.end(`<h1>いまは ${new Date().toLocaleString("ja-JP")} です</h1>`);

Ctrl + C で止めて、node server.js で立て直します。

ソースを直しても、動いているプロセスには反映されません。 nginx の回の reload と同じで、読み直させる操作が要ります。 Node.js の場合はいったん止めて立て直すのが基本です。

ブラウザを更新するたびに、時刻が変わります。

ここが分かれ目です。

何を返しているか更新すると
静的(python3 -m http.server、nginx)ディスクにあるファイルをそのまま同じものが返る
動的(いま書いたもの)その場で作った文字列毎回違うものが返せる

「バックエンド」と呼ばれているのは、この右側のことです。

  • ログインしている人の名前を出す
  • データベースから商品一覧を引いて並べる
  • フォームで送られた内容を保存する

全部「その場で作って返す」です。やっていることは、いま書いた8行と同じ形をしています。

ビルドツールの回で「dist/ はただの静的ファイル」と書きました。 あれは左側の話です。フロントエンドの成果物は静的で、サーバーが動的。この2つが組み合わさって1つのサイトになります。両方を1つのものだと思っていると、「どこを直せばいいのか」が永遠に分かりません。

パスによって返すものを変える

req.url を見るだけです。

const http = require("node:http");

const server = http.createServer((req, res) => {
  console.log(`${req.method} ${req.url}`);

  if (req.url === "/") {
    res.writeHead(200, { "Content-Type": "text/html; charset=UTF-8" });
    res.end("<h1>トップページ</h1>");
    return;
  }

  if (req.url === "/time") {
    res.writeHead(200, { "Content-Type": "application/json; charset=UTF-8" });
    res.end(JSON.stringify({ now: new Date().toISOString() }));
    return;
  }

  res.writeHead(404, { "Content-Type": "text/plain; charset=UTF-8" });
  res.end("見つかりません\n");
});

server.listen(3000, "0.0.0.0", () => {
  console.log("http://0.0.0.0:3000/ で待っています");
});

立て直して、3つ試してください。

bash
$ curl -i http://localhost:3000/
$ curl -i http://localhost:3000/time
$ curl -i http://localhost:3000/nothing

-i はヘッダーも一緒に出す指定です。3つ目はこうなります。

HTTP/1.1 404 Not Found
Content-Type: text/plain; charset=UTF-8

見つかりません

404 は「エラー」ではありません。 「そのパスは無い」という、正常な返事です。 非同期処理の回で「fetch は404でも例外にならない」と書いたのは、これが理由です。サーバーはきちんと返事をしているので、通信としては成功しています。 いま、その404を出す側に回りました。 res.writeHead(404, ...) と自分で書かない限り、404は出ません。

/time はブラウザでも開いてみてください。 JSONがそのまま表示されます。非同期処理の回で data.json というファイルを置いて fetch しましたが、あれをファイルではなくプログラムが返している状態です。ここから先が API の話になります。

④ ポートは1つのプロセスしか掴めない

わざと壊します。 server.js を動かしたまま、別のターミナルでもう1つ立てます。

bash
$ cd ~/server
$ node server.js
Error: listen EADDRINUSE: address already in use 0.0.0.0:3000
    at Server.setupListenHandle [as _listen2] (node:net:1908:16)

EADDRINUSE = address already in use。「その住所はもう使われている」です。

犯人はこう探します。

bash
$ sudo ss -tlnp | grep 3000
LISTEN 0 511 0.0.0.0:3000 0.0.0.0:* users:(("node",pid=4102,fd=20))

pid=4102 が掴んでいると分かります。プロセスの回でやったとおり、止めるならこれです。

bash
$ kill 4102

これは、この先いちばんよく出会うエラーです。

– Ctrl + C を押したつもりで押せていなかった – バックグラウンドに残っていた(node server.js & と打った) – Docker の回のコンテナが掴んだままだった

「ポート番号を変えて逃げる」は、その場しのぎです。 ss -tlnp で犯人を特定してから止める、を癖にしてください。逃げ続けると、動いているプロセスが何個あるのか誰にも分からなくなります。

⑤ Ctrl + C で消えるものは、まだサーバーではない

ここまでのものには、決定的な問題があります。

  • ターミナルを閉じたら止まる
  • SSHが切れたら止まる
  • VMを再起動したら止まる
  • プログラムが落ちても、誰も起こしてくれない

本物のサーバーは、誰もログインしていなくても動いています。 その仕組みが systemd です。プロセスとサービスの回で systemctl status ssh を見ましたが、今度は自分のプログラムを、そこに登録します。

まず node の絶対パスを調べる

ここが最大の落とし穴です。

bash
$ which node
$ whoami
/home/ユーザー名/.nvm/versions/node/v22.14.0/bin/node
ユーザー名

/usr/bin/node ではありません。 npm の回で nvm を使って、ホームディレクトリの中に入れたからです。

systemd は、あなたのシェルの設定を読みません。 .bashrc に書かれた nvm の設定も、PATH も読みません。まっさらな環境でプログラムを起動します。 だから ExecStart=node server.js と書くと、

Failed at step EXEC spawning node: No such file or directory

で起動しません。「ターミナルでは動くのに、サービスにすると動かない」の原因は、ほぼこれです。 必ず which node の結果を、そのまま貼ってください。

サービスを書く

bash
$ sudo nano /etc/systemd/system/myserver.service
[Unit]
Description=はじめての自作Webサーバー
After=network.target

[Service]
Type=simple
User=ユーザー名
WorkingDirectory=/home/ユーザー名/server
ExecStart=/home/ユーザー名/.nvm/versions/node/v22.14.0/bin/node /home/ユーザー名/server/server.js
Restart=on-failure
RestartSec=3

[Install]
WantedBy=multi-user.target

ユーザー名 と node のバージョンは、さっき調べた自分の値に置き換えてください。

行意味
After=network.targetネットワークが立ち上がってから起動する
User=root ではなく自分の権限で動かす(権限の回の「余計な権限を使わない」)
WorkingDirectory=どこにいる状態で動かすか
ExecStart=何を実行するか。絶対パスで書く
Restart=on-failure落ちたら自動で起こし直す
WantedBy=multi-user.target起動時に自動で開始するグループに入れる

登録して動かす

bash
$ sudo systemctl daemon-reload
$ sudo systemctl enable --now myserver
$ systemctl status myserver
● myserver.service - はじめての自作Webサーバー
     Loaded: loaded (/etc/systemd/system/myserver.service; enabled; preset: enabled)
     Active: active (running) since Wed 2026-09-02 14:20:11 JST; 3s ago
   Main PID: 5210 (node)

active (running) と、Loaded の行の enabled を確認してください。

daemon-reload を忘れると、ファイルを置いても systemd は気づきません。 「書いたのに Unit myserver.service not found と言われる」の原因はこれです。

enable と start の違いはプロセスとサービスの回のとおりです。--now を付けているので、「今すぐ開始」と「次回から自動で開始」を同時にやっています。

ログはこう見ます。

bash
$ journalctl -u myserver -f

-f は「新しい行が出たら流し続ける」という指定です。ブラウザで開くたびに GET / が増えます。Ctrl + C で抜けても、サーバーは止まりません。 ログを見るのをやめただけです。

本当に「終わらない」か確かめる

ここが、この記事の締めです。

bash
$ sudo reboot

VMが再起動します。 SSHが切れるので、30秒ほど待ってから繋ぎ直してください。

そして、何もログインせずに、ホストのブラウザで開いてください。

http://192.168.226.50:3000/

表示されます。 誰もログインしていないのに、プログラムが待ち続けています。

これで「サーバー」になりました。

[スクリーンショット: 03_systemd常駐.png] systemctl status myserver で active (running) と enabled が見えている画面を撮ってください。再起動後の画面であることが分かると、なお良いです。

わざと落として、起き上がるところも見られます。

systemctl show myserver -p MainPID
sudo kill -9 5210
systemctl status myserver

5210 は自分の環境の値に読み替えてください。 3秒後に active (running) に戻っています。Restart=on-failure と RestartSec=3 が効いています。 これが「落ちても勝手に戻る」の正体で、魔法ではなく設定ファイル2行です。

つまずいたところ

症状原因
ブラウザがぐるぐる回ったままnc で空行を忘れた / ufw の 3000番が閉じている
EADDRINUSE前のプロセスが残っている。 ss -tlnp で犯人を探す
ターミナルでは動くのにサービスだと起動しないExecStart が node の絶対パスになっていない(nvm)
Unit myserver.service not founddaemon-reload を忘れている
VMの中の curl は通るのにブラウザから見えないlisten が 127.0.0.1 になっている / ufw

後片づけ

サービスを残しておいても害はありませんが、消すならこうします。

bash
$ sudo systemctl disable --now myserver
$ sudo rm /etc/systemd/system/myserver.service
$ sudo systemctl daemon-reload

開けたポートも閉じます。

bash
$ sudo ufw delete allow 3000/tcp
$ sudo ufw status

~/server/ は残しておいてください。 次の回で、このファイルに手を入れて API にします。

まとめ

  • サーバーは機械ではなく「終わらないプログラム」。 ポートを掴んで、待って、受けて、返して、また待つ
  • HTTPは、ただのテキスト。 nc で手打ちしても、ブラウザは本物のサーバーと区別できない
  • ヘッダーと本文の区切りは空行1つだけ。 忘れるとブラウザは待ち続ける
  • 本文の終わりは「長さを言う」か「接続を切る」で伝える。 ライブラリはこれを代わりにやっている
  • 静的はファイルをそのまま返す、動的はその場で作って返す。 バックエンドと呼ばれているのは後者
  • 404 はエラーではなく正常な返事。 自分で writeHead(404, ...) と書かない限り出ない
  • ポートは1つのプロセスしか掴めない。 EADDRINUSE はポートを変えて逃げず、ss -tlnp で犯人を探す
  • Ctrl + C で消えるものは、まだサーバーではない。 systemd に登録して初めて「動き続ける」
  • systemd はシェルの設定を読まない。 nvm で入れた node は絶対パスで書く
  • Restart=on-failure は設定2行。 「落ちても勝手に戻る」は魔法ではない

この記事の server.js は VM の中からしか見えませんが、インターネットに面したサーバーで同じことをすると、「ポートを掴んで待ち続ける」の意味を外からの接続で確かめられます。さくらのVPSはクレジットカード払いなら全プラン 2 週間無料で試せるので(2026年11月時点)、systemd に登録した Node.js のサーバーを外から curl で叩く練習に使えます。最低利用期間は 3 ヶ月で、解約しないとお試し後に自動で本登録になる点だけ先に確認してください。

参考リンク


次に読む

この記事は 【第5段階】バックエンドとデータベース の 1 / 29 本目です。

記事
← 前の記事オフラインでも動かす — PWAとService Worker
→ 次の記事APIの正体はJSONを返すHTTP — Node.jsで作る

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

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

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

Backend›Internet / Web サーバーの基礎
  • What is HTTP?(リクエストとレスポンスを手で書く)
  • How does the internet work?(ポートと待ち受け)
  • Node.js — 最小のHTTPサーバー

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

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

コメント

コメントする

目次