0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

「EADDRINUSE: address already in use」を一発解決!netstat / ss / lsof の見方とポート競合・ARPテーブルの読み解き方

0
Posted at

はじめに

ローカル開発やサーバー運用をしていると、誰もが何度も遭遇する定番エラーがあります。

Error: listen EADDRINUSE: address already in use :::3000

「Vite や Next.js、Express の開発サーバーを起動しようとしたら、前のプロセスが残っていてポート 3000 が塞がっている」という現象です。
また、同じように現場でよく調べるのが、

  • TIME_WAIT が大量に残っているが、これは放置して大丈夫なのか?
  • 0.0.0.0:8080 で待ち受け(LISTEN)しているプロセスが、外部からアクセス可能な危険な状態になっていないか?
  • arp -a で出てきた同一LAN内の不明なIPアドレスが、どのメーカーの機器なのか特定したい

本記事では、netstat / ss / lsof を使ったポート競合(EADDRINUSE)の特定とPID強制終了コマンドの早見表、および ARPキャッシュの仕組み を整理し、出力結果をそのまま貼り付けるだけで安全に診断できるツールを紹介します。


1. OS別:指定ポートを使っているプロセス(PID)を特定して止める方法

開発中のポート(例:3000 や 8080)が塞がったとき、OSごとの確認&強制終了コマンドは以下の通りです。

🪟 Windows (PowerShell / コマンドプロンプト)

# 1. ポート 3000 を使用しているプロセスの PID(一番右の数字)を調べる
netstat -ano | findstr :3000

# 出力例:
#   TCP    0.0.0.0:3000    0.0.0.0:0    LISTENING    18432

# 2. PID 18432 を強制終了する
taskkill /PID 18432 /F

🍎 macOS

# 1. ポート 3000 を LISTEN している PID を調べる
lsof -i :3000

# 2. PID を指定して強制終了する
kill -9 <PID>

🐧 Linux (Ubuntu / CentOS 等)

最近の Linux 環境では netstat(net-tools)が非推奨となり、より高速な ss コマンドが標準になっています。

# 1. ポート 3000 を待ち受けているプロセスを確認
ss -tulnp | grep :3000

# (netstat を使う場合)
netstat -tulnp | grep :3000

# 2. PID を指定して強制終了する
kill -9 <PID>

2. netstat / ss で必ず見ておきたい「2つの注意点」

出力結果を読み解く際、単なるポート番号だけでなく 「アドレス表記」 と 「ステート(状態)」 に気をつけるとセキュリティ事故や誤判断を防げます。

① 127.0.0.1:3000 と 0.0.0.0:3000 の決定的な違い

バインドアドレス 意味 セキュリティ上の注意点
127.0.0.1:3000 / [::1]:3000 ローカルホスト(自PC内のみ)から接続可能 安全。外部ネットワークからは接続できません
0.0.0.0:3000 / [::]:3000 すべてのネットワークインターフェースから接続可能 開発用サーバーやDBが意図せず 0.0.0.0 で LISTEN していると、同一Wi-FiやLAN上の他端末から丸見えになるリスクがあります

② LISTEN と TIME_WAIT の違い

  • LISTEN(または LISTENING): いま現在、新しい接続を待ち受けているサーバープロセスです。ポート競合(EADDRINUSE)の原因になるのは基本的にこの LISTEN 状態のプロセスです。
  • TIME_WAIT: 通信終了後、ネットワーク上の遅延パケットが迷い込むのを防ぐためにOSが一時的にソケットを予約保持している正常な状態です(通常 60秒〜120秒程度で自動消滅します)。数件〜数十件あっても故障ではありません。

3. arp -a でLAN内の機器・MACアドレス・キャッシュを調べる

同じネットワーク(社内LANや自宅Wi-Fi)上の別端末やサーバーと通信できないとき、L2レベルの解決状況を見るのが arp -a コマンドです。

# Windows / macOS / Linux での出力例
インターフェイス: 192.168.1.10 --- 0x5
  インターネット アドレス      物理アドレス          種類
  192.168.1.1           dc-a6-32-11-22-33     動的
  192.168.1.50          00-15-5d-44-55-66     動的

この「物理アドレス(MACアドレス)」の先頭3バイト(OUI: Organizationally Unique Identifier)を見ることで、そのIPアドレスの正体が特定できます。
たとえば上記の例では:

  • dc-a6-32 ➔ Raspberry Pi Trading
  • 00-15-5d ➔ Microsoft Hyper-V(仮想マシン)

また、ルーターや機器を交換した直後に古いMACアドレスがキャッシュされて通信できなくなった場合は、ARPキャッシュのクリア(Flush)を行います。

# Windows (管理者権限) で ARP キャッシュを初期化
arp -d *
# または
netsh interface ip delete arpcache

4. netstat や arp -a の出力を貼るだけで自動解析できる無料ツールを作りました

大量のソケット一覧から目的のポートや 0.0.0.0 公開警告を探したり、Mac/Windows/Linux ごとの taskkill / kill -9 コマンドを毎回思い出す手間をなくすため、ブラウザ内(外部送信ゼロ)でターミナル出力を即座にパース・診断する『Netstat & ARP Tool』 を開発し、無料で公開しています。

🔗 ツール本体(インストール・登録不要)
👉 Netstat & ARP Tool|Shamoji DRIVE

📖 詳しい仕組み・コマンドチートシート
👉 netstat / ss / lsof / arp 解析ガイド

主な特徴

  1. netstat / ss / lsof 出力の一発パース&検索
    • コマンド出力をそのまま貼り付けるだけで、ローカルポート・外部アドレス・PID・状態(LISTEN / ESTABLISHED / TIME_WAIT)を綺麗なテーブルに構造化します。
  2. 0.0.0.0 外部全公開のセキュリティ警告 & PID強制終了コマンド自動生成
    • 意図せず全インターフェースに公開されているポートを自動ハイライトし、該当PIDを停止する taskkill /PID ... /F や kill -9 ... コマンドをワンクリックでコピーできます。
  3. arp -a テーブル解析 & MACアドレス OUI ベンダー自動推定
    • 貼り付けた ARP テーブルからベンダー名(Apple / Raspberry Pi / VMware / Cisco / Espressif 等)を自動判定し、OS別の ARPキャッシュ解放コマンドも生成します。
  4. 完全ローカル処理(社内IPやサーバー構成情報の外部送信ゼロ)
    • 入力されたログはブラウザ内のJavaScriptだけで解析され、外部サーバーへは1バイトも送信されないため、社内サーバーや本番環境の調査でも安心して使えます。

このほかにも、Shamoji DRIVE DevTools Suite では IP/CIDRサブネット計算、DNS/SPF/DMARC診断、SSL/TLS暗号スイート診断、HTTPセキュリティヘッダー診断など33種類のエンジニア向けツールを公開していますので、ぜひ日々の運用にお役立てください!


📚 関連する技術記事・発信メディア

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?