본문으로 건너뛰기

macOS 메뉴바 앱v0.1.1

Portress

메뉴바에서 열린 포트를 확인하고 바로 닫습니다.

Portress는 현재 사용자의 TCP 수신 포트(listening port)를 프로세스와 컨테이너 단위로 묶어 macOS 메뉴바 패널에 보여 주는 앱입니다.

포트에서 수신 대기 중인 프로세스를 종료하거나 컨테이너를 멈출 수 있으며 실수를 막기 위해 두 동작 모두 확인 창을 거칩니다. 패널을 닫아 두어도 5초마다 백그라운드에서 스캔하므로 아이콘을 누르면 최신 상태를 바로 볼 수 있습니다.

  • Apple silicon
  • macOS 26 이상
  • 출시
새로 띄운 서버(8765)가 다음 스캔 주기에 목록에 잡히고 확인 창을 거쳐 종료하자 목록에서 사라지는 모습입니다. 데모 서버와 데모 컨테이너만 보이도록 나머지 포트는 무시 목록에 넣어 두고 촬영했습니다.

로컬 개발 서버나 Apple container를 자주 띄우면서 지금 어떤 프로세스가 포트를 잡고 있는지 메뉴바에서 바로 찾아 정리하고 싶을 때 유용합니다.

주요 기능

포트, 프로세스, PID를 한 행에

한 행에 포트 번호, 프로세스나 컨테이너 이름, PID, 바인딩 주소를 나란히 보여 주고 오른편에 복사, 무시, 종료나 정지 버튼을 둡니다. 목록은 일반 프로세스와 컨테이너 두 구역으로 나뉘며 메뉴바 아이콘 옆 숫자만 봐도 현재 열린 포트 수를 바로 알 수 있습니다.

열린 포트 3개(node 두 개와 Python)와 컨테이너 2개(demo-web, demo-mongo)가 보이는 Portress 패널

확인 창을 거치는 프로세스 종료

종료 버튼을 누르면 프로세스 이름과 PID, 닫힐 포트를 확인 창으로 먼저 보여 주며 사용자가 확인해야 SIGTERM을 보냅니다. 신호를 보내기 직전에 PID와 프로세스 시작 시각을 다시 대조해 같은 프로세스일 때만 종료하고 다른 사용자의 프로세스나 PID 1은 거부합니다.

Python(PID 66132)에 SIGTERM을 보낸다는 안내와 취소, 프로세스 종료 버튼이 있는 확인 창

그 밖의 기능

  • 5초 뒤 강제 종료 제안SIGTERM을 보낸 뒤 5초가 지나도 프로세스가 포트를 놓지 않으면 강제 종료 버튼이 나타납니다. 이때도 한 번 더 확인해야 SIGKILL을 보냅니다.
  • 컨테이너 이름으로 보고 정지컨테이너 런타임이 대신 수신 대기하는 포트를 실제 컨테이너 이름으로 보여 주며 확인을 거친 뒤 선택한 컨테이너에 stop 명령만 실행합니다.
  • 검색프로세스 이름, PID, 포트 번호, 주소, 컨테이너 이름으로 목록을 빠르게 좁힙니다.
  • 포트 무시포트 번호 기준으로 숨기면 목록과 메뉴바 개수 표시에서 빠지며 앱을 다시 실행해도 설정이 유지됩니다.
  • 한 줄 복사포트 번호, 프로세스 이름, PID, 컨테이너 이름, 주소를 한 줄 텍스트로 클립보드에 복사합니다.
  • IPv4와 IPv6 합치기한 프로세스가 같은 포트를 IPv4와 IPv6 양쪽으로 열면 한 줄로 합쳐 보여 주고 0.0.0.0과 :: 주소는 * 하나로 간결하게 표시합니다.
  • 컨테이너 런타임 없이도 사용컨테이너 CLI가 없어도 포트 목록 조회와 프로세스 종료 기능은 그대로 쓸 수 있습니다. 앱이 컨테이너 데몬을 임의로 시작하지는 않습니다.
  • 영어와 한국어 화면macOS 시스템 언어 설정에 맞춰 한국어나 영어로 화면을 보여 줍니다.

내려받기와 설치

Homebrew로 설치

brew install --cask ClaudeSeo/tap/portress

직접 설치

  1. .dmg 파일을 내려받아 엽니다.
  2. Portress.app을 응용 프로그램 폴더로 끌어다 놓습니다.
  3. 앱을 실행한 뒤 메뉴바에 나타난 네트워크 아이콘과 포트 개수를 눌러 패널을 엽니다. Dock 아이콘은 생기지 않습니다.

앱 자체의 자동 업데이트 기능은 없습니다. brew upgrade --cask portress 명령을 실행하거나 새 버전의 .dmg 파일로 바꿔 설치합니다.

다른 앱