linux-doctor
Herramienta de diagnóstico del sistema Linux que realiza checks read-only, explica problemas y sugiere soluciones. Compatible con sistemas inmutables y ofrece interfaz CLI, web y escritorio (Tauri).
Ficha actualizada 22 sept 2026, 15:10 · upstream 22 sept 2026, 14:39 · release v0.7.0
Qué es linux-doctor
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Linux Doctor es una herramienta de diagnóstico para sistemas Linux que ejecuta comprobaciones de estado sin modificar el sistema por defecto. Analiza múltiples aspectos como memoria, disco, servicios, certificados TLS, seguridad, actualizaciones y hardware, proporcionando explicaciones claras en lenguaje natural junto con comandos de reparación sugeridos.
La herramienta recuerda las ejecuciones anteriores mediante un sistema de identidad estable para cada hallazgo (código), permitiendo comparar cambios entre versiones (NEW/FIXED) y mostrar tendencias de salud. Ofrece una puntuación de salud del 0 al 100, gráficos de tendencia y destaca la acción más importante con "START HERE".
Está construida sobre Node.js y Rust, disponible como CLI vía npx, paquetes .deb/.rpm/AppImage o compilada desde fuente. Funciona en distribuciones tradicionales e inmutables (Silverblue, Bazzite), incluso sin Node.js instalado globalmente gracias a su runtime embebido en los paquetes de escritorio.
- Diagnóstico inicial de un servidor o estación de trabajo Linux para identificar problemas críticos antes de reportar bugs
- Ejecución periódica desde un systemd timer para mantener el sistema saludable y detectar degradación progresiva
- Auditoría de seguridad rápida verificando configuraciones como SSH, firewall, SELinux y certificados TLS expirados
- Optimización de rendimiento analizando presión de memoria, uso de swap, carga CPU y temperatura del hardware
- Enfoque read-only por defecto: nunca modifica el sistema; las reparaciones son sugerencias que el usuario ejecuta voluntariamente
- Memoria integrada con puntuación de salud (0-100), sparkline de tendencias y diff NEW/FIXED entre ejecuciones
- Compatibilidad con sistemas inmutables como Silverblue y Bazzite mediante AppImage o npx sin necesidad de instalar paquetes globales
- Código estable para cada hallazgo que permite historial, ignorado selectivo (--ignore-code) y comparación temporal precisa
- Interfaz unificada entre CLI, dashboard web y aplicación de escritorio (Tauri) ejecutando exactamente los mismos checks
- Requiere Node.js ≥20 para la versión CLI; el AppImage embebe su propio runtime pero añade ~130 MB al tamaño instalado
- Posibles errores gráficos en AppImage con versiones muy recientes de Mesa (EGL/WebKitGTK incompatibilidades)
- No incluye monitorización continua ni alertas activas; es una herramienta de diagnóstico puntual, no un sistema de monitoreo en tiempo real
- Algunos checks como batería o reinicio están deshabilitados automáticamente en sistemas que no los soportan (desktops o inmutables)
- Las reparaciones requieren intervención manual del usuario; el modo --fix solo muestra un plan de ejecución previa
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, use npx linux-doctor sin instalación. Para escritorio, descargue el AppImage desde releases o instale .deb/.rpm según distribución. En sistemas inmutables, prefiera AppImage o npx. Configure LINUX_DOCTOR_HARDWARE_GL=1 si hay problemas de renderizado gráfico y WEBKIT_DISABLE_DMABUF_RENDERER=0 para evitar ventanas blancas en versiones recientes.
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.