proxmox-pve-toolkit
Toolkit CLI modular en Python para gestión avanzada de clusters Proxmox VE 7.x/8.x, incluyendo auditoría de salud, orquestación de backups vzdump, control de energía masivo y hardening de seguridad.
Ficha actualizada 22 sept 2026, 16:21 · upstream 3 sept 2026, 8:21 · release sin release detectada
Qué es proxmox-pve-toolkit
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Proxmox PVE Toolkit es una herramienta de automatización empresarial diseñada para la gestión integral de hipervisores Proxmox VE. Proporciona capacidades modulares mediante una interfaz CLI construida con Typer y Rich, permitiendo auditorías detalladas de nodos y clusters, orquestación de copias de seguridad mediante vzdump con políticas de retención avanzadas, y gestión de estados de energía en masa para máquinas virtuales y contenedores LXC.
La herramienta incluye un motor de hardening de seguridad que verifica configuraciones de autenticación, firewalls, certificados SSL y puntos finales no autenticados, generando scripts de remediación automatizados. Soporta tanto despliegues nativos con Python como contenerización mediante Docker Compose para auditorías programadas o ejecuciones puntuales sin persistencia.
Su arquitectura se basa en la API REST de Proxmox con autenticación mediante tokens API y roles ACL limitados, lo que permite operaciones seguras sin depender de credenciales root. Es compatible con sistemas de almacenamiento ZFS, Ceph y LVM-Thin, y está diseñado para entornos de producción y laboratorios.
- Auditoría continua de salud de nodos y clusters para detección temprana de saturación de recursos o fallos en quórum
- Orquestación automatizada de copias de seguridad con políticas de retención escalonadas (últimos, diarios, mensuales)
- Gestión masiva de estados de energía (inicio, parada, reinicio) filtrada por etiquetas o pools de recursos
- Hardening de seguridad mediante auditorías de baseline y generación automática de scripts de remediación
- Soporte nativo para Docker Compose con despliegue programado de daemons de auditoría
- Autenticación segura mediante tokens API con roles ACL limitados, evitando credenciales root
- Compatibilidad con Python 3.10+ y librerías modernas como typer, rich y proxmoxer
- Generación automática de scripts Bash para remediación de vulnerabilidades detectadas
- Requiere configuración manual de credenciales en archivo .env no versionado por defecto
- Dependencia de la API REST de Proxmox, sin soporte directo para interfaces gráficas o CLI nativas del hipervisor
- No incluye Dockerfile oficial, requiriendo construcción manual de imágenes personalizadas
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.
Instalar mediante entorno virtual Python con pip y requirements.txt, o construir imagen Docker desde el repositorio. Configurar variables PROXMOX_HOST, PROXMOX_USER, PROXMOX_TOKEN_VALUE en .env antes de ejecutar comandos. En producción, establecer VERIFY_SSL=true si se usa certificado válido; usar false solo en entornos privados con certificados auto-firmados.
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.