🔍 네트워크 스캐너 및 알림 프레임워크 Net Alert X 설치하기
안녕하세요. 달소입니다.
앞서 소개해드린 네트워크 스캐너를 직접 Linux 서버에 구축해보겠습니다.
🔍 네트워크 스캐너 및 알림 프레임워크 Net Alert ...[서버 구축(Self-Hosted)] 달소 2024.08.30 안녕하세요. 달소입니다.어제 Netbox를 소개해드리면서 이전에 썼던 pi-alert도 함께 소개해드렸...
이런 스캐너를 구축했을때의 이점은
홈 네트워크 환경에서 어떤 기기들이 있는지 식별할 수 있고 ip 사용에 대해서 확인할 수 있으며
포트스캔을 통해서 인지하지못한 서비스가 오픈되었을때 즉각적으로 확인이 가능합니다.
설치환경
OS : Ubuntu 24.04 LTS
Docker 설치
Net Alert X 컨테이너 생성하기
mkdir -p /opt/stacks/NetAlertX
cd /opt/stacks/NetAlertX
vi compose.ymlservices:
netalertx:
container_name: NetAlertX
hostname: NetAlertX
privileged: true
# use the below line if you want to test the latest dev image
# image: "jokobsk/netalertx-dev:latest"
image: jokobsk/netalertx:latest
environment:
- TZ=Asia/Seoul
restart: always
volumes:
- ./netalertx/db:/app/db
- ./netalertx/config:/app/config
network_mode: host
그리고 docker compose up -d 로 실행시켜주면 됩니다.
네트워크모드가 host이기때문에 별도로 포트매핑을 진행하지않았고 기본포트는 20221입니다.
ip:20211로 접근해주세요.
이전에 소개해드렸던 pi alert과 거의 비슷한 UI 입니다.
기본 로그인은 비활성화 되어있는데 Settings -> System -> Set Password 에서 설정가능합니다.
보안을 위해서는 설정을 추천드립니다.
Net Alert X는 주기적으로 스캔을 돌아서 내부 네트워크를 스캔합니다.
기본 스캐너 설정
설정에서 인터페이스도 미리 확인해주세요.
기본이 eth0으로 되어있는데 ubuntu 24 기준으로는 ens18이 기본입니다.
기본적으로 플러그인으로 동작하는 기능들이 많은데요.
사용 가능한 플러그인
NetAlertX/front/plugins at main · jokob-sk/NetAlertXgithub.com🖧🔍 WIFI / LAN intruder detector. Scans for devices connected to your network and alerts you if new and unknown devices are found. - jokob-sk/NetAlertX
아래 항목들에 대해서 편하게 설치가 가능합니다.
장치 감지 플러그인은 CurrentScan데이터베이스 테이블에 값을 삽입합니다. 필요하지 않은 플러그인은 무시해도 되지만, ARPSCAN또는 와 같은 일부 장치 감지 플러그인을 활성화하는 것이 합리적입니다 NMAPDEV.
| ID | 유형 | 설명 | 특징 | 필수의 | 데이터 소스 | 자세한 문서 |
|---|---|---|---|---|---|---|
| APPRISE | ▶️ | Apprise 알림 프록시 | 스크립트 | _출판사_광고 | ||
| ARPSCAN | 🔍 | 현재 네트워크의 ARP 스캔 | 스크립트 | arp_스캔 | ||
| CSVBCKP | ⚙ | CSV 장치 백업 | 스크립트 | csv_백업 | ||
| DBCLNP | ⚙ | 데이터베이스 정리 | 예* | 스크립트 | db 정리 | |
| DDNS | ⚙ | DDNS 업데이트 | 스크립트 | ddns_업데이트 | ||
| DHCPLSS | 🔍/📥 | DHCP 임대에서 장치 가져오기 | 스크립트 | dhcp_리스 | ||
| DHCPSRVS | ♻ | DHCP 서버 | 스크립트 | dhcp_서버 | ||
| INTRNT | 🔍 | 인터넷 IP 스캐너 | 스크립트 | 인터넷_아이피 | ||
| INTRSPD | ♻ | 인터넷 속도 테스트 | 스크립트 | 인터넷 속도 테스트 | ||
| MAINT | ⚙ | 원목 등의 유지관리 | 스크립트 | 유지 | ||
| MQTT | ▶️ | Home Assistant와 동기화하기 위한 MQTT | 스크립트 | _게시자_mqtt | ||
| NBTSCAN | ♻ | Nbtscan(NetBIOS 기반) 이름 확인 | 스크립트 | nbtscan_스캔 | ||
| NEWDEV | ⚙ | 새로운 장치 템플릿 | 예 | 주형 | newdev_template | |
| NMAP | ♻ | Nmap 포트 스캐닝 및 검색 | 스크립트 | nmap_스캔 | ||
| NMAPDEV | 🔍 | 현재 네트워크의 Nmap dev 스캔 | 스크립트 | nmap_dev_scan | ||
| NSLOOKUP | ♻ | NSLookup(DNS 기반) 이름 확인 | 스크립트 | nslookup_스캔 | ||
| NTFPRCS | ⚙ | 알림 처리 | 예 | 주형 | 알림 처리 | |
| NTFY | ▶️ | NTFY 알림 | 스크립트 | _출판사_ntfy | ||
| OMDSDN | 📥 | OMADA TP-Link 가져오기 | 🖧 🔄 | 스크립트 | 오마다_SDN_임프 | |
| PHOLUS | ♻ | Pholus 이름 해결 | 스크립트 | 포루스_스캔 | ||
| PIHOLE | 🔍/📥 | Pi-hole 장치 가져오기 및 동기화 | SQLite DB | 파이홀스캔 | ||
| PUSHSAFER | ▶️ | Pushsafer 알림 | 스크립트 | _게시자_푸시세이퍼 | ||
| PUSHOVER | ▶️ | 푸시오버 알림 | 스크립트 | _게시자_푸시오버 | ||
| SETPWD | ⚙ | 비밀번호 설정 | 예 | 주형 | 비밀번호 설정 | |
| SMTP | ▶️ | 이메일 알림 | 스크립트 | _게시자_이메일 | ||
| SNMPDSC | 🔍/📥 | SNMP 장치 가져오기 및 동기화 | 스크립트 | SNMP_발견 | ||
| SYNC | 🔍/⚙/📥 | NetAlertX 인스턴스에서 동기화 및 가져오기 | 🖧 🔄 | 스크립트 | 동조 | |
| UNDIS | 🔍/📥 | 더미 장치 생성 | 스크립트 | 발견할 수 없는 것들 | ||
| UNFIMP | 🔍/📥 | UniFi 장치 가져오기 및 동기화 | 🖧 | 스크립트 | 유니파이_임포트 | |
| VNDRPDT | ⚙ | 공급업체 데이터베이스 업데이트 | 스크립트 | 공급업체 업데이트 | ||
| WEBHOOK | ▶️ | 웹훅 알림 | 스크립트 | _게시자_웹훅 | ||
| WEBMON | ♻ | 웹사이트 다운 모니터링 | 스크립트 | 웹사이트 모니터 |
설정 -> core 부분에서 플러그인을 가져올수 있는데 Ctrl을 누르고 선택해주시면됩니다.
저는 nmap, webhook정도를 추가로 로드했습니다.
디스코드 알람추가하기
위에서 추가한 웹훅 플러그인을 사용해서 디스코드 웹훅알람을 구성할 수 있습니다.
먼저 디스코드에서 웹훅 url을 복사해주시고
다시 Net Alert X의 설정 -> Publishers 항목에 가서 webhook을 추가해줍니다.
비슷하게 nmap도 설정에서 스캔해주시면 기기에서 열려있는 포트를 식별가능합니다.
저는 일단 30개정도 스캔해주네요 ㅎㅎ
기기가 추가되면 리포트도 보내줍니다.
이름을 못가져와서 수동등록 해야할것같기도..
