Repolode
Enviar
dsgnr

dsgnr/portchecker.io

Verificador TCP de portas open source com REST API e interface web, que pode ser hospedado por conta própria via Docker e é baseado em Litestar.

Ver no GitHubSite
Estrelas
198
Forks
10
Issues abertas
1
Último commit
há 5 dias

O que é?

portchecker.io verifica se uma porta TCP está acessível em um hostname ou endereço IP. É útil para solucionar problemas de configuração de rede, verificar regras de firewall e conferir quais portas estão expostas à internet.

O projeto tem duas partes: um front-end estático em React servido pelo Nginx e uma API em Python, criada com Litestar e executada no gunicorn com workers do uvicorn. Cada parte pode ser executada separadamente durante o desenvolvimento ou ambas podem ser iniciadas juntas com Docker Compose, usando imagens pré-compiladas publicadas no GitHub Container Registry.

Por padrão, a API se recusa a verificar endereços IP privados das faixas de uso especial da IANA; a opção ALLOW_PRIVATE permite habilitar essas verificações. A API também oferece um endpoint Prometheus /metrics com tempos de resposta e códigos de status, além de incluir testes smoke e testes de navegador com Playwright no CI.

Recursos principais

  • 01Verifica a disponibilidade de portas TCP em qualquer hostname ou endereço IP.
  • 02Oferece uma REST API com rotas documentadas em /docs.
  • 03Inclui uma interface web servida pelo Nginx.
  • 04É executado no Docker, com imagens pré-compiladas e arquivos do Docker Compose.
  • 05Oferece um endpoint de métricas do Prometheus para monitorar a API.
  • 06Pode permitir verificações em faixas de IP privadas, se configurado.

Casos de uso

  • Verificar se a porta de um serviço está aberta após alterar regras de firewall.
  • Confirmar, de fora da rede, se as portas de um servidor estão expostas como esperado.
  • Integrar verificações de portas a scripts ou ao monitoramento por meio da REST API.
  • Hospedar um verificador de portas na sua própria infraestrutura.

Início rápido

  1. 1

    Inicie a stack de produção com Docker Compose (frontend na porta 8080 e API na porta 8000).

    docker-compose up

Antes de usar

  • Licenciado sob GPL-3.0, uma licença copyleft que exige que trabalhos derivados sejam disponibilizados como código aberto nos mesmos termos.
  • O desenvolvimento sem Docker exige Python 3.13 com Poetry e Node 26 ou superior, então usar Docker é mais simples.

Em coleções

Apps auto-hospedados

Tópicos

#port-scanner#tcp#networking#self-hosted#docker#rest-api#firewall#api#devops#docker-compose

Perguntas frequentes

O que é portchecker.io?
Verificador TCP de portas open source com REST API e interface web, que pode ser hospedado por conta própria via Docker e é baseado em Litestar. portchecker.io verifica se uma porta TCP está acessível em um hostname ou endereço IP. É útil para solucionar problemas de configuração de rede, verificar regras de firewall e conferir quais portas estão expostas à internet.
portchecker.io é gratuito? Qual é a licença?
portchecker.io é open source sob a licença GPL-3.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
portchecker.io ainda é mantido?
Manutenção ativa. O último commit de portchecker.io foi em 1 de nov. de 2026.
Para que posso usar portchecker.io?
Verificar se a porta de um serviço está aberta após alterar regras de firewall. Confirmar, de fora da rede, se as portas de um servidor estão expostas como esperado. Integrar verificações de portas a scripts ou ao monitoramento por meio da REST API. Hospedar um verificador de portas na sua própria infraestrutura.
Como instalar portchecker.io?
Inicie a stack de produção com Docker Compose (frontend na porta 8080 e API na porta 8000).: docker-compose up
Onde consigo portchecker.io?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/dsgnr/portchecker.io

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados