Proxmox Virtual Environment se ha convertido en una pieza habitual en laboratorios domésticos, pymes y entornos profesionales que quieren virtualización y contenedores con un enfoque práctico. Pero, para muchos administradores, su gran punto fuerte —la interfaz web— también tiene un “pero”: cuando se vive en una terminal, saltar a un navegador para revisar tareas, apagar una VM o consultar el estado de un nodo puede sentirse más lento de lo necesario.
Ahí es donde entra pvetui, un proyecto open source que propone una idea muy simple: gestionar Proxmox VE desde una interfaz de terminal (TUI), con navegación tipo Vim, menús contextuales y una experiencia pensada para operar rápido, sin depender del ratón y con foco en la productividad diaria.
La propuesta no intenta “sustituir” la UI web de Proxmox, sino cubrir un hueco real: el de quienes pasan horas entre SSH, logs, qm, pct y tareas repetitivas, y agradecen tener un panel “tipo htop” para su infraestructura virtual.
Qué es pvetui y por qué puede encajar en el día a día de un sysadmin
pvetui se define como una Terminal User Interface para Proxmox VE. Dicho en claro: una aplicación de consola que se conecta a uno o varios servidores/cluster de Proxmox y ofrece vistas para gestionar nodos, máquinas virtuales, contenedores y recursos del clúster.
El enfoque va directo al grano: entrar, ver el estado, actuar. En su lista de características destaca:
- Rendimiento y respuesta rápida gracias a caché inteligente (para que las vistas sean ágiles).
- Gestión completa de VMs, contenedores, nodos y recursos del clúster.
- Soporte multi-perfil para manejar varias conexiones a Proxmox y alternar entre ellas.
- Asistente de configuración (config wizard) para crear y validar perfiles de conexión desde una TUI interactiva.
- Autenticación segura mediante tokens de API (recomendado) o contraseña, con renovación automática cuando aplica.
- Shells integradas: SSH directo a nodos y acceso a shells de VMs y contenedores.
- Consola VNC con cliente noVNC embebido y autenticación automática.
- Sistema de plugins opcional (opt-in), con extensiones como instalador de “Community Scripts” o un “command runner” para ejecutar comandos permitidos por SSH.
- Modo agregado multi-clúster: agrupar varios perfiles para ver una vista unificada, con acciones enrutadas al clúster origen.
El resultado es un “centro de mando” pensado para operar con teclado, ideal para sesiones rápidas, monitorización operativa y acciones frecuentes.
Lo interesante: multi-perfil y modo agregado para varios clústeres
En la práctica, muchos administradores no gestionan un solo Proxmox. Tienen un clúster en casa, otro en el trabajo, un entorno de laboratorio, o incluso varios CPDs/ubicaciones. pvetui aborda esto con un formato de configuración multi-perfil, donde cada perfil define:
- URL del API (normalmente el endpoint en el puerto 8.006)
- usuario y realm
- token o password (solo uno por perfil)
- opciones como verificación TLS, usuario SSH y usuario para shells en VMs
Además, añade un punto poco habitual en herramientas pequeñas: el Aggregate Group Mode. Permite meter varios perfiles en un grupo (por ejemplo, “prod-group”) para ver una vista agregada de recursos y guests, pero con una limitación lógica: las migraciones se mantienen dentro del clúster original de esa VM, evitando escenarios confusos o peligrosos.
Este detalle habla de un diseño más cuidadoso de lo que parece: agregación para observabilidad y operaciones rápidas, sin inventarse “migraciones mágicas” entre clusters que en la vida real no existen.
Consola VNC integrada: cuando hay que “entrar” sí o sí
Otra diferencia práctica es la consola VNC con noVNC integrado. En Proxmox, la consola es un salvavidas: cuando una VM pierde red, cuando algo no arranca, cuando hay que tocar boot o recovery.
pvetui intenta que eso sea “un clic” (o una tecla) desde la TUI, levantando un proxy local WebSocket que conecta contra el endpoint VNC del servidor Proxmox.
Aquí hay dos matices importantes que conviene tener presentes:
- Los puertos VNC deben estar accesibles desde donde se ejecuta pvetui (si hay firewalls o redes segmentadas, toca revisarlo).
- Las shells VNC de nodo requieren autenticación por contraseña (una limitación atribuida a Proxmox).
No es un obstáculo insalvable, pero sí un recordatorio: la comodidad de la TUI no elimina los requisitos de red y seguridad de un entorno bien montado.
Plugins: extensibilidad sin convertirlo en un monstruo
pvetui incluye plugins desactivados por defecto y activables desde un menú (“Manage Plugins”) o vía configuración. La idea es sensata: quien quiere una TUI limpia la mantiene limpia; quien necesita extras los habilita.
Entre los plugins mencionados:
- community-scripts: añade el instalador de scripts comunitarios a menús contextuales del nodo.
- command-runner: ejecuta comandos permitidos por SSH (requiere configurar claves).
- demo-guest-list: ejemplo de plugin.
Para equipos con estándares internos, el “command-runner” es especialmente delicado: puede ser útil, pero exige listas blancas, control de claves y un enfoque serio de permisos. El hecho de que sea opt-in ayuda a que el usuario no caiga en la tentación de abrir la puerta sin querer.
Instalación: Go, binarios y gestores de paquetes
El proyecto ofrece varias rutas:
- Instalación vía Go (requiere Go 1.24+):
go install github.com/devnullvoid/pvetui/cmd/pvetui@latest - Binarios precompilados desde “Releases”
- Gestores de paquetes: AUR (Arch), Homebrew Cask (macOS), Scoop (Windows)
- Compilación desde fuente con
make install - Uso vía Docker (con
docker compose)
Esa variedad es importante porque pvetui apunta a un público diverso: desde quien administra desde Linux hasta quien entra a su homelab desde macOS o Windows.
Comparativa rápida: Web UI, CLI, automatización por API y pvetui
Para ubicarlo en el ecosistema, ayuda una tabla simple con enfoques típicos en Proxmox:
| Método | Qué aporta | Dónde suele brillar | Limitaciones habituales |
|---|---|---|---|
| Interfaz web de Proxmox | Visión global, gestión completa, accesible | Operaciones generales y administración visual | Menos fluida para “acciones rápidas” repetidas; depende de navegador |
| CLI (qm/pct + SSH) | Control directo, scriptable, muy rápido para expertos | Automatización artesanal y tareas repetitivas | Curva de aprendizaje; menos “visión agregada” |
| Automatización vía API | Escalabilidad, integración con herramientas internas | Entornos grandes, CI/CD, flujos repetibles | Requiere desarrollo, mantenimiento y control de credenciales |
| pvetui (TUI) | Operación ágil con teclado, vistas y menús, SSH/VNC integrado | Operativa diaria, monitorización y acciones rápidas | Depende de acceso API y red; no reemplaza procesos complejos de automatización |
La lectura razonable es que pvetui no compite contra la web UI en términos de “todo para todos”, y tampoco sustituye la automatización seria. Su terreno es el “entre medias”: el momento en el que el administrador necesita actuar rápido y con contexto, sin abrir 10 pestañas.
Seguridad y buenas prácticas: tokens, cifrado y claves
En seguridad, el proyecto insiste en dos puntos que encajan con el sentido común:
- Tokens de API recomendados frente a password.
- Soporte para configuración cifrada con SOPS, y detección/reescritura automática de secretos en claro (según describe la documentación), para no dejar credenciales expuestas en YAML.
Además, para la parte de SSH se recomienda usar claves y evitar logins por contraseña. Esto es especialmente relevante si se pretende usar shells integradas o plugins que ejecutan comandos.
Un detalle legal que conviene apreciar
El repositorio incluye un aviso explícito: Proxmox® es marca registrada y el proyecto no está afiliado, respaldado ni patrocinado por Proxmox Server Solutions GmbH. Es el tipo de aclaración que suele faltar en herramientas comunitarias y que aquí aparece correctamente.
Preguntas frecuentes
¿Para quién tiene más sentido usar pvetui en Proxmox VE?
Para administradores que gestionan Proxmox a diario y prefieren operar desde terminal: acciones rápidas, revisión de estado, gestión de VMs/CTs y accesos por SSH o consola sin cambiar de herramienta.
¿pvetui sustituye la interfaz web de Proxmox?
No. Es más útil como complemento para operativa rápida. La web UI sigue siendo la referencia para tareas administrativas amplias y configuración detallada.
¿Qué opción de autenticación es más recomendable en pvetui?
Los tokens de API. Reducen el riesgo frente a contraseñas y encajan mejor con prácticas de mínimo privilegio, rotación y control de accesos.
¿Se puede usar pvetui para gestionar varios clústeres a la vez?
Sí. Soporta multi-perfil y un modo agregado que combina varios perfiles en una vista unificada, manteniendo acciones enrutadas al clúster origen.
Fuentes:
- GitHub – devnullvoid/pvetui: Terminal UI for Proxmox VE
