mongonaut
Interfaz web moderna y auto-alojada para gestionar MongoDB, construida con Next.js y React. Soporta autenticación interna, OIDC y despliegue en Docker. Ideal para equipos pequeños y entornos internos que buscan una alternativa ligera a clientes de escritorio.
Ficha actualizada 23 sept 2026, 19:48 · upstream 23 sept 2026, 19:37 · release v0.1.10
Qué es mongonaut
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Mongonaut es una herramienta de administración web diseñada para ejecutarse junto a la base de datos MongoDB en entornos auto-alojados. Permite navegar por bases de datos, consultar colecciones, editar documentos preservando tipos BSON y gestionar índices directamente desde el navegador. La interfaz utiliza Next.js, React y TypeScript, ofreciendo una experiencia moderna sin necesidad de instalar clientes locales.
Soporta múltiples modos de autenticación, incluyendo cuentas internas, contraseñas estáticas y OpenID Connect, con opciones para listas blancas de correos y protección contra fuerza bruta. Incluye endpoints de salud (/api/health y /api/ready) para orquestadores como Kubernetes, asegurando que el contenedor esté listo antes de enviar tráfico.
La herramienta prioriza la seguridad mediante modos de solo lectura, auditoría de cambios en los logs del contenedor y gestión granular de permisos por base de datos o colección. Se distribuye a través de GitHub Container Registry con soporte para arquitecturas AMD64 y ARM64, facilitando su integración en infraestructuras heterogéneas.
- Gestión diaria de bases de datos MongoDB en servidores internos sin instalar clientes.
- Herramienta de observabilidad para equipos de soporte que necesitan inspección de datos en modo solo lectura.
- Entorno de desarrollo local o home lab con autenticación simplificada por contraseña estática.
- Integración en Kubernetes usando probes de salud para gestión escalable de instancias MongoDB.
- Implementación de identidad centralizada mediante proveedores OpenID Connect (Keycloak, etc.).
- Preservación estricta de tipos BSON al editar documentos (ObjectId, fechas, números).
- Soporte nativo para pipelines de agregación y edición de índices sin salir del navegador.
- Flexibilidad en autenticación con modos ACCOUNT, STATIC_PASSWORD, OIDC y NONE.
- Endpoints de salud independientes que no dependen del estado de la base de datos para liveness.
- Auditoría completa de cambios de datos y cuentas registrada en los logs del contenedor.
- No soporta múltiples conexiones a MongoDB en una sola instancia del servicio.
- Ausencia de análisis de planes de ejecución (explain()) para optimización de consultas.
- Sin soporte para GridFS, streams de cambios ni gestión de usuarios del servidor.
- Requiere configuración manual de secretos de autenticación y TLS para exposición pública.
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
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.
Despliegue recomendado en Docker o Kubernetes con ghcr.io/withzu/mongonaut. Configurar MONGO_CONNECTION_URL correctamente y usar MONGONAUT_AUTH_SECRET robusto (mínimo 32 caracteres). Para producción, fijar una versión específica en lugar de latest y habilitar un proxy inverso TLS. Evitar exponer el puerto 8081 directamente a internet sin autenticación y controles de red.
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.