netalertx/NetAlertX

어떤 프로젝트인가요?

핵심 기능

• 01arp-scan, Pi-hole, DHCP 임대 정보, UniFi 및 SNMP 라우터 가져오기를 통한 지속적인 기기 탐지
• 02새 기기, 연결 상태 및 IPAM 불일치 변경 감지
• 03Apprise(80개 이상 서비스), Pushover, Pushsafer, NTFY를 통한 알림
• 04기기를 자동으로 분류, 그룹화, 보관 해제 또는 삭제하는 워크플로
• 05API, 웹훅, 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는 하나 이상의 네트워크에 연결된 기기를 추적하는 셀프 호스팅 플랫폼입니다. 지속적으로 스캔해 새 기기와 다시 연결된 기기를 찾고, 연결 상태 변경과 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