Virtualización

ProxMenux: el menú y el panel que le faltaban a un nodo Proxmox suelto

Por Equipo Cloud Privado · · 13 min de lectura
Imagen de portada del artículo «ProxMenux: el menú y el panel que le faltaban a un nodo Proxmox suelto»

Un vistazo en 30 segundos

  • ProxMenux es un kit de utilidades para Proxmox VE: un menú interactivo de terminal más un panel web de salud. Lo desarrolla MacRimi, es GPL-3.0 y nació en diciembre de 2024.
  • Va por la v1.2.4 (22 de julio de 2026), con canal beta aparte y commits casi a diario. En GitHub roza las 2.900 estrellas.
  • Se instala con una línea sobre Proxmox VE 8.x o posterior y deja un lanzador: escribes menu y tienes nueve áreas de utilidades.
  • ProxMenux Monitor es un panel Flask en el puerto 8008, con login, 2FA TOTP, soporte de proxy inverso y notificaciones por correo o Telegram de copias, migraciones y snapshots.
  • Incluye un navegador del catálogo de community-scripts/ProxmoxVE, los antiguos helper-scripts de tteck, desde el propio menú.
  • No es un plano de control: trabaja sobre un nodo, no sobre un parque. Para eso están PegaProx o el Proxmox Datacenter Manager.
  • El propio proyecto se define para el homelab, y esa etiqueta hay que tomársela en serio: en producción gestionada, un cambio en el host que no queda registrado en ningún sitio es deuda técnica.

Cualquiera que haya montado un Proxmox VE desde cero conoce la rutina. Terminas la instalación, y entonces empieza la segunda instalación: quitar el aviso de la suscripción, cuadrar los repositorios, ajustar el ARC de ZFS, dejar la red con nombres de interfaz estables, activar el passthrough de la GPU, montar un recurso compartido, afinar cuatro sysctl. Cada una de esas tareas está documentada en el wiki oficial, en un hilo del foro o en un gist, y uno acaba con quince pestañas abiertas copiando comandos.

ProxMenux ataca exactamente eso: convierte esa colección dispersa de recetas en un menú numerado. Y de paso ha ido creciendo hasta traer un panel web propio.

Ya escribimos sobre PegaProx, que juega en otra liga —plano de control multi-clúster—, así que conviene dejar claro desde el principio en qué se parecen y en qué no.

Qué es ProxMenux exactamente

DatoValor
AutorMacRimi, proyecto abierto y colaborativo
LicenciaGPL-3.0
Primer commitDiciembre de 2024
Versión establev1.2.4 (22 de julio de 2026)
Canal betaRama develop, con instalador propio
Popularidad~2.900 estrellas y 153 forks en GitHub
RequisitosProxmox VE 8.x o posterior, root y salida a internet
ComponentesMenú CLI (dialog) + ProxMenux Monitor (panel web Flask)
Idiomas6, con traducciones precompiladas, español incluido

La instalación es la de toda la vida en este tipo de proyectos:

bash -c "$(wget -qLO - https://raw.githubusercontent.com/MacRimi/ProxMenux/main/install_proxmenux.sh)"

Y a partir de ahí, un comando:

menu

Instala cuatro dependencias de Debian (dialog, curl, jq, git) más python3 y pip para el panel, deja el árbol de scripts en /usr/local/share/proxmenux/ y el lanzador en /usr/local/bin/menu. La desinstalación está en el propio menú, en Settings, y retira scripts, lanzador y servicio.

Un detalle que dice mucho del proyecto: el README avisa, con el aviso en su sitio y no en letra pequeña, de que te leas el script antes de ejecutarlo. Volveremos sobre esto.

Las nueve áreas del menú

La documentación organiza las utilidades en nueve bloques, y el repositorio los refleja bastante fielmente:

ÁreaQué resuelve
Post-instalaciónEl paquete de ajustes que uno aplica siempre tras instalar, en modo automático o a la carta
GPU y Coral TPUPreparar el host para passthrough de GPU y aceleradores Coral
Creación de VMAsistentes para levantar máquinas con configuraciones habituales
DiscosAñadir, pasar y gestionar discos hacia VM y contenedores
Almacenamiento y compartidosMontajes, NFS, Samba y afines
RedNombres de interfaz persistentes y ajustes del puente
SeguridadHerramientas de endurecimiento del host
UtilidadesCajón de sastre con lo que no encaja en el resto
Referencia de comandosChuletario de comandos de Proxmox a mano

A eso se suman módulos de backup y restauración —con instantáneas atómicas de config.db, el pmxcfs, e importación automática de pools ZFS de datos—, un menú de LXC, otro de OCI para imágenes de contenedor y un navegador del catálogo de community-scripts/ProxmoxVE, que es la continuación de los helper-scripts de tteck, cargado desde una caché JSON que mantiene el propio proyecto.

Esa última pieza es más importante de lo que parece: significa que ProxMenux no solo trae sus recetas, sino que hace de portada de la colección de scripts de comunidad más usada del mundillo Proxmox.

ProxMenux Monitor: un panel de salud por nodo

La parte que ha crecido más rápido es el panel web. Se instala de serie con el resto, corre como servicio systemd (proxmenux-monitor.service) y escucha en el puerto 8008.

Lo que ofrece:

  • CPU, RAM, disco y tráfico de red en tiempo real;
  • listado de máquinas virtuales y contenedores con su estado;
  • login con contraseña y doble factor TOTP;
  • funcionamiento detrás de Nginx o Traefik como proxy inverso;
  • interfaz que se adapta a móvil, con instalación como aplicación web;
  • un panel de Health con comprobaciones del sistema, incluida la de actualizaciones pendientes;
  • notificaciones por correo o Telegram de eventos reales del nodo: copias de vzdump con su destino, migraciones con el nodo de destino y snapshots con su nombre.

Panel Overview de ProxMenux Monitor sobre un nodo Proxmox: cabecera con el nombre del nodo, estado Healthy y tiempo de actividad; tarjetas de uso de CPU, memoria con caché, máquinas virtuales y contenedores activos y temperatura; y debajo gráficas de CPU con carga media, uso de memoria con la línea de ZFS ARC, resumen de almacenamiento y de red

Captura oficial del proyecto ProxMenux. Las pestañas de arriba dan la medida de hasta dónde llega: Overview, Storage, Network, VMs & LXCs, Hardware, System Logs, Terminal, Security, Settings y About.

Merece la pena fijarse en dos detalles de esa vista. Uno, que la gráfica de memoria separa el ARC de ZFS del resto, que es justo lo que uno quiere ver en un nodo Proxmox y no siempre está a mano. Y dos, que hay una pestaña de Terminal dentro del panel: cómoda, y una razón más para tratar este servicio como acceso privilegiado al hipervisor y no como un dashboard cualquiera.

La versión 1.2.4 añadió un botón de Update Now que ejecuta apt update y dist-upgrade desde el propio panel, con un flujo de actualización que respeta los repositorios que hayas escrito tú y detecta si el kernel instalado no es el que está corriendo para pedirte el reinicio.

Es un panel honesto: enseña el estado de un nodo, sin pretender ser un sistema de métricas. Si lo que quieres es histórico largo, alertas con reglas y correlación entre nodos, eso sigue siendo territorio de Prometheus y Grafana, y las dos cosas no se estorban.

Dónde encaja: ProxMenux, PegaProx y el Datacenter Manager

Aquí es donde conviene poner cada herramienta en su sitio, porque las tres se citan juntas a menudo y resuelven problemas distintos.

ÁmbitoQué aportaQuién lo mantiene
Interfaz de Proxmox VEClústerLa gestión soportada de siempreProxmox GmbH
ProxMenuxUn nodoUtilidades de terminal + panel de saludProyecto comunitario (MacRimi)
PegaProxVarios clústeresPlano de control multi-clúster, incluso multi-hipervisorProyecto comunitario
Datacenter ManagerVarios clústeresVista y operación centralizada, con respaldo oficialProxmox GmbH

ProxMenux no compite con ninguna de las otras tres: se pone por debajo. Trabaja en la capa del sistema operativo del nodo, que es justo la que la interfaz de Proxmox no toca. Puedes tener PegaProx orquestando cuatro clústeres y seguir queriendo un menú que te deje un nodo nuevo a punto en diez minutos.

Lo que hay que mirar antes de meterlo en producción

Todo lo anterior está muy bien, y aun así hay tres cosas que un responsable de infraestructura debe pensar antes de teclear ese wget.

Primera: es un script como root en un hipervisor. El propio proyecto lo dice y hace bien en decirlo. wget | bash con privilegios totales sobre la máquina que sostiene tus VM es la clase de comando que se revisa antes, no después. El código está en GitHub y se puede leer; el problema no es que sea malicioso, es la costumbre de ejecutar sin mirar.

Segunda, y más importante en un entorno gestionado: los cambios no quedan registrados. Un menú interactivo que ajusta repositorios, sysctl, el ARC de ZFS, el nombrado de interfaces o los módulos DKMS deja el host distinto y sin rastro fuera de él. Dentro de seis meses, cuando ese nodo se comporte distinto a sus compañeros, nadie va a recordar qué opciones se marcaron. Por eso en las plataformas que gestionamos ese tipo de ajustes va por infraestructura como código: versionado, revisable y reproducible en el nodo siguiente. Un menú es magnífico para el primer nodo y un problema para el número doce.

Tercera: el panel es superficie nueva. Un servicio web escuchando en el hipervisor es un puerto más que defender, por muy bien que traiga el 2FA. Va detrás de VPN o de proxy inverso con acceso restringido, nunca publicado, y con la misma disciplina de segmentación que aplicas al resto de la gestión.

Y un apunte de contrato que se olvida: Proxmox no da soporte a modificaciones de terceros sobre el host. Si tienes suscripción y un problema raro, lo primero que te van a preguntar es qué le has metido a ese nodo.

Cómo lo miramos nosotros

Con ProxMenux, con los helper-scripts de comunidad y con cualquier herramienta parecida aplicamos el mismo criterio, que no es de desconfianza sino de trazabilidad: en el laboratorio, lo que haga falta; en producción, lo que se pueda reproducir.

Un menú que te deja un nodo listo en diez minutos es una herramienta estupenda para aprender, para montar un banco de pruebas o para el servidor de casa. En una plataforma con varios nodos, ventanas de mantenimiento firmadas y objetivos de disponibilidad, lo que vale no es la velocidad de aplicar un ajuste sino poder responder a dos preguntas: qué se cambió, y cómo se vuelve atrás.

Lo interesante de ProxMenux, más allá de sus utilidades, es lo que revela: mucha gente monta Proxmox y descubre que la interfaz oficial cubre el clúster pero no el sistema operativo de debajo. Ese hueco es real, y ahí es donde entra el trabajo de plataforma que hacemos cuando alguien nos pide un cloud privado con Proxmox: que todos los nodos estén configurados igual, que se sepa por qué, y que el número trece salga idéntico al primero.

Si estás en ese punto, con nodos que fueron creciendo cada uno a su manera, cuéntanos cómo lo tienes y te decimos qué unificaríamos y en qué orden.

Preguntas frecuentes

¿ProxMenux sustituye a la interfaz web de Proxmox VE?

No. Trabaja por debajo, en el sistema operativo del nodo: post-instalación, hardware, discos, red y utilidades que la interfaz de Proxmox no cubre. La gestión del clúster, las VM y el almacenamiento sigue haciéndose donde siempre.

¿Sirve para gestionar varios clústeres?

No, es una herramienta por nodo. Para varios clústeres están el Proxmox Datacenter Manager, con respaldo oficial, y proyectos comunitarios como PegaProx.

¿Es seguro instalarlo?

El proyecto es abierto, con licencia GPL-3.0, código auditable y avisa expresamente de que revises el script antes de ejecutarlo. Dicho eso, es un instalador que corre como root sobre tu hipervisor: la decisión razonable es leerlo, probarlo primero en un nodo que no sea de producción y saber cómo se desinstala.

¿Qué versión de Proxmox necesita?

La documentación pide Proxmox VE 8.x o posterior. Como siempre con herramientas de terceros, conviene comprobar en el repositorio si la versión concreta que corres está probada antes de lanzarla contra un nodo que importa.

¿El panel del puerto 8008 se puede exponer a internet?

No deberías. Trae login y doble factor TOTP y admite proxy inverso, pero un panel de administración del hipervisor se publica detrás de VPN o de un proxy con acceso restringido, nunca abierto.

¿Reemplaza a Prometheus y Grafana?

No. El Monitor da salud y estado en vivo de un nodo, con notificaciones de eventos. Para histórico largo, reglas de alerta y visión conjunta del parque, sigues necesitando una pila de métricas propia.

Fuentes