※本記事はアフィリエイト広告(PR)を含みます。
サーバーとは、要求が来るまで待ち続けるプログラムです。15行のNode.jsで書いて、その正体を確かめます。
前回: オフラインでも動かす — PWAとService Worker ここから第5段階(バックエンドとデータベース)です。作業場所はVMの中(Ubuntu)です。
第2段階から、繰り返しこう打ってきました。
打てば動くので、そのまま使ってきました。 でも、これが何をしているのかは説明していません。
そして「サーバー」という言葉には、たぶん間違ったイメージが付いています。
データセンターに並んでいる、黒くて高そうな機械。
違います。 いま自分のVMの中で動いていたそれも、サーバーです。この回で、その正体を手で確かめます。
対象レベル: 初級〜中級 / 区分: 必修
この記事でわかること
- サーバーは機械ではなく「終わらないプログラム」だということ
- Webサーバーがやっていることは4つだけ(掴む・待つ・受ける・返す)
- 静的と動的の違いが、コードのどこに現れるのか
Ctrl + Cで消えるものは、まだサーバーではないということ
この記事でやること
- netcat で、自分が手でサーバーになる(HTTPを手打ちで返す)
- Node.js で15行のWebサーバーを書く
- ポートが取り合いになったときの
EADDRINUSEを、わざと出して読む - systemd に登録して、再起動しても動き続ける状態にする
先に知る言葉
この記事で初めて出てくる言葉です。 基本的な言葉は用語集にもまとめてあります。
| 言葉 | 意味 |
|---|---|
netcat(nc) | 指定したポートで待って、繋がってきた相手と文字をやりとりするだけの道具。人間が手でサーバーの役をやるために使います。 |
| bind / listen | bind は「そのポートを自分のものとして掴む」、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番を開ける
新しいポートを使うので、いつもどおり開けます。
Status: active
To Action From
-- ------ ----
22/tcp ALLOW Anywhere
3000/tcp ALLOW Anywhere
3000/tcp の行が出れば準備完了です。 記事の最後で閉じ方も書きます。
なぜ3000番なのか。 決まりはありません。1024番より大きい番号なら、
sudoなしで掴めます(1023番以下は特権が要る、というLinuxの決まりです)。3000番は Node.js の世界で慣習的によく使われるので、それに合わせます。
道具が揃っているか確認します。
node -v が v22.x.x のように返れば大丈夫です。 返らない場合は npm の回で入れた nvm が読み込まれていないので、いったんログインし直してください。
① 自分が手でサーバーになる
いちばん効くのがこれです。 プログラムを書く前に、人間がサーバーの役をやります。
使うのは netcat(nc)。「指定したポートで待って、繋がってきた相手と文字をやりとりするだけ」の道具です。
VMの中で:
何も表示されずに止まります。 これが②の「待っている」状態です。別のターミナルで確認できます。
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回しか返せません。 ②に戻れないので、まだサーバーではありませんでした。プログラムにします。
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/ で待っています");
});
動かします。
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つ試してください。
-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つ立てます。
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。「その住所はもう使われている」です。
犯人はこう探します。
LISTEN 0 511 0.0.0.0:3000 0.0.0.0:* users:(("node",pid=4102,fd=20))
pid=4102 が掴んでいると分かります。プロセスの回でやったとおり、止めるならこれです。
これは、この先いちばんよく出会うエラーです。
–
Ctrl + Cを押したつもりで押せていなかった – バックグラウンドに残っていた(node server.js &と打った) – Docker の回のコンテナが掴んだままだった「ポート番号を変えて逃げる」は、その場しのぎです。
ss -tlnpで犯人を特定してから止める、を癖にしてください。逃げ続けると、動いているプロセスが何個あるのか誰にも分からなくなります。
⑤ Ctrl + C で消えるものは、まだサーバーではない
ここまでのものには、決定的な問題があります。
- ターミナルを閉じたら止まる
- SSHが切れたら止まる
- VMを再起動したら止まる
- プログラムが落ちても、誰も起こしてくれない
本物のサーバーは、誰もログインしていなくても動いています。 その仕組みが systemd です。プロセスとサービスの回で systemctl status ssh を見ましたが、今度は自分のプログラムを、そこに登録します。
まず node の絶対パスを調べる
ここが最大の落とし穴です。
/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の結果を、そのまま貼ってください。
サービスを書く
[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 | 起動時に自動で開始するグループに入れる |
登録して動かす
● 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を付けているので、「今すぐ開始」と「次回から自動で開始」を同時にやっています。
ログはこう見ます。
-f は「新しい行が出たら流し続ける」という指定です。ブラウザで開くたびに GET / が増えます。Ctrl + C で抜けても、サーバーは止まりません。 ログを見るのをやめただけです。
本当に「終わらない」か確かめる
ここが、この記事の締めです。
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 found | daemon-reload を忘れている |
VMの中の curl は通るのにブラウザから見えない | listen が 127.0.0.1 になっている / ufw |
後片づけ
サービスを残しておいても害はありませんが、消すならこうします。
開けたポートも閉じます。
~/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 本目です。
上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。
全体の順路は はじめに にあります。
roadmap.sh のどこをやっているか
- What is HTTP?(リクエストとレスポンスを手で書く)
- How does the internet work?(ポートと待ち受け)
- Node.js — 最小のHTTPサーバー
この記事は、上の項目を実際に手を動かして確かめる回です。

コメント