webhooktrap
Webhook Trap es una herramienta open-source de autogestión para depurar integraciones de webhooks. Permite capturar, inspeccionar y reproducir eventos de proveedores como Stripe o GitHub localmente sin dependencias de SaaS. Incluye autenticación OAuth, 2FA y soporte Docker.
Ficha actualizada 26 sept 2026, 12:50 · upstream 26 sept 2026, 12:39 · release sin release detectada
Qué es webhooktrap
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Webhook Trap es una herramienta open-source para depurar integraciones de webhooks en un entorno autoalojado. Funciona como un proxy que intercepta eventos de servicios como Stripe, GitHub o Shopify, permitiendo inspeccionar payloads completos, cabeceras y respuestas en tiempo real sin depender de SaaS externos. La arquitectura utiliza un monorepo con pnpm, separando el backend en AdonisJS 6 para la lógica de ingestión y replay, del frontend en Next.js 16 con Tailwind CSS 4.
Ofrece capacidades avanzadas de seguridad mediante autenticación OAuth (GitHub/Google), TOTP 2FA y tokens de acceso. Incluye un modo anónimo para capturas iniciales sin registro, ideal para compartir eventos read-only con compañeros de equipo. El sistema gestiona medios en Cloudflare R2 o almacenamiento local, garantizando que los proveedores reciban siempre un código 200 OK para evitar bloqueos.
El despliegue es flexible, soportando Docker Compose para entornos locales con requisitos de 2 núcleos CPU y 2GB RAM, o plataformas como Railway y Fly.io para producción. La herramienta facilita la depuración de integraciones complejas al permitir reproducir eventos a localhost, staging o producción desde el mismo contenedor.
- Depurar integraciones de Stripe o Shopify localmente sin túneles
- Compartir eventos read-only con compañeros de equipo sin requerir registro
- Inspeccionar payloads completos y respuestas HTTP en tiempo real
- Reproducir webhooks a entornos de staging o producción desde el contenedor
- Gestionar autenticación OAuth y TOTP 2FA para proteger la API de ingestión
- Arquitectura monorepo con pnpm y Turborepo para gestión eficiente
- Soporte nativo para Docker Compose con configuración de puertos definida
- Autenticación robusta con OAuth (GitHub/Google) y TOTP 2FA integrado
- Retorno HTTP 200 OK constante para evitar que los proveedores bloqueen la URL
- Modo anónimo disponible para capturas iniciales sin necesidad de autenticación
- Requiere PostgreSQL 16 como base de datos externa, no incluye DB embebida
- La opción ALLOW_INSECURE_REPLAY_TARGETS debe estar desactivada en producción
- Complejidad MEDIA con requisitos mínimos de 2 núcleos CPU y 2GB RAM
- El frontend depende de Next.js 16 y Tailwind CSS 4, versiones específicas
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Para despliegue rápido local, use docker compose up. Para producción, Railway o Fly.io son opciones gestionadas (~$5-7/mo). En VPS, configure Caddy como reverse proxy y systemd para el servicio. Importante: nunca active ALLOW_INSECURE_REPLAY_TARGETS=true en entornos de producción. Asegure la base de datos PostgreSQL y los secretos de autenticación OAuth.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.