kport – Port Inspector and Killer

프로그램 소개/무엇인지

kport는 크로스플랫폼 포트 검사 및 프로세스 종료 도구로, 특정 포트를 사용하는 프로세스를 찾아보고 종료할 수 있습니다. Python 3.8 이상에서 동작하며, Windows, Linux, macOS를 지원합니다. 개발자 및 시스템 관리자가 포트 충돌을 해결하거나 불필요한 프로세스를 정리할 때 유용합니다.

주요 기능

포트 검사 및 프로세스 종료

kport는 특정 포트를 사용하는 프로세스를 검사하고, 여러 포트 또는 포트 범위를 동시에 검사할 수 있습니다. 또한 프로세스 이름으로 포트를 검색하거나, 모든 리스닝 포트를 목록으로 볼 수 있습니다.

Docker 인식 기능

Docker 컨테이너에서 게시된 포트를 감지하고, 호스트 프로세스가 보이지 않더라도 Docker 관련 포트 충돌을 분석할 수 있습니다.

안전 쉴드 (Safety Shield)

SSH(22), DNS(53), HTTP(80), HTTPS(443), 데이터베이스 포트 등 중요한 시스템 포트와 systemd, docker, sshd 등 중요한 프로세스를 기본적으로 보호하여 실수로 인한 종료를 방지합니다. 필요 시 –bypass-safety 플래그로 우회할 수 있습니다.

Watch Mode

실시간으로 포트를 모니터링하여 새로운 연결이 생기면 자동으로 프로세스를 종료할 수 있습니다. polling 간격 조정 및 JSON 출력, dry-run 모드도 지원합니다.

MCP 서버 (AI Agent Integration)

kport를 MCP 서버로 실행하여 Claude, Copilot, Cursor 등의 AI 어시스턴트가 포트를 검사하고 종료할 수 있도록 stdio 전송으로 Model Context Protocol을 제공합니다.

대화형 TUI 피커

kport -I 또는 kport interactive 명령으로 시각적 터미널 사용자 인터페이스를启动하여 퍼지 검색, 다중 선택, 배치 종료 등을 수행할 수 있습니다.

다운로드·설치 방법

Windows에서는 GitHub Releases에서 kport-setup.exe를 다운로드하여 실행하면 PATH에 자동으로 추가됩니다. 또한 pip를 통해 pip install –user kport 로 설치할 수 있으며, 소스에서 직접 설치하려면 git clone 후 pip install –user . 를 실행합니다.

기본 사용법/명령어

포트 검사: kport inspect 8080
포트 종료: kport kill 8080
모든 포트 목록 보기: kport list
Docker 포트 보기: kport docker
포트 충돌 감지: kport conflicts
Watch Mode 실행: kport watch 8080
MCP 서버 시작: kport –mcp
대화형 모드 실행: kport -I
도움말 보기: kport -h
버전 확인: kport -v

이런 경우에 유용합니다

개발 중 포트가 이미 사용 중인 경우, kport를 사용하여 해당 포트를 사용하는 프로세스를 빠르게 찾아 종료할 수 있습니다. 특히 Node.js, Python, Java 등 개발 서버를 자주 재시작하는 상황에서 유용합니다. Docker 환경을 사용할 때는 컨테이너와 호스트 간의 포트 충돌을 감지하고 해결하는 데 도움이 됩니다. 시스템 관리자는 중요한 서비스가 실수로 종료되지 않도록 안전 쉴드를 의지하면서도, 필요한 경우 특정 포트를 강제로 정리할 수 있습니다.

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

Windows, Linux, macOS에서 실행 가능하며, Python 3.8 이상이 필요합니다. Windows에서는 관리자 권한이 필요한 경우도 있으며, Linux/macOS에서는 일부 시스템 포트 접근을 위해 sudo가 필요할 수 있습니다. 기본적으로 Python 표준 라이브러리만 사용하지만, psutil 설치를 통해 더 풍부한 프로세스 정보를 얻을 수 있습니다.

최신 버전·업데이트

현재 버전은 5.1.0이며, GitHub Releases 페이지에서 최신 실행 파일과 패키지를 확인할 수 있습니다. 업데이트는 GitHub에서 소스를 다시 클론하거나 pip install –upgrade kport 를 통해 수행할 수 있습니다.

제한 사항·확인 사항

포트 번호는 1부터 65535 사이여야 하며, 일부 시스템 포트나 프로세스는 기본 안전 쉴드에 의해 보호됩니다. Linux에서 특정 시스템 서비스의 포트는 권한 부족으로 PID가 표시되지 않을 수 있으며, 이 경우 sudo -E kport inspect 와 같이 환경 변수를 유지한 상태에서 실행해야 합니다. Windows에서는 색상 출력이 Windows 10 이상에서 정상 작동하며, 이전 버전에서는 색상이 표시되지 않을 수 있습니다.