docker-compose-debugger
Herramienta cliente único (SPA) que procesa localmente YAML de Docker Compose: redacta secretos, genera vistas de tarjetas/tablas y exporta Markdown para soporte en GitHub/Discord.
Ficha actualizada 26 sept 2026, 23:29 · upstream 26 sept 2026, 23:03 · release v0.2.0
Qué es docker-compose-debugger
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Docker Compose Debugger es una aplicación web autocontenida construida con Vite y TypeScript puro. No requiere servidor ni backend; todo el procesamiento ocurre en el navegador del usuario mediante un único archivo HTML generado por vite-plugin-singlefile.
La herramienta acepta múltiples formatos de entrada: archivos docker-compose.yml crudos, salida de "docker compose config" o resultados de docker-autocompose. Proporciona tres vistas principales: Tabla (vista por defecto con comparaciones de usuarios/grupos y volúmenes), Tarjetas (detalle por servicio) y YAML (salida sanitizada lista para pegar). Incluye botones dedicados para copiar como Markdown optimizado para GitHub o Discord.
Funcionalidades clave incluyen redacción automática de valores sensibles (contraseñas, tokens, URLs con credenciales), eliminación de ruido automático (etiquetas com.docker.compose.*, variables S6_*, PATH, LANG) y detección de advertencias comunes como montajes que impiden hardlinks. La configuración de patrones sensibles y listas seguras es personalizable y persiste en localStorage.
- Auditoría rápida de secretos antes de compartir logs o configuraciones en canales de soporte
- Comparación visual de UID/GID entre servicios para detectar conflictos de permisos en volúmenes compartidos
- Generación de reportes Markdown listos para pegar en GitHub Issues o Discord sin formato roto
- Sanitización de YAML con redacción de tokens AWS, GitHub PATs, URLs de bases de datos y emails
- Procesamiento 100% local: ningún dato sale del navegador; sin analytics ni peticiones externas
- Redacción robusta de patrones conocidos (AWS AKIA, GitHub ghp_, JWTs, URLs con credenciales)
- Persistencia de configuración en localStorage para personalizar patrones sensibles y listas seguras
- Detección automática de advertencias como montajes que impiden hardlinks entre directorios
- Exportación dual de Markdown optimizada para GitHub (pipe tables) y Discord (código bloqueado)
- No ejecuta ni gestiona contenedores; solo analiza archivos YAML o salida de comandos
- La redacción depende de expresiones regulares; puede haber falsos positivos/negativos con patrones no cubiertos
- Persistencia en localStorage sin sincronización entre dispositivos ni recuperación tras borrado del caché
- No valida sintaxis YAML completa; asume que la entrada es válida o muestra errores genéricos
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.
Descargar docker-compose-debugger.html desde el último release y abrirlo directamente en cualquier navegador moderno. No requiere instalación de dependencias ni servidor web. Para desarrollo, ejecutar npm install y npm run dev con Vite. El build produce un único archivo distribuido mediante vite-plugin-singlefile.
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.