dsgnr/portchecker.io

어떤 프로젝트인가요?

핵심 기능

• 01호스트 이름이나 IP 주소의 TCP 포트에 연결할 수 있는지 확인합니다.
• 02/docs에서 문서화된 경로를 제공하는 REST API를 지원합니다.
• 03Nginx가 제공하는 웹 UI를 포함합니다.
• 04사전 빌드 이미지와 Docker Compose 파일을 사용해 Docker에서 실행할 수 있습니다.
• 05API 모니터링을 위한 Prometheus 메트릭 엔드포인트를 제공합니다.
• 06필요에 따라 사설 IP 대역에 대한 검사를 허용할 수 있습니다.

활용 사례

• 방화벽 규칙을 변경한 뒤 서비스 포트가 열려 있는지 확인합니다.
• 네트워크 외부에서 서버 포트가 의도한 대로 노출되는지 확인합니다.
• REST API를 통해 스크립트나 모니터링 시스템에 포트 검사를 연동합니다.
• 자체 인프라에서 포트 검사기를 직접 호스팅합니다.

빠른 시작

1. 1

   Docker Compose로 프로덕션 스택을 시작합니다(프런트엔드는 포트 8080, API는 포트 8000).

   docker-compose up

사용 전 알아둘 점

• !GPL-3.0 라이선스가 적용됩니다. 카피레프트 라이선스이므로 파생물도 동일한 조건으로 오픈소스화해야 합니다.
• !독립 개발에는 Python 3.13과 Poetry, Node 26 이상이 필요하므로 Docker를 사용하는 편이 더 간편합니다.

포함된 컬렉션

토픽

자주 묻는 질문

portchecker.io은(는) 무엇인가요?

Litestar 기반의 오픈소스 TCP 포트 검사기로, REST API와 웹 UI를 제공하며 Docker로 직접 호스팅할 수 있습니다. portchecker.io는 지정한 호스트 이름이나 IP 주소에서 TCP 포트에 연결할 수 있는지 확인합니다. 네트워크 설정을 문제 해결하거나 방화벽 규칙을 확인하고, 외부에 노출된 포트를 파악할 때 유용합니다.

portchecker.io은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

portchecker.io은(는) GPL-3.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

portchecker.io은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. portchecker.io의 마지막 커밋은 2026년 11월 1일입니다.

portchecker.io은(는) 어디에 사용할 수 있나요?

방화벽 규칙을 변경한 뒤 서비스 포트가 열려 있는지 확인합니다. 네트워크 외부에서 서버 포트가 의도한 대로 노출되는지 확인합니다. REST API를 통해 스크립트나 모니터링 시스템에 포트 검사를 연동합니다. 자체 인프라에서 포트 검사기를 직접 호스팅합니다.

portchecker.io는 어떻게 설치하나요?

Docker Compose로 프로덕션 스택을 시작합니다(프런트엔드는 포트 8080, API는 포트 8000).: docker-compose up

portchecker.io은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/dsgnr/portchecker.io