こんにちは、インフラエンジニアのryuです。
nginx の設定を変えて再起動したら、systemctl status に bind() to 0.0.0.0:80 failed (98: Address already in use) と出てサービスが上がってこない。自作のアプリを起動しようとしたら OSError: [Errno 98] Address already in use で止まった。サーバーを触っていると、こうしたエラーにはよく出会います。
先に答えを書くと、このエラーは同じIPアドレスとポート番号の組み合わせを、すでに別のソケットが使っているという意味です。直し方は、ss -ltnp などで「誰がそのポートを使っているのか」を特定し、その相手を正しい方法で止めるか、自分のほうのポートを変えるかのどちらかになります。
この記事では、エラーの意味を確かめたうえで、ポートを使っているプロセスの調べ方と、よくある原因ごとの直し方を順番に解説します。調べるコマンドの多くは、ほかのユーザーのプロセスまで見るために sudo を使える権限が必要です。
Address already in useは、何が起きているエラーなのか¶
サーバーのプログラムは、通信を待ち受ける前に bind() というシステムコールで「このIPアドレスのこのポートを使います」とOSに申し出ます。そのときに、同じ組み合わせをすでに使っているソケットがあると、OSは EADDRINUSE というエラーを返します。
エラー番号は98で、メッセージは Address already in use です。nginx・Apache・Python・Node.js など、どのプログラムでも中身は同じで、表示のしかたが違うだけです。
| プログラム | 表示の例 |
|---|---|
| nginx | [emerg] bind() to 0.0.0.0:80 failed (98: Address already in use) |
| Apache | (98)Address already in use: AH00072: make_sock: could not bind to address [::]:80 |
| Python | OSError: [Errno 98] Address already in use |
| Node.js | Error: listen EADDRINUSE: address already in use :::3000 |
どの表示にも、ポート番号が入っています。まずはこの番号と、0.0.0.0 や [::] のような待ち受けるアドレスをメモしておいてください。
よく似た別のエラーと区別する¶
ポートまわりでは、よく似た別のエラーも出ます。原因がまったく違うので、メッセージをよく読んで区別しておきます。
| エラー番号 | メッセージ | 意味 |
|---|---|---|
| 98 | Address already in use |
そのアドレスとポートを、すでに誰かが使っている |
| 99 | Cannot assign requested address |
指定したIPアドレスが、そのサーバーに付いていない |
| 13 | Permission denied |
一般ユーザーが1024番より小さいポートを使おうとした、など権限の問題 |
99番は、設定ファイルに古いサーバーのIPアドレスが残っているときによく出ます。ip addr でそのアドレスがサーバーに付いているかを確かめてください。13番は、一般ユーザーで80番や443番を使おうとしたときに出るものです。Linux では、どこからを一般ユーザーが使えるポートにするかを /proc/sys/net/ipv4/ip_unprivileged_port_start で決めていて、既定値は1024です。
この記事で扱うのは98番です。98番であれば、OSから見て「そのポートの持ち主は別にいる」ので、持ち主を探すことから始めます。
ポートを使っているプロセスを調べる¶
ポートの持ち主を調べるコマンドは、主に ss・lsof・fuser の3つです。どれも同じ情報をOSから読んでいるので、手元に入っているものを使えば十分です。
ssで待ち受けているソケットを一覧にする¶
いまの Linux で最初に使うのは ss です。netstat の後継として iproute2 に含まれていて、多くのディストリビューションに最初から入っています。
# TCPで待ち受けているソケットを、番号のまま、プロセス名つきで表示する
sudo ss -ltnp
# 80番だけに絞る
sudo ss -ltnp 'sport = :80'
# UDPのポートを調べるときは -u を使う
sudo ss -lunp 'sport = :53'
オプションの意味は、-l が待ち受け中のソケットだけ、-t が TCP、-n がポート番号を名前に変換しない、-p が使っているプロセスを表示する、です。-p は、ほかのユーザーのプロセスを見るには root の権限が要ります。sudo を付けずに実行すると、Process の列が空のまま出ることがあるので気をつけてください。
結果は次のような形で出ます。説明用の例で、実測ではありません。
State Recv-Q Send-Q Local Address:Port Peer Address:Port Process
LISTEN 0 511 0.0.0.0:80 0.0.0.0:* users:(("nginx",pid=1234,fd=6),("nginx",pid=1233,fd=6))
見るのは Local Address:Port と Process の2つの列です。users:(("nginx",pid=1234,fd=6)) は、プロセス名が nginx で、PIDが1234のプロセスがこのソケットを持っている、という意味です。同じソケットを複数のプロセスが持っていることもよくあり、nginx や Apache では親プロセスと子プロセスが並んで出ます。
Local Address の 0.0.0.0 は、サーバーのすべての IPv4 アドレスで待ち受けていることを表します。[::] はすべての IPv6 アドレスです。IPv6 の待ち受けは設定によって IPv4 の通信も受けることがあるので、0.0.0.0 の行が無くても [::]:80 の行があれば、そちらが持ち主のことがあります。
lsofとfuserで確かめる¶
lsof は、プロセスが開いているファイルを一覧にするコマンドです。Linux ではソケットもファイルの一種として扱われるので、ポートの持ち主も調べられます。
# TCPの8080番で待ち受けているプロセスを表示する
sudo lsof -nP -iTCP:8080 -sTCP:LISTEN
-n と -P は、IPアドレスとポート番号を名前に変換しないためのオプションです。付けないと名前の変換に時間がかかることがあります。手元の環境で Python のプログラムに8080番を待ち受けさせて実行すると、次のように出ました。
COMMAND PID USER FD TYPE DEVICE SIZE/OFF NODE NAME
python3 682 root 3u IPv4 4358 0t0 TCP *:8080 (LISTEN)
COMMAND と PID がポートの持ち主、USER はそのプロセスを動かしているユーザーです。lsof はファイルの上限に当たったときの調査でも使うので、Too many open filesの原因を絞る記事もあわせて読むと使い方の幅が広がります。
fuser は、もっと短く書けるコマンドです。ポート番号/プロトコル の形で指定します。
sudo fuser -v 8080/tcp
同じ環境での出力は次のとおりでした。
USER PID ACCESS COMMAND
8080/tcp: root 682 F.... python3
fuser には、見つけたプロセスにそのままシグナルを送る -k というオプションもあります。ただし、何のプロセスか確かめずに使うと、大事なサービスまで止めてしまうおそれがあります。この記事では、持ち主を確かめるためだけに使うことをおすすめします。
PIDから、そのプロセスの正体を確かめる¶
PIDが分かったら、それが何のプロセスなのかを確かめます。ここを飛ばして kill すると、別のサービスを止めてしまう事故につながります。
# コマンドラインと起動時刻を見る
ps -o pid,ppid,user,lstart,cmd -p 1234
# どのsystemdのユニットに属しているかを見る
systemctl status 1234
systemctl status にPIDを渡すと、そのプロセスがどのサービスの一部として動いているのかが表示されます。systemd の管理下にあれば、ユニット名が分かるので、止めるときも systemctl を使えます。ps の使い方はpsコマンドの使い方で詳しく解説しています。
よくある原因と直し方¶
ポートの持ち主が分かれば、たいてい次の5つのどれかに当てはまります。順番に見ていきます。
前のプロセスが残っている¶
いちばん多いのは、同じプログラムの古いプロセスが残っているケースです。たとえば、systemd を使わずに nginx コマンドを直接実行して起動し、そのあと systemctl start nginx を打つと、先に動いているほうが80番を持っているので起動に失敗します。
この場合、ss で見えるプロセス名は起動しようとしているものと同じ nginx です。systemctl status nginx では failed なのに、ss には nginx が出ている、という食い違いがあれば、このケースを疑ってください。
直すときは、残っているプロセスを本来の止め方で止めます。nginx なら sudo nginx -s quit で、Apache なら apachectl で止めるのが基本です。それでも止まらないときに限り、PIDを確かめたうえで kill を使います。kill のシグナルの違いはkillコマンドの使い方にまとめています。止めたら、今度は systemctl start で起動し直してください。
別のサービスが同じポートを使っている¶
2つ目は、別のサービスが同じポートを使っているケースです。nginx と Apache を同じサーバーに入れて両方とも80番で待ち受けようとした、テスト用に入れたプログラムが8080番を使っていた、といったものです。
この場合、ss に出るプロセス名が、起動しようとしているものと違います。どちらのサービスを80番で動かすのかを決め、もう片方は止めて自動起動を外すか、使うポートを変えます。
# 使わないほうを止めて、次回の起動でも上がらないようにする
sudo systemctl disable --now apache2
どのサービスがどのポートを使うのが一般的かは、ファイアウォール設計で使うポート番号一覧で整理しています。Apache の起動と停止のコマンドはApacheの再起動の方法が参考になります。
systemdのソケットがポートを持っている¶
3つ目は、systemd がプログラムの代わりにポートを持っているケースです。systemd には、ソケットだけを先に開いておき、接続が来たときにサービスを起動する仕組みがあります。この場合、ss の Process の列には systemd と出ます。
身近な例が Ubuntu の SSH です。Ubuntu 22.10 以降では、OpenSSH は既定で ssh.socket によるソケットからの起動を使うようになりました。そのため、sshd_config の Port を変えて ssh.service だけを再起動しても、ポートが変わらないことがあります。Ubuntu の案内では、設定を変えたあとに systemctl daemon-reload を実行し、ssh.socket を再起動する手順が示されています。
systemd が持っているソケットは、次のコマンドで一覧にできます。
# systemdが待ち受けているソケットと、つながるサービスを表示する
systemctl list-sockets
ここに目的のポートがあれば、止めるのはサービスではなく .socket のユニットです。サービスだけを止めても、ソケットのユニットが動いていれば、次の接続でまた起動します。systemd のユニットの読み方は、systemctlとjournalctlで原因を読み解く記事で詳しく解説しています。
Dockerのコンテナがポートを公開している¶
4つ目は、Docker のコンテナがホストのポートを使っているケースです。docker run -p 8080:80 のようにポートを公開すると、ホストの8080番はコンテナのために使われます。既定の設定では、ホスト側で docker-proxy というプロセスがそのポートを持つので、ss にはこの名前が出ます。
# どのコンテナがどのポートを公開しているかを見る
docker ps --format 'table {{.Names}}\t{{.Ports}}'
使っていないコンテナが残っているなら、そのコンテナを止めれば解放されます。docker-proxy のプロセスを直接 kill するのは避けてください。Docker 側の管理とずれてしまいます。コンテナのポートの考え方は、DockerfileのEXPOSEについての記事も参考になります。
自作のアプリを再起動した直後だけ失敗する¶
5つ目は、自分で書いたサーバーのプログラムを止めてすぐに起動し直したときだけ失敗し、しばらく待つと起動できるケースです。このとき ss -ltnp で見ても、そのポートで待ち受けているプロセスはいません。
原因は、止める前のプログラムが使っていた接続が TIME_WAIT の状態でOSに残っていることです。サーバーのプログラムは、ソケットを作るときに SO_REUSEADDR というオプションを付けるのが普通で、これを付けていれば、待ち受けているソケットが無い限り同じポートを使えます。nginx や Apache のような広く使われているサーバーは対応しているので、このケースは主に自作のプログラムで起きます。
確かめるには、待ち受け以外の状態も含めてそのポートを見ます。
# 待ち受け以外の接続も含めて、8080番のTCPの状態を表示する
ss -tan 'sport = :8080'
TIME-WAIT の行だけが並んでいれば、このケースです。プログラム側で SO_REUSEADDR を設定するのが正しい直し方で、OSのパラメータを変えて TIME_WAIT を無理に減らす必要はありません。TCP の接続状態の読み方は、TIME_WAITとCLOSE_WAITを見分ける記事で詳しく解説しています。
直ったかを確かめる¶
持ち主を止めたり、ポートを変えたりしたら、最後に確認します。確かめるのは、サービスが起動していることと、そのサービスが目的のポートを持っていることの2つです。
# サービスが active (running) になっているか
systemctl status nginx
# 80番の持ち主が、目的のサービスになっているか
sudo ss -ltnp 'sport = :80'
# 実際に応答が返るか
curl -I http://127.0.0.1/
ここまで確認できれば、ポートの取り合いは解消しています。サーバーの中では待ち受けているのに外からつながらないときは、ポートの持ち主の問題ではなく、ファイアウォールや経路の問題です。その場合は、ping・ss・tcpdumpで疎通トラブルを層ごとに切り分ける記事の手順で、どこで止まっているのかを調べてください。
また、同じことを繰り返さないように、サービスの起動は systemctl にそろえておくのがおすすめです。手で起動したプロセスと systemd が起動したプロセスが混ざると、今回のような食い違いが起きやすくなります。
Linuxのネットワークとサービス管理を体系的に学び直すなら¶
今回のエラーは、ソケット・プロセス・systemd という3つの知識がつながったところで起きます。どれか1つだけを知っていても、原因まではたどり着きにくい問題です。
InfraAcademy の Linuxのロードマップ では、プロセスの管理・サービスの管理・ネットワークの確認コマンドを、つながりのある順番で学べます。現場で出会ったエラーをきっかけに、土台から整理し直したい人は参考にしてみてください。
まとめ¶
Address already in use は、使おうとしたIPアドレスとポートを、すでに別のソケットが使っているというエラーです。まず sudo ss -ltnp でポートの持ち主を特定し、PIDから何のプロセスなのかを確かめてから対処します。
持ち主は、古いプロセス・別のサービス・systemd のソケット・Docker のコンテナのどれかであることが多く、それぞれ止め方が違います。待ち受けているプロセスがいないのに失敗するなら、TIME_WAIT とプログラムの SO_REUSEADDR を疑ってください。
次にこのエラーが出たら、慌てて再起動を繰り返す前に、sudo ss -ltnp を1回打ってみてください。持ち主が分かれば、直し方はほとんど決まります。



