Repolode
Enviar
dsgnr

dsgnr/portchecker.io

Comprobador de puertos TCP de código abierto con API REST e interfaz web, autoalojable con Docker y basado en Litestar.

Ver en GitHubSitio web
Estrellas
198
Forks
9
Issues abiertos
1
Último commit
hace 5 días

¿Qué es?

portchecker.io comprueba si se puede acceder a un puerto TCP de un nombre de host o una dirección IP determinados. Resulta útil para diagnosticar configuraciones de red, verificar reglas del firewall y ver qué puertos están expuestos al exterior.

El proyecto consta de dos partes: un frontend estático en React servido por Nginx y una API en Python, desarrollada con Litestar y ejecutada en gunicorn con workers de uvicorn. Cada parte puede ejecutarse por separado durante el desarrollo o iniciarse junto con Docker Compose, usando imágenes precompiladas publicadas en GitHub Container Registry.

De forma predeterminada, la API no permite comprobar direcciones IP privadas de los rangos de uso especial de IANA; la opción ALLOW_PRIVATE permite habilitar estas comprobaciones. La API también ofrece el endpoint Prometheus /metrics para consultar los tiempos de respuesta y los códigos de estado, e incluye pruebas smoke y de navegador con Playwright en CI.

Funciones clave

  • 01Comprueba la disponibilidad de puertos TCP para cualquier nombre de host o dirección IP.
  • 02Ofrece una API REST con rutas documentadas en /docs.
  • 03Incluye una interfaz web servida por Nginx.
  • 04Se ejecuta en Docker e incluye imágenes precompiladas y archivos de Docker Compose.
  • 05Ofrece un endpoint de métricas Prometheus para supervisar la API.
  • 06Permite habilitar opcionalmente las comprobaciones en rangos de IP privados.

Casos de uso

  • Comprobar si el puerto de un servicio está abierto después de cambiar las reglas del firewall.
  • Verificar desde fuera de una red que los puertos de un servidor estén expuestos según lo previsto.
  • Integrar comprobaciones de puertos en scripts o sistemas de supervisión mediante la API REST.
  • Autoalojar un comprobador de puertos en tu propia infraestructura.

Inicio rápido

  1. 1

    Inicia el stack de producción con Docker Compose (frontend en el puerto 8080 y API en el puerto 8000).

    docker-compose up

Antes de usarlo

  • Tiene licencia GPL-3.0, una licencia copyleft que exige que las obras derivadas se publiquen como código abierto bajo las mismas condiciones.
  • El desarrollo sin Docker requiere Python 3.13 con Poetry y Node 26 o posterior, así que Docker es la opción más sencilla.

En colecciones

Apps autoalojadas

Temas

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

Preguntas frecuentes

¿Qué es portchecker.io?
Comprobador de puertos TCP de código abierto con API REST e interfaz web, autoalojable con Docker y basado en Litestar. portchecker.io comprueba si se puede acceder a un puerto TCP de un nombre de host o una dirección IP determinados. Resulta útil para diagnosticar configuraciones de red, verificar reglas del firewall y ver qué puertos están expuestos al exterior.
¿portchecker.io es gratuito? ¿Qué licencia tiene?
portchecker.io es open source bajo la licencia GPL-3.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿portchecker.io sigue mantenido?
Mantenimiento activo. El último commit de portchecker.io fue el 1 nov 2026.
¿Para qué puedo usar portchecker.io?
Comprobar si el puerto de un servicio está abierto después de cambiar las reglas del firewall. Verificar desde fuera de una red que los puertos de un servidor estén expuestos según lo previsto. Integrar comprobaciones de puertos en scripts o sistemas de supervisión mediante la API REST. Autoalojar un comprobador de puertos en tu propia infraestructura.
¿Cómo se instala portchecker.io?
Inicia el stack de producción con Docker Compose (frontend en el puerto 8080 y API en el puerto 8000).: docker-compose up
¿Dónde consigo portchecker.io?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/dsgnr/portchecker.io

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados