Proxmox VE
KUA lee un clúster de Proxmox VE o un nodo único y lo muestra en la pestaña Proxmox: quorum, nodos, VMs QEMU y contenedores LXC, storage, jobs de backup y tareas recientes. Solo lee: nada cambia en Proxmox, y las lecturas van a la API de Proxmox de tu red, sin costo de nube.
Activar el plugin
Proxmox es un plugin first-party, desactivado por defecto. Abre Plugins/Conexiones (icono de enchufe en la barra de herramientas) y activa Proxmox VE; la pestaña Proxmox aparece en la barra superior.
Crear un API token de solo lectura
- En Proxmox, crea un usuario para KUA (por ejemplo
kua@pve) y dale el rol PVEAuditor en/. - En Datacenter → Permissions → API Tokens, agrega un token para ese usuario con Privilege Separation activada y dale también el rol PVEAuditor al token.
- Copia el id del token (
kua@pve!readonly) y su secreto: Proxmox muestra el secreto una sola vez.
Un token de root@pam, o uno sin privilege separation, funciona, pero puede hacer mucho más de lo que KUA necesita.
Agregar la conexión
En la pestaña Proxmox, haz clic en + (o usa el Env Manager y elige Proxmox VE) y completa:
| Campo | Valor |
|---|---|
PROXMOX_URL | https://pve.example.lan:8006 (solo https, sin ruta) |
PROXMOX_TOKEN_ID | kua@pve!readonly |
PROXMOX_TOKEN_SECRET | el secreto del token |
Luego elige cómo se verifica el certificado del servidor. KUA nunca desactiva la verificación TLS:
- Fijar certificado (autofirmado, lo habitual en Proxmox): haz clic en Leer el certificado del servidor. KUA se conecta sin enviar credenciales y muestra el fingerprint SHA-256. Compáralo con el de Proxmox (nodo → Sistema → Certificados) y haz clic en Fijar este fingerprint. Si el certificado cambia, KUA se niega a conectar y muestra el nuevo fingerprint.
- CA propia: pega la CA del clúster (
/etc/pve/pve-root-ca.pem) o tu propia CA en PEM. - Certificado confiable: para un certificado emitido por una CA en la que este computador ya confía (ACME/Let's Encrypt).
El secreto se guarda en el almacén de credenciales como los demás perfiles y nunca aparece en ids de scope, historial, logs ni exports.
Qué ves
- Overview: quorum, nodos en línea, VMs, contenedores, guests en ejecución, storage sobre 85 %, guests sin job de backup y tareas fallidas en las últimas 24 h.
- Tablas de VMs y contenedores, Nodos, Storage, Jobs de backup y Tareas recientes.
Una sección que el token no puede leer lo dice ("no disponible") en vez de mostrar cero, y el resto se sigue mostrando. El inventario se guarda 30 segundos; Actualizar lo vuelve a leer.