netalertx/NetAlertX

これは何？

主な機能

• 01arp-scan、Pi-hole、DHCPリース、UniFi、SNMPルーターからのインポートによる継続的なデバイス検出
• 02新規デバイス、接続状態、IPAMの不整合の変化検知
• 03Apprise（80以上のサービス）、Pushover、Pushsafer、NTFY経由の通知
• 04デバイスを自動で分類、グループ化、アーカイブ解除、削除するワークフロー
• 05API、webhook、Home Assistant連携、Prometheusメトリクスのエクスポート

ユースケース

• 自宅やオフィスのネットワーク上にある、許可されていないデバイスやシャドーITの検出
• IPアドレスの変化を追跡し、デバイスインベントリを最新の状態に維持
• 複数の顧客ネットワークや支店のネットワークを一元化されたダッシュボードから監視
• 新しいデバイスがネットワークに接続した際、スマートフォンやチャットアプリに通知

クイックスタート

1. 1

   DockerでNetAlertXを起動する

   docker run -d --network=host --restart unless-stopped --cap-add=NET_RAW --cap-add=NET_ADMIN --cap-add=NET_BIND_SERVICE -v /local_data_dir:/data -v /etc/localtime:/etc/localtime:ro --tmpfs /tmp:uid=20211,gid=20211,mode=1700 -e PORT=20211 -e APP_CONF_OVERRIDE='{"GRAPHQL_PORT":"20214"}' ghcr.io/netalertx/netalertx:latest
2. 2

   または、ソースリポジトリをクローンする

   git clone https://github.com/netalertx/NetAlertX.git
3. 3

   プロジェクトディレクトリに移動し、Docker Composeでビルドする

   cd NetAlertX && docker compose up --force-recreate --build

使う前に知っておきたいこと

• !ネットワークスキャンには、Linux上でコンテナに昇格した権限とホストネットワークが必要です。
• !ARPなどのスキャナーでは、異なるサブネット上のデバイスを検出できない場合があります。
• !Wi-Fiのみのネットワークでは、正確に検出するために別のスキャナーが必要になる場合があります。
• !古いバージョンからアップグレードする場合は、移行ガイドに従ってください。

収録されている特集

トピック

よくある質問

NetAlertX とは？

ネットワーク上のデバイスを継続的に検出し、変化を通知するセルフホスト型のネットワーク可視化ツール。 NetAlertXは、1つ以上のネットワークに接続されたデバイスを追跡するセルフホスト型プラットフォームです。継続的にスキャンして新規デバイスや再接続したデバイスを検出し、接続状態の変化やIPアドレス管理（IPAM）の不整合を検知して、資産の一元管理を行います。検出方法として、arp-scan、Pi-holeやDHCPリースのインポート、UniFiコントローラーからのインポート、SNMP対応ルーターからのインポートがあり、独自のスキャナーを作成できるプラグインシステムも備えています。

NetAlertX は無料で使えますか？ライセンスは？

NetAlertX は GPL-3.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

NetAlertX は今もメンテナンスされていますか？

活発にメンテナンス中。NetAlertX の最終コミットは 2026年11月1日 です。

NetAlertX は何に使えますか？

自宅やオフィスのネットワーク上にある、許可されていないデバイスやシャドーITの検出 IPアドレスの変化を追跡し、デバイスインベントリを最新の状態に維持 複数の顧客ネットワークや支店のネットワークを一元化されたダッシュボードから監視 新しいデバイスがネットワークに接続した際、スマートフォンやチャットアプリに通知

NetAlertX のインストール方法は？

DockerでNetAlertXを起動する: docker run -d --network=host --restart unless-stopped --cap-add=NET_RAW --cap-add=NET_ADMIN --cap-add=NET_BIND_SERVICE -v /local_data_dir:/data -v /etc/localtime:/etc/localtime:ro --tmpfs /tmp:uid=20211,gid=20211,mode=1700 -e PORT=20211 -e APP_CONF_OVERRIDE='{"GRAPHQL_PORT":"20214"}' ghcr.io/netalertx/netalertx:latest または、ソースリポジトリをクローンする: git clone https://github.com/netalertx/NetAlertX.git プロジェクトディレクトリに移動し、Docker Composeでビルドする: cd NetAlertX && docker compose up --force-recreate --build

NetAlertX はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/netalertx/NetAlertX