NetCheck – Network Intelligence CLI

네트워크 연결 및 서버 분석

TCP 포트 연결 확인: 특정 호스트의 포트가 열려 있는지 확인할 수 있습니다. CIDR 표기법이나 IP 범위(예: 192.168.1.1-50)를 사용하여 대규모 네트워크를 한 번에 스캔할 수도 있습니다.

DNS 조회 및 HTTP 상태 검사: 도메인의 DNS 레코드(A/AAAA)를 확인하고, 웹 서버의 HTTP/HTTPS 응답 상태, 지연 시간, 리다이렉트 정보를 가져옵니다.

SSL 인증서 검증: 웹사이트의 SSL 인증서 유효성, TLS 버전, 사용된 암호화_suite를 진단합니다.

네트워크 인터페이스 및 공인 IP: 현재 시스템의 네트워크 인터페이스 목록과 공인 WAN IP 주소를 표시합니다.

고급 진단 도구

ICMP 핑 및 트레이스루트: 대상까지의 네트워크 경로와 레이턴시(지연 시간) 통계를 확인합니다. 기본 시스템 명령어나 ICMP 소켓을 활용하여 경로를 추적합니다.

포트 스캔 및 WHOIS 조회: 대상 호스트의 열린 포트와 서비스 이름을 스캔하거나, 도메인/IP의 등록 정보를 WHOIS/RDAP를 통해 조회합니다.

자동화 및 연동

와치 모드(Watch Mode): 모든 서브커맨드에 –watch 옵션을 적용하여 설정한 간격(초)마다 주기적으로 상태를 반복 확인할 수 있습니다.

MCP(Model Context Protocol) 서버: netcheck –mcp 명령어를 실행하면本地 AI 도구 서버로 전환되어 Claude나 ChatGPT 같은 AI 에이전트가 네트워크 상태를 직접 진단할 수 있도록 도구를 제공합니다.

다운로드·설치 방법

NetCheck는 여러 패키지 관리자와 플랫폼별 설치 방식을 지원합니다.

• PyPI (Python): 가장 간편한 설치 방식입니다. pip install netcheckx 명령어로 설치할 수 있습니다.
• Chocolatey (Windows): Windows 사용자는 choco install netcheck 명령어를 사용하여 설치할 수 있습니다.
• 기타 플랫폼: Linux의 경우 Snap Store, Debian(.deb) 패키지, macOS의 경우 .pkg 설치 프로그램을 제공합니다.

기본 사용법

설치 후 모든 명령어는 netcheck 접두사와 함께 사용됩니다. 몇 가지 기본 사용 예시는 다음과 같습니다.

• 도메인 DNS 확인: netcheck dns github.com
• TCP 포트 연결 테스트: netcheck tcp google.com 80,443
• HTTPS 상태 및 지연 시간 확인: netcheck http https://google.com
• SSL 인증서 상세 정보: netcheck ssl google.com -V
• 시스템 네트워크 인터페이스 목록: netcheck interfaces –all –public
• 모든 검사 결과를 JSON 형식으로 출력: netcheck tcp google.com 443 -f json

결과 필터링을 위해 –show success나 –show fail 옵션을 사용하여 성공적이거나 실패한 결과만 별도로 확인할 수 있습니다.

이런 경우에 유용합니다

• 웹 서버나 API 엔드포인트의 연결 상태와 SSL 인증서 만료 여부를 주기적으로 모니터링해야 할 때
• 네트워크 장비나 서버의 특정 포트가 정상적으로 열려 있는지 확인할 때
• 네트워크 문제 발생 시 DNS解析 오류, 레이턴시 문제, 경로 추적을 통해 원인을 파악해야 할 때
• 대규모 IP 대역(CIDR)이나 포트 범위에 대한 동시 다발적인 연결 검증이 필요할 때

지원 환경·시스템 요구사항

Python 3.8 이상이 설치된 Windows, Linux, macOS 환경에서 모두 동일하게 작동합니다. 외부 패키지 의존성이 전혀 없는 순수 Python 라이브러리로 구성되어 있어 추가적인 설치 과정 없이 즉시 사용할 수 있습니다.