unifi-map은(는) 무엇을 하나요?
UniFi 네트워크 토폴로지를 실제 장치 데이터를 사용하여 확대/축소 가능한 벡터 다이어그램과 편집 가능한 draw.io 파일로 내보냅니다.
개요
이 스킬은 UniFi 네트워크 장치(AP, 스위치, 게이트웨이 등)의 실제 데이터를 UniFi 컨트롤러에서 가져와 네트워크 토폴로지를 시각화합니다. 생성된 다이어그램은 SVG 형식으로 확대/축소가 가능하며, draw.io(.drawio) 파일로 내보내 추가 편집이 가능합니다.
주요 기능
- 실시간 데이터 수집: UniFi 컨트롤러 API를 통해 장치 상태 및 연결 정보를 가져옵니다.
- 벡터 다이어그램 생성: 확대/축소가 가능한 SVG 형식의 네트워크 맵을 생성합니다.
- draw.io 호환: 편집 가능한
.drawio파일을 생성하여 draw.io에서 직접 수정할 수 있습니다. - 자동 레이아웃: 장치 간 연결을 자동으로 배치하여 가독성을 높입니다.
사용 방법
# UniFi 컨트롤러에 연결하여 네트워크 맵 내보내기
unifi-map export --controller https://unifi.local --username admin --password secret
요구 사항
- UniFi 컨트롤러 (v5 이상)
- 네트워크 액세스 권한
- Node.js (v14 이상) 또는 Python 3.7+
출력 예시
생성된 다이어그램은 다음과 같은 요소를 포함합니다:
- 게이트웨이 (WAN 연결)
- 스위치 (PoE, 일반)
- 액세스 포인트 (실내/실외)
- 클라이언트 장치 (유선/무선)
라이선스
MIT