ProxMenux/lang/es/CHANGELOG.md

2026-06-02

Nueva versión ProxMenux v1.2.2 — Consolidación estable del ciclo v1.2.1.x

Release estable que lleva al canal principal las cuatro prereleases del ciclo v1.2.1.x en un solo movimiento. El trabajo a lo largo de esas cuatro betas se centró en tres temas: hacer del Health Monitor algo realmente configurable en lugar de solo observable (thresholds por categoría, duraciones de dismiss por evento, un audit log de supresiones activas), expandir el stack de notificaciones para cubrir alrededor de 80 servicios a través de Apprise mientras se persisten eventos durante las Quiet Hours, y convertir el propio proceso del Monitor en un ciudadano del sistema más silencioso y predecible en hosts idle. Por encima de eso, esta release entrega detección automática de updates en contenedores LXC, una reescritura end-to-end del instalador de Coral TPU con los últimos drivers upstream, y una larga lista de fixes visibles para el operador — handshake del terminal HTTPS, detección de kernel updates en PVE 9.x, flujo del instalador NVIDIA en Alpine LXC, gestión del audio acompañante en passthrough de GPU mixta, y varias optimizaciones runtime en los bucles de scan del Monitor. Cinco contribuciones de código directas de la comunidad shipean junto con esta release (@jcastro ×5, @pespinel ×1) y el trabajo de GPU passthrough lo impulsaron los reports detallados de campo de @ghosthvj — ver los Acknowledgments al final.

---

🩺 Health Monitor — Configurable, granular, auditable

Tres piezas acopladas que juntas permiten al operador ajustar el Health Monitor a la envoltura real de su host en lugar de trabajar alrededor de sus defaults, y gestionar dismisses con el mismo control fino que ya tienen sobre el resto del dashboard.

Thresholds Warning / Critical por categoría

Cada check que corre el Health Monitor está parametrizado por un par de números — un Warning y un Critical — y ambos están ahora expuestos bajo Settings → Health Monitor Thresholds. Los defaults que shipean con ProxMenux son razonables para el host Proxmox medio, pero cada entorno tiene su propia envoltura:

• Un homelab pequeño con un único SSD quiere paginar antes en capacidad (75 / 90 %) para dejar margen a snapshots.
• Un nodo de datacenter con almacenamiento Ceph redundante puede ser mucho más relajado con los warnings de memoria (un working set del 90 % es normal con ZFS ARC).
• Un mini-PC refrigerado pasivamente necesita thresholds de temperatura más bajos que un servidor con refrigeración forzada — misma clase de disco, distinta envoltura física.

Los cambios surten efecto en el siguiente scan — el Health Monitor relee los valores desde /usr/local/share/proxmenux/health_thresholds.json en cada ciclo, sin restart del servicio. Los mismos números también alimentan los rangos de color de cada widget del dashboard (barras de almacenamiento, anillos de CPU/memoria, chips de temperatura, el punto del modal de disco), de forma que la clasificación visual en cualquier punto del Monitor mapea a un rango definido respecto al par configurado.

Duración de dismiss por evento con badge Permanent

El botón Dismiss en cada alerta del Health Monitor abre ahora un pequeño dropdown con tres opciones:

• 24 hours — default anterior, se comporta exactamente como antes
• 7 days — útil para una condición temporal de la que no quieres oír durante una migración de una semana
• Permanently — silencia este error_key concreto indefinidamente

Los dismisses permanentes se persisten con suppression_hours = -1 en la base de datos de persistencia, nunca re-emiten, nunca re-notifican y se marcan con un badge ámbar Permanent distinto en el Health Monitor para que el operador siempre sepa qué alertas están silenciadas intencionadamente. La infraestructura backend para el centinela permanente ya existía — solo le faltaba a la UI una forma de fijarlo. El contrato de API es pequeño y backwards-compatible: POST /api/health/acknowledge acepta un campo body opcional suppression_hours (entero positivo para horas, -1 para permanente); omitirlo preserva el comportamiento previo y usa la supresión configurada de la categoría. Un segundo endpoint nuevo POST /api/health/un-acknowledge {error_key} limpia un acknowledgment previamente registrado para que la alerta vuelva a ser elegible para dispararse — usado por el panel Active Suppressions abajo.

Panel Active Suppressions en Settings

Una nueva sección dentro de Settings → Health Monitor, justo debajo de las duraciones de supresión por categoría, lista cada alerta actualmente silenciada — tanto los dismisses con tiempo limitado (con un badge 22h remaining / 6d remaining) como los permanentes (con el badge ámbar Permanent del dashboard). Cada fila lleva el error_key, la categoría, la severidad, el timestamp en que se registró el dismiss, y un botón Re-enable que limpia el acknowledgment server-side. Los re-enables están encolados — pulsar el botón marca la fila en verde con texto tachado y cambia el botón a Undo, y el POST /api/health/un-acknowledge real solo se dispara cuando el usuario pulsa Save, de modo que un lote de re-enables se entrega atómicamente junto a cualquier cambio pendiente de dropdown por categoría. La acción está protegida por el toggle de Edit del Health Monitor en la parte superior de la card. Los dismisses permanentes solo pueden revertirse desde aquí — el dashboard no expone intencionadamente un affordance per-alerta de un-dismiss para evitar re-enables accidentales, por lo que el panel de Settings es la superficie deliberada de auditoría + revert para ellos. La lista también se refresca automáticamente cuando se hace un dismiss de una alerta desde el modal del Health Monitor mientras la página de Settings ya está abierta, vía un evento health-suppression-changed del navegador más listeners en window focus y document visibilitychange.

Tiers de severidad de Disk I/O

Una ventana deslizante de 24 h clasifica ahora los errores ATA / SCSI de dmesg en tres buckets: silencioso (0–10 eventos transitorios), WARNING (11–100) y CRITICAL (100+, o cualquier error duro como UNC / Buffer I/O / Sense Key Hardware Error). Los días tranquilos se quedan tranquilos, pero un único evento de Buffer I/O sigue paginando inmediatamente.

---

📨 Canal de notificación Apprise — Paridad completa de features

La integración Apprise que aterrizó como un adapter básico en 1.2.1.4-beta se ha graduado a paridad completa con los canales nativos. Una sola URL de Apprise llega ahora a alrededor de 80 servicios de notificación (Pushover, ntfy, Slack, Matrix, mailto, signal, Pushbullet, Mattermost, Microsoft Teams vía webhooks, …) sin que ProxMenux necesite un adapter dedicado para cada uno. La pestaña Apprise en Notifications expone los mismos controles que Telegram, Gotify, Discord y Email:

• El bloque Notification Categories completo — las mismas 10 categorías con sus sub-toggles por evento, idéntico a los otros canales
• Quiet Hours — ventana start/end por canal, con el mismo comportamiento de buffering (los eventos disparados durante la ventana se persisten en SQLite y se liberan como un resumen agrupado cuando la ventana cierra, en lugar de dropearse silenciosamente)
• Daily Digest — entrega opt-in de un resumen una vez al día a una hora elegida

El filtrado per-channel del backend ya aplicaba genéricamente a cada canal incluyendo Apprise vía el bloque channel_overrides — la UI simplemente no estaba surfaceando los controles.

Tres fixes de fiabilidad shipean junto, todos surfaceados después del rollout beta inicial:

1. Mobile overflow en viewports estrechos. La fila de Apprise URL solía romper el diseño — el placeholder empaquetaba cuatro URLs de ejemplo completas en una línea y los <code> inline de los ejemplos no tenían regla break-all. El placeholder es ahora un único ejemplo conciso (tgram://bottoken/ChatID), el wrapper del input URL fuerza min-w-0 / flex-1 / shrink-0 en sus children, y el párrafo de ejemplos usa break-all min-w-0 para que envuelva limpiamente a cualquier ancho.

2. Regresión del whitelist backend que rechazaba Apprise con HTTP 400. El conjunto de canales hardcodeado del validador de notifications-test ({telegram, gotify, discord, email, all}) tenía a apprise ausente, por lo que cada test o send de Apprise devolvía 400 Invalid channel antes de que la librería fuera siquiera invocada. El whitelist se deriva ahora en vivo desde notification_channels.CHANNEL_TYPES, de forma que añadir una nueva implementación de canal en el futuro no puede regresionar silenciosamente este validador otra vez.

3. Error reporting opaco cuando el destino devolvía una respuesta no-2xx. Cuando un destino (jsons://, ntfy://, slack://, …) rechazaba el payload, el operador solo veía un mensaje genérico "Apprise rejected the notification (transport failure)". El canal captura ahora el logger interno de Apprise durante notify() y surfacea el HTTP status code real más el response body del destino (capado a 300 caracteres) — de forma que un beta tester debuggeando un webhook custom puede ver inmediatamente si el servidor upstream está rechazando su schema de payload.

---

📦 Detección de updates en LXC

Una nueva sección dedicada en Settings (entre Health Monitor Thresholds y Notifications) con un único toggle que protege el scan per-CT de apt list --upgradable / apk list -u end-to-end. Default ON. Cuando está OFF el scan para completamente (sin llamadas pct exec), cada entrada type=lxc se purga inmediatamente del registry de managed-installs, y el toggle de notificación correspondiente en Notifications → Services desaparece de la UI mientras preserva su preferencia almacenada.

El checker lee también el mtime de la caché de metadata del package-manager de cada CT y dispara apt-get update / apk update desde fuera vía pct exec si tiene más de 24 h, con timeout de 60 s y fallo silencioso. Los CTs appliance long-running cuyas cachés estaban meses obsoletas surfacean por fin su backlog real upstream — un CT Debian 12 con caché de 524 días pasó de "0 updates" a "117 (12 security)" en hardware de lab.

---

🐧 Coral TPU en LXC — Últimos drivers upstream

El instalador de Coral para LXC (scripts/gpu_tpu/install_coral_lxc.sh) se ha reescrito end-to-end para instalar el último driver gasket-dkms upstream y el último runtime libedgetpu1 (220 líneas añadidas, 150 eliminadas). Los módulos Coral M.2 / mPCIe que antes fallaban al compilar en kernels PVE 9 ahora instalan y bindean limpiamente. Las notificaciones de update registry-driven que aterrizaron en 1.2.1.2 mantienen ambos paquetes frescos en adelante: la pestaña Hardware + Notifications señalizan cuando feranick/gasket-driver publica una release nueva, y el runtime libedgetpu1 tracked vía apt recibe el flujo estándar de System Updates.

El path de uninstall del instalador Coral acompañante también aterriza en este ciclo — espejando el flujo NVIDIA para que una instalación Coral pueda revertirse limpiamente si el usuario re-despliega el host sin aceleración TPU.

---

⚡ Optimizaciones de rendimiento del Monitor

Una corrida de strace + sampling de 10 minutos sobre un host live surfaceó tres sitios donde el scanner de background del Monitor estaba spawning subprocesos más agresivamente de lo necesario. Los tres están arreglados en 1.2.2:

Tormenta de subprocesos fail2ban

En hosts donde fail2ban-client no estaba instalado, el wrapper de caché alrededor de _f2b_get_banned_ips() solo actualizaba su timestamp en éxito. Cada request HTTP al dashboard caía a través del check de caché y disparaba un execve("fail2ban-client", ...) fresco que inmediatamente fallaba con ENOENT — 250+ llamadas execve fallidas en una ventana de 10 minutos. shutil.which('fail2ban-client') se resuelve ahora una vez al cargar el módulo y el timestamp de caché se actualiza incondicionalmente. Los hosts sin Fail2Ban tienen ahora cero syscalls de fail2ban-client por request.

Colisión del scheduler de smartctl

El polling de temperatura SMART de discos, la lectura de temperatura CPU y la probe de latency solían dispararse en el mismo offset dentro de cada minuto, produciendo un spike medible de CPU / IO cuando todos sus subprocesos spawneaban juntos. Las polls están ahora staggered (latency primero, luego temperatura CPU, luego SMART de disco) preservando la cadencia per-disco de 60 s — el spike ha desaparecido, el CPU total bajo carga no cambia.

Subproceso de inventario LXC

El mount monitor solía llamar lxc-info -n <vmid> -p por cada CT corriendo solo para obtener su PID init. Ahora lee /proc/<lxc-start-pid>/task/<lxc-start-pid>/children directamente y solo cae a lxc-info cuando la lectura de /proc falla. Un subproceso por CT por ciclo de scan eliminado — medible en hosts con 20+ contenedores.

---

🔌 Handshake del terminal HTTPS

Cada modal de terminal en el Monitor (terminal del dashboard, terminal LXC, terminal de scripts) solía fallar con WebSocket connection error en hosts donde HTTPS estaba habilitado. La root cause era específica al path gevent + SSL: el WebSocketHandler de gevent-websocket estaba apilado sobre la implementación de protocolo de flask-sock, por lo que el servidor emitía dos cabeceras HTTP/1.1 101 Switching Protocols consecutivas y el navegador cerraba la conexión como un frame corrupto. Quitar el argumento explícito handler_class=WebSocketHandler restaura una única respuesta 101 y el handshake completa con normalidad. El fix es invisible para operadores corriendo en HTTP plano — no estaban afectados — pero desbloquea cada install fronteada por HTTPS (reverse proxies, deployments con certificate-managed, cualquier cosa detrás de nginx/Traefik).

Adicionalmente, el panel de terminal solía perder su conexión WebSocket cuando el usuario activaba la feature de auto-traducción del navegador (los prompts "translate this page" de Chrome / Edge / Safari). El traductor mueve nodos del DOM que React aún mantiene como refs, y el componente WebSocket React se rompe porque su ref de contenedor apunta a un nodo movido. Añadido translate="no" en los divs contenedores del terminal para que el traductor salte el tty embebido por completo — las traducciones en el resto de la página siguen funcionando.

---

🐧 Health Monitor — Detección de kernel updates en PVE 9.x (#208)

En hosts Proxmox VE 9.x, la fila System Updates → Kernel / PVE reportaba "Kernel/PVE up to date" incluso cuando un update para el kernel corriendo estaba esperando upstream. Tres causas combinadas, tres fixes combinados:

1. La lista de prefijos de kernel-packages incluye ahora proxmox-kernel-* y proxmox-firmware-* — PVE 9.x shipea kernels bajo proxmox-kernel-, no el prefijo pve-kernel- de 7.x / 8.x. El regex anterior nunca matcheaba los paquetes nuevos y por tanto nunca flagueaba ningún update de kernel en 9.x.

2. El dry-run cambió de apt-get upgrade --dry-run a apt-get dist-upgrade --dry-run. PVE 9 shipea kernel updates empaquetados como instalaciones nuevas (no como upgrades directas de un paquete existente), y el upgrade --dry-run plano no considera nuevas instalaciones en absoluto. dist-upgrade --dry-run sí.

3. La detección del kernel corriendo lee ahora uname -r y flaguea un update como running-kernel update cuando el paquete matchea la release corriendo exactamente o su meta-package de branch (p. ej. proxmox-kernel-6.14 para un host en 6.14.11-4-pve). El texto de la fila distingue "Running kernel update available (reboot required)" de "N kernel update(s) available (none for running kernel)" para que el operador sepa si necesita reboot o solo instalar.

---

🟢 Instalador NVIDIA

Varias mejoras impulsadas por los reports detallados de campo de @ghosthvj sobre configuraciones de GPU mixta (ver Acknowledgments):

• Ventana de compatibilidad de kernel — el menú de versiones respeta ahora el rango de drivers compatibles del kernel corriendo, ofreciendo solo branches que no fallarán al compilar contra el kernel del host.
• Soporte Alpine LXC — el install de userspace container-side se reescribió para que succeda en hosts Alpine; la detección de espacio libre funciona fiablemente en todos los layouts de almacenamiento (LVM-thin, ZFS, directory, etc).
• NVENC patch awareness — cuando el host tiene el patch NVENC aplicado, el menú de versiones se estrecha a drivers soportados por el patch para que reinstalar nunca lo pierda silenciosamente.
• Feedback de uninstall — el path de uninstall reporta ahora un mensaje claro de completación en lugar de volver al menú en silencio.

---

🌐 Sitio de documentación — Migración i18n completa

El sitio de documentación acompañante (proxmenux.com) shipea ahora bajo URLs prefijadas por locale (/en/... y /es/...) con la plumbing de next-intl. Cada doc page es bilingüe — 107 páginas traducidas al español (sin placeholders copy-of-English). El root / redirige a /en/ vía meta-refresh + JS para que la URL apex siga resolviendo a algo útil. Los RSS feeds funcionan per-locale en /en/rss.xml y /es/rss.xml, con el canonical /rss.xml conservado para backwards compatibility con suscriptores de feed existentes. La búsqueda client-side está wireada vía Pagefind — el índice se construye fresh en cada deploy de CI desde el HTML output final y se descarga fragmentariamente por el cliente, así que la búsqueda funciona sin un servidor backend.

Nuevas páginas de documentación cubren la sección Active Suppressions en la pestaña Settings y el dropdown Dismiss por evento en el modal del Health Monitor, ambas con capturas reflejando la nueva UI.

---

🔧 Otras mejoras

• Sección AI Enhancement en Notifications — reescrita de una fila uppercase atenuada que los testers consistentemente scrolleaban sin ver, a un label foreground normal-case con un icono Sparkles líder y un badge persistente (verde Active cuando IA está habilitada, neutro Optional cuando no lo está) para que la feature sea descubrible independientemente del estado.
• Monitorización de temperatura de discos — readings mejorados, caching más inteligente entre probes SMART, y un modal de historia rediseñado que abre a 24 h por defecto con estadísticas min / avg / max.
• Detección de updates de funciones post-install — el Monitor trackea optimizaciones ProxMenux instaladas (Log2Ram, Memory Settings, System Limits, Logrotate, …) y notifica cuando hay una versión más nueva disponible, con apply one-click desde Settings.
• Flujo de update de Secure Gateway (Tailscale) — update one-click de Tailscale desde Settings con indicadores Last-checked / Installed / Latest y notificación cuando se publica una nueva versión.
• Menú Helper-Scripts — context más rico e información útil para cada entrada, haciendo más fácil saber qué hace cada script antes de ejecutarlo.
• Wording de agregación burst — los resúmenes burst reportan ahora solo los eventos adicionales que llegaron después de la alerta individual inicial, de forma que el operador ya no ve el primer evento contado dos veces.
• Clasificador de errores conocidos — regex con word-boundary en patrones ATA / UNC para que mensajes de kernel como nvidia_uvm:FatalError ya no se clasifiquen mal como problemas de cable ATA.
• Errores de control de VM / CT — start / stop / restart fallido surfacea ahora el stderr real de pvesh (p. ej. "no space left on device") en el toast de la UI y dispara una notificación vm_fail / ct_fail, en lugar del bare 500 INTERNAL SERVER ERROR que el operador solía ver.
• Path de apply de log2ram — el flujo auto / update reinicia ahora log2ram después de escribir el nuevo size, de forma que un 512M configurado realmente surte efecto en el tmpfs corriendo sin restart manual.
• PVE webhook URL — el webhook de notificación sigue ahora automáticamente el estado SSL activo, cambiando entre http:// y https:// cuando toggleas HTTPS en el panel.
• Cascada de 401 frontend — la login screen ya no se traga un 401 para siempre tras un estado breve de token rancio; la flag de dedup se limpia al mount y al login exitoso.

---

🙏 Acknowledgments

Esta release incluye contribuciones de código directas de la comunidad y una cantidad sustancial de feedback que dio forma al diseño. Particular agradecimiento a:

Contributors de código

@jcastro entregó cinco mejoras directas que shipean con v1.2.2:

• Selección de ISOs de VM desde todos los almacenamientos ISO — nuevo helper compartido scripts/global/iso_storage_helpers.sh más integración en vm_creator.sh, select_linux_iso.sh y select_windows_iso.sh. El picker de ISO lee ahora desde cada almacenamiento Proxmox tagueado como ISO content en lugar de estar pinned a local. Commit 092b548d.
• Selector de canal de release en Settings — un menú proper bajo scripts/menus/config_menu.sh para flipear entre los canales de install estable y beta in-place, con la gestión correcta de version.txt / beta_version.txt en cada lado. Commit f8a8c43d.
• ZFS autotrim en el auto post-install — auto_post_install.sh habilita ahora autotrim=on en pools ZFS root por defecto (con el disable correspondiente en el path de uninstall), de forma que installs SSD-backed reclaman espacio liberado sin intervención manual. Commit 8877f987.
• Detección de webhook loopback + handoff de update — flask_notification_routes.py clasifica correctamente webhooks de 127.0.0.1 / localhost como loopback, y el handoff de update del script menu ya no flackea en edge cases. Commit 70ab072c.
• Figurine bumped a 2.0.0 — refresh del banner tool en customizable_post_install.sh, con la página de docs actualizada para matchear. Commit aba94028.

@pespinel arregló una regresión del beta-installer que rompía los paths de servicio tras el move al nuevo layout runtime — install_proxmenux_beta.sh resuelve ahora los paths correctos de la unit systemd en first install y en update. Commit 0daab74a.

Field reports que dieron forma al trabajo de GPU + Coral

Los reports detallados y sugerencias de @ghosthvj sobre el flujo de hardware passthrough impulsaron las mejoras de scripts de GPU en esta release. Los fixes del instalador NVIDIA, el hardening del lifecycle de GPU + audio acompañante en switch_gpu_mode.sh, y el checklist de audio-companion iGPU en add_gpu_vm.sh::detect_optional_gpu_audio empezaron todos desde sus reports de edge cases que los paths de código previos manejaban pobremente.

Todos los demás

Un gracias enorme a cada usuario que abrió un issue en GitHub, comentó en GitHub Discussions, reportó un bug en el canal de la comunidad, o pasó a compartir qué funcionaba y qué no en su hardware. Muchas de las mejoras internas en esta release — el stagger del scheduler de smartctl, el fix de caché de fail2ban, el reemplazo lxc-info /proc, el handshake del terminal HTTPS, la detección de kernel-update en PVE 9.x, todo el wiring de Apprise — empezaron como un report de alguien encontrándose con el problema. Seguid llegando.

---

2026-04-20

Nueva versión ProxMenux v1.2.1 — SR-IOV Awareness & GPU Passthrough Hardening

Release puntual sobre v1.2.0 que aborda tres áreas reportadas por la comunidad y que necesitaban arreglo antes del siguiente ciclo estable: reconocimiento completo de SR-IOV en todo el subsistema GPU/PCI, gestión robusta de los dispositivos de audio acompañantes de la GPU durante el attach y detach de passthrough (Intel iGPU con audio del chipset, tarjetas discretas con audio HDMI, VMs con GPU mixta), y fixes de compatibilidad para los proveedores de notificaciones con IA (endpoints custom OpenAI-compatible tipo LiteLLM/MLX/LM Studio, modelos de razonamiento de OpenAI, y modelos thinking de Gemini 2.5+/3.x). También incluye mejoras de calidad de vida en el instalador NVIDIA, el Monitor de salud de discos, y los helpers de ciclo de vida de LXC usados por los wizards de passthrough.

---

🎛️ SR-IOV Awareness en todo el subsistema GPU

Intel i915-sriov-dkms y AMD MxGPU dividen la Physical Function (PF) de una GPU en Virtual Functions (VFs) que pueden asignarse de forma independiente a LXCs y VMs. Anteriormente ProxMenux no tenía reconocimiento alguno de SR-IOV: trataba VFs y PFs de manera idéntica, lo que podía reescribir vfio.conf con el vendor:device ID de la PF, colapsar el árbol de VFs en el siguiente arranque, y dejar a los usuarios sin poder iniciar sus guests. Se ha auditado y endurecido cada ruta que pudiera alterar un árbol de VFs activo.

Helpers de detección

• Nuevos _pci_is_vf, _pci_has_active_vfs, _pci_sriov_role, _pci_sriov_filter_array en scripts/global/pci_passthrough_helpers.sh
• Equivalentes HTTP/JSON en la ruta Flask de GPU — la UI del Monitor lee el estado VF/PF directamente desde sysfs (physfn, sriov_totalvfs, sriov_numvfs, virtfn*)

Pre-start hook (gpu_hook_guard_helpers.sh)

El guard pre-start de las VMs ahora reconoce Virtual Functions. Tanto la rama de sintaxis slot-only (que solía iterar todas las funciones del slot y exigir vfio-pci en todas) como la rama full-BDF saltan las VFs, de modo que Proxmox puede realizar su rebind vfio-pci por VF con normalidad. El falso bloqueo "GPU passthrough device is not ready" en VMs SR-IOV ha desaparecido.

Los scripts de mode-switch rechazan operaciones SR-IOV

switch_gpu_mode.sh, switch_gpu_mode_direct.sh, add_gpu_vm.sh, add_gpu_lxc.sh, vm_creator.sh, synology.sh, zimaos.sh y add_controller_nvme_vm.sh rechazan ahora las VFs y las PFs con VFs activas antes de tocar la configuración del host. Un dialog claro "SR-IOV Configuration Detected" explica la situación. Para los wizards invocados en mitad de flujo (creadores de VM) el mensaje se entrega por whiptail para que interrumpa limpiamente, seguido de una línea msg_warn por dispositivo para dejar rastro en el log.

Nuevo estado "SR-IOV active" en la UI del Monitor

La tarjeta GPU de la página Hardware gana un tercer estado visual con un color teal dedicado, una pill in-line SR-IOV ×N (o SR-IOV VF para una Virtual Function), y ramas LXC y VM en discontinuo/atenuadas. El botón Edit se oculta porque el estado está gestionado por hardware.

Modal dashboard para GPUs SR-IOV

Al abrir el modal de una Physical Function con VFs activas se muestra ahora:

• Banner de métricas agregadas ("Metrics below reflect the Physical Function, aggregate across N VFs")
• Telemetría normal en tiempo real de la GPU para la PF
• Una tabla Virtual Functions, una fila por VF, con el driver actual (i915, vfio-pci, unbound) y la VM o LXC específica que la consume, incluyendo el estado running/stopped — los consumidores se descubren cruzando entradas hostpci y líneas de mount /dev/dri/renderDN contra el BDF de la VF y el nodo DRM render

Al abrir el modal de una Virtual Function se muestran su PF padre (clickable para navegar de vuelta al modal de la PF), el driver actual y el consumidor.

El popup de VM Conflict Policy ya no se dispara para VFs de SR-IOV

La regex en detect_affected_vms_for_selected casaba el slot (00:02) contra VMs que tenían una VF (00:02.1) asignada, produciendo un dialog confuso "Keep GPU in VM config". Con el gate SR-IOV upstream, el flujo nunca llega a ese camino de código para slots SR-IOV.

---

🔊 GPU + Audio Passthrough — Hardening de ciclo de vida completo

Una ronda de fixes en torno a cómo el passthrough de GPU gestiona su dispositivo de audio acompañante. Anteriormente, solo se recogía automáticamente el hermano .1 de una GPU discreta; el passthrough de iGPU Intel a una VM — donde el audio vive separado en el chipset en 00:1f.3 y no en 00:02.1 — se saltaba silenciosamente. En el detach, el viejo sed que limpiaba líneas hostpci por substring de slot también podía eliminar una GPU no relacionada cuyo BDF contuviera el slot buscado como substring (p. ej. el slot 00:02 casando dentro de 0000:02:00.0). Ambos caminos son ahora robustos.

Checklist de audio-companion de iGPU en el attach

add_gpu_vm.sh::detect_optional_gpu_audio mantiene la fast path de auto-include para el clásico hermano .1 (NVIDIA / AMD discretas con audio HDMI en la tarjeta). Cuando no existe audio .1, el script ahora:

• Escanea sysfs en busca de cada controlador PCI de audio del host
• Salta cualquier cosa ya cubierta por el IOMMU group de la GPU
• Pregunta al usuario mediante un _pmx_checklist (dialog en modo standalone, whiptail en modo wizard llamado desde vm_creator/synology/zimaos) qué controladores de audio pasar junto con la GPU
• Muestra cada entrada con su driver actual en el host (snd_hda_intel, snd_hda_codec_*, etc.) para que la decisión sea informada
• Por defecto none — el usuario opta activamente por incluirlos

Cascada de audio huérfano en el detach

Cuando el usuario elige "Remove GPU from VM config" durante un mode switch, los scripts hacen ahora un seguimiento con limpieza dirigida:

• switch_gpu_mode.sh, switch_gpu_mode_direct.sh y add_gpu_vm.sh::cleanup_vm_config (limpieza de la VM origen en el flujo "move GPU") llaman todos al helper compartido _vm_list_orphan_audio_hostpci
• El helper usa un escaneo en dos pasadas del config de la VM: pasada 1 registra las bases de slot de las entradas hostpci display/3D; pasada 2 clasifica las entradas de audio y salta cualquier audio cuyo slot aún tenga un hermano display en la misma VM — protegiendo el audio HDMI de otras dGPUs que queden en la VM
• Antes el simple match por substring habría marcado el 02:00.1 de NVIDIA como huérfano al hacer detach de una iGPU Intel en 00:02.0
• El flujo interactivo de switch confirma las eliminaciones con un checklist de dialog (por defecto ON). La variante web hace auto-remove sin preguntar — el runner no tiene buena forma de renderizar un checklist — y loguea cada BDF que ha tocado

Extensión de la cascada a vfio.conf

Para cada audio eliminado por la cascada, los scripts de switch-mode comprueban ahora si su BDF sigue referenciado por cualquier otra VM vía _pci_bdf_in_any_vm. Si nada más lo usa, el vendor:device se añade a SELECTED_IOMMU_IDS antes de que se ejecute el update de /etc/modprobe.d/vfio.conf. Eso cierra el bucle para el caso de la iGPU Intel: 8086:51c8 (PCH HD Audio) se retira ahora de vfio.conf junto con 8086:46a3 (iGPU) cuando ambos salen del modo VM y ninguna otra VM los referencia. Si otra VM aún usa el audio, el ID se conserva deliberadamente — sin efectos secundarios rompedores sobre otras VMs. add_gpu_vm.sh NO extiende la limpieza en el flujo move, porque la GPU sigue en uso en otro sitio y sus IDs deben permanecer.

Regex precisa de eliminación de hostpci

Cada sed inline usado para hacer detach de una GPU del config de una VM casaba antes el slot como substring libre:

/^hostpci[0-9]+:.*${slot}/d

Para slot=00:02 ese patrón casa la substring dentro de 0000:02:00.0 (una dGPU NVIDIA no relacionada en el slot 02:00) y borraría ambas tarjetas. El fix ancla el match a la forma BDF real:

/^hostpci[0-9]+:[[:space:]]*(0000:)?${slot}\.[0-7]([,[:space:]]|$)/d

Aplicado en switch_gpu_mode.sh, switch_gpu_mode_direct.sh y add_gpu_vm.sh::cleanup_vm_config. El helper basado en awk en vm_storage_helpers.sh::_remove_pci_slot_from_vm_config (usado por los wizards NVMe) ya usaba el patrón correcto y no necesitó cambios.

---

🤖 Compatibilidad de proveedores de IA — OpenAI-Compatible, modelos Reasoning y Thinking

Tres fixes coordinados que desbloquean categorías de modelos previamente rechazadas por el pipeline de mejora de notificaciones.

Endpoints OpenAI-compatible

LiteLLM, MLX, LM Studio, vLLM, LocalAI, Ollama-proxy — el list_models() del proveedor exigía antes "gpt" en cada nombre de modelo, así que los setups locales sirviendo mlx-community/..., Qwen3-..., mistralai/... veían una lista de modelos vacía. Cuando se establece una Custom Base URL, la comprobación de substring "gpt" se omite ahora y EXCLUDED_PATTERNS (embeddings, whisper, tts, dall-e) es el único filtro. La capa de ruta Flask también deja de intersectar el resultado contra verified_ai_models.json para endpoints custom — la lista verificada solo describe los IDs oficiales de modelo de OpenAI y estaba borrando cada modelo local que el usuario realmente servía.

Modelos reasoning de OpenAI

o1, o3, o3-mini, o4-mini, gpt-5, gpt-5-mini, gpt-5.1, gpt-5.2-pro, gpt-5.4-nano, etc. (excluyendo las variantes *-chat-latest) usan un contrato API más estricto: max_completion_tokens en lugar de max_tokens, sin temperature. Enviar los parámetros clásicos de chat producía HTTP 400 Bad Request para todos ellos. Un detector en openai_provider.py bifurca ahora el payload en consecuencia y establece reasoning_effort: "minimal" — por defecto estos modelos gastan su presupuesto de output en razonamiento interno y devuelven una respuesta vacía para la breve petición de traducción de notificación.

Modelos thinking de Gemini 2.5+ / 3.x

gemini-2.5-flash, 2.5-pro, gemini-3-pro-preview, gemini-3.1-pro-preview, etc. tienen "thinking" interno activado por defecto. Con el pequeño presupuesto de tokens usado para el enriquecimiento de notificaciones (≤250 tokens), el presupuesto de thinking consumía toda la asignación y el modelo devolvía output vacío con finishReason: MAX_TOKENS. gemini_provider.py establece ahora thinkingConfig.thinkingBudget: 0 para variantes no-lite de 2.5+ y 3.x, de modo que los tokens disponibles van a la respuesta visible al usuario. Las variantes lite (sin thinking activado) quedan intactas.

---

📋 Refresh de Verified AI Models

AppImage/config/verified_ai_models.json refrescado para los proveedores re-testeados contra APIs en vivo. La nueva herramienta privada de mantenimiento (mantenida fuera de la AppImage) re-ejecuta un test estandarizado de translate+explain contra cada modelo que anuncia cada proveedor, clasifica pass / warn / fail, e imprime un snippet JSON listo para pegar. Re-ejecutar antes de cada release de ProxMenux para mantener la lista al día.

Provider	New recommended	Notes
OpenAI	gpt-4.1-nano	gpt-4.1-nano, gpt-4.1-mini, gpt-4o-mini, gpt-4.1, gpt-4o, gpt-5-chat-latest, más gpt-5.4-nano / gpt-5.4-mini desde 2026-03. Snapshots con fecha y modelos legacy excluidos. Modelos reasoning soportados por el código pero no listados por defecto — más lentos / más caros sin mejorar la calidad de las notificaciones
Gemini	gemini-2.5-flash-lite	gemini-2.5-flash-lite, gemini-2.5-flash (funciona ahora), gemini-3-flash-preview. Aliases latest omitidos intencionadamente — resolvían a modelos distintos entre ejecuciones y producían timeouts en algunas regiones. Las variantes Pro rechazan thinkingBudget=0 y son excesivas para traducción de notificaciones
Groq / Anthropic / OpenRouter	sin cambios	Marcados con un _note — se re-verificarán en cuanto haya keys disponibles

---

🩺 Monitor de salud de discos — Persistencia de observaciones en el journal watcher

Un bug latente en notification_events.py::_check_disk_io hacía que los errores de I/O del kernel en tiempo real capturados por el journal watcher se superficiaran como notificaciones pero nunca se escribieran en la tabla permanente de observaciones por disco. En la práctica el escaneo paralelo periódico de dmesg solía registrar la observación poco después, pero bajo casos límite de timing (ventana de dmesg obsoleta, restart de servicio justo después del error, rotación de buffer) la observación podía perderse.

El journal watcher registra ahora la observación antes del gate de cooldown de notificación de 24h, usando la misma clasificación de signature por familia (io_<disk>_ata_connection_error, io_<disk>_block_io_error, io_<disk>_ata_failed_command) que el escaneo periódico. Ambos caminos deduplican ahora en la misma fila vía el UPSERT en record_disk_observation, de modo que los conteos de ocurrencias son precisos sin importar qué detector disparó primero.

---

🔧 Pulido del instalador NVIDIA

Race condition de lsmod silenciada

Durante la reinstalación, la verificación de unload de módulos en unload_nvidia_modules producía errores espurios lsmod: ERROR: could not open '/sys/module/nvidia_uvm/holders' porque lsmod lee /proc/modules y luego abre el directorio holders/ de cada módulo, que desaparece transitoriamente mientras el módulo está siendo eliminado. La comprobación lee ahora /proc/modules directamente e inserta sleeps cortos para dejar que el kernel finalice el unload antes de re-verificar. Aplicado en el mismo espíritu a los otros cuatro call sites de lsmod en el script.

Dialog → whiptail en el flujo de update LXC

El mensaje "Insufficient Disk Space" en update_lxc_nvidia y la confirmación "Update NVIDIA in LXC Containers" usan ahora dialogs estilo whiptail consistentes con el resto del messaging in-flow, evitando la rotura visual que dialog --msgbox causaba al renderizarse en mitad de la secuencia en la fase de update de contenedores.

---

🧵 Helper de ciclo de vida LXC — Stop seguro con timeout

Un pct stop simple puede colgarse indefinidamente cuando el contenedor tiene un lock obsoleto de una operación abortada previa, cuando los procesos de dentro (Plex, Jellyfin, bases de datos) ignoran TERM y caen en uninterruptible-sleep mientras la GPU que estaban usando es arrancada, o cuando pct shutdown --timeout no es respetado por pct mismo. Reportes de campo de esperas de 5+ min durante mode switches de GPU hicieron de esto un peligro real de UX.

Nuevo helper compartido _pmx_stop_lxc <ctid> [log_file] en pci_passthrough_helpers.sh:

1. Devuelve 0 inmediatamente si el contenedor no está corriendo
2. pct unlock best-effort (silencioso ante fallo) — la mayoría de contenedores no están realmente bloqueados; solo nos importan los casos en que lo están
3. pct shutdown --forceStop 1 --timeout 30 envuelto en un timeout 45 externo para no esperar nunca más que eso a la fase graceful, incluso si pct se atasca en I/O del backend
4. Verifica el estado real vía pct status — pct puede devolver no-cero mientras el contenedor está de hecho parado
5. Si sigue corriendo, pct stop envuelto en timeout 60. Verificar de nuevo
6. Devuelve 1 solo si el contenedor está realmente atascado tras ~107 s totales — el wizard continúa en lugar de colgarse

Cableado en las tres rutas de modo GPU que paran LXCs durante un switch: switch_gpu_mode.sh, switch_gpu_mode_direct.sh, y add_gpu_vm.sh::cleanup_lxc_configs.

---

⚙️ Estabilidad del prompt de reboot en add_gpu_vm.sh

El prompt final "Reboot Required" del wizard de asignación GPU-a-VM estaba disparando reboots espurios en ciertas invocaciones de cadena de menú (menu → main_menu → hw_grafics_menu → add_gpu_vm). Con el helper _pmx_yesno a veces devolvía exit 0 sin que el usuario hubiera confirmado realmente, llamando reboot de inmediato. Con un read simple en su lugar el proceso quedaba suspendido por SIGTTIN cuando la cadena de menú desligaba el script del grupo de proceso foreground del terminal, dejando [N]+ Stopped menu en el shell padre sin posibilidad de responder.

El prompt usa ahora whiptail --yesno invocado directamente (el patrón verificado para funcionar de forma fiable en esa cadena de menú) e inserta una pausa Press Enter to continue ... read -r entre la respuesta "Yes" y la llamada real a reboot — de modo que un Enter accidental en el botón de confirmar no puede disparar un reboot inmediato sin un paso de confirmación visible primero.

---

🙏 Gracias

Gracias a los usuarios que reportaron los casos de SR-IOV, LiteLLM/MLX y GPU + audio — estas mejoras existen gracias a reportes detallados y reproducibles. No dudéis en seguir reportando issues o sugiriendo mejoras 🙌.

---

2026-04-17

Nueva versión ProxMenux v1.2.0 — AI-Enhanced Monitoring

Esta release es la culminación del ciclo beta v1.1.9.1 → v1.1.9.6 e introduce la mayor evolución de ProxMenux Monitor hasta la fecha: notificaciones mejoradas con IA, un sistema de notificaciones multicanal rediseñado, una experiencia de hardware y almacenamiento totalmente reelaborada, y mejoras amplias de rendimiento en todo el stack de monitorización. También consolida todo el trabajo reciente en los scripts de Storage, Hardware y GPU/TPU.

---

🤖 ProxMenux Monitor — Notificaciones mejoradas con IA

Las notificaciones pueden mejorarse ahora usando IA para generar mensajes claros y contextuales en lugar del output técnico crudo.

Ejemplo — en lugar de backup completed exitcode=0 size=2.3GB, la IA produce: "The web server backup completed successfully. Size: 2.3GB".

Lo que hace la IA

• Transforma notificaciones técnicas en mensajes legibles
• Traduce a tu idioma preferido
• Te deja elegir el nivel de detalle: minimal, standard o detailed
• Funciona con Telegram, Discord, Email, Pushover y Webhooks

Lo que la IA NO hace

• No es un chatbot ni un asistente
• No analiza tu sistema ni toma decisiones
• No tiene acceso a datos más allá de la notificación que está procesando
• No ejecuta comandos ni modifica el servidor
• No almacena historial ni aprende de tus datos

Soporte multi-proveedor

Elige entre 6 proveedores de IA, cada uno con su propia API key almacenada de forma independiente:

• Groq — inferencia rápida, free tier generoso
• Google Gemini — excelente relación calidad/precio, free tier disponible
• OpenAI — estándar de la industria
• Anthropic Claude — excelente para escritura y traducción
• OpenRouter — 300+ modelos con una sola API key
• Ollama — ejecución 100% local, sin internet

Verified AI Models

Una lista curada de modelos (verified_ai_models.json) testeada específicamente para mejora de notificaciones.

• Verificación híbrida: el sistema obtiene los modelos del lado del proveedor y filtra para mostrar solo los testeados que funcionan correctamente
• Memoria de modelo por proveedor: el modelo seleccionado se guarda por proveedor, de modo que cambiar de proveedor preserva cada elección
• Verificación diaria: una tarea en background comprueba la disponibilidad de modelos y migra automáticamente a una alternativa verificada si el modelo actual desaparece
• Modelos incompatibles excluidos: Whisper, TTS, image/video, embeddings, guard models, etc. se filtran por proveedor

Provider	Recommended	Also Verified
Gemini	gemini-2.5-flash-lite	gemini-flash-lite-latest
OpenAI	gpt-4o-mini	gpt-4.1-mini
Groq	llama-3.3-70b-versatile	llama-3.1-70b-versatile, llama-3.1-8b-instant, llama3-70b-8192, llama3-8b-8192, mixtral-8x7b-32768, gemma2-9b-it
Anthropic	claude-3-5-haiku-latest	claude-3-5-sonnet-latest, claude-3-opus-latest
OpenRouter	meta-llama/llama-3.3-70b-instruct	meta-llama/llama-3.1-70b-instruct, anthropic/claude-3.5-haiku, google/gemini-flash-2.5-flash-lite, openai/gpt-4o-mini, mistralai/mixtral-8x7b-instruct
Ollama	(todos los modelos locales)	Sin filtrado — muestra todos los modelos instalados

Custom AI Prompts

Los usuarios avanzados pueden definir su propio prompt para tener control total sobre el formato y la traducción.

• Selector de Prompt Mode — Default Prompt o Custom Prompt
• Export / Import — guarda y comparte prompts custom entre instalaciones
• Example Template — punto de partida para construir tu propio prompt
• Community Prompts — enlace directo a GitHub Discussions para compartir plantillas
• El selector de idioma se oculta en modo Custom Prompt (defines el idioma de salida en el propio prompt)

Contexto enriquecido

• El uptime del sistema se incluye solo para eventos de error/warning (no informativos) — ayuda a distinguir errores de arranque vs runtime
• Tracking de frecuencia de eventos — indica problemas recurrentes vs puntuales
• Datos de SMART disk health pasados para errores relacionados con discos
• La base de datos de errores conocidos de Proxmox mejora la precisión del diagnóstico
• Instrucciones de prompt más claras para prevenir alucinaciones de la IA

---

📨 Rediseño del sistema de notificaciones

• Arquitectura multicanal — canales Telegram, Discord, Pushover, Email y Webhook corriendo simultáneamente
• Configuración por evento — habilita/deshabilita tipos de evento específicos por canal
• Channel Overrides — personaliza el comportamiento de notificación por canal
• Endpoint webhook seguro — sistemas externos pueden enviar notificaciones autenticadas
• Almacenamiento cifrado — API keys y datos sensibles guardados cifrados
• Procesamiento basado en cola — worker en background con reintento automático para notificaciones fallidas
• Almacenamiento de config basado en SQLite — reemplaza el config basado en ficheros para mayor fiabilidad

Soporte de Telegram Topics

Envía notificaciones a un topic específico dentro de grupos con Topics habilitado.

• Nuevo campo Topic ID en el canal Telegram
• Detección automática de grupos con topics habilitados
• Totalmente retrocompatible

Notificaciones de update de ProxMenux

El Monitor detecta ahora cuándo se publica una nueva versión de ProxMenux.

• Doble canal — monitoriza tanto stable (version.txt) como beta (beta_version.txt)
• Integración con GitHub — compara versiones locales vs remotas
• Dashboard Update Indicator — el logo de ProxMenux cambia a una variante de update cuando se detecta una nueva versión (no intrusivo, sin popups)
• Estado persistente — el estado se guarda en config.json, reseteado por los scripts de update
• Un único toggle en Settings controla ambos canales (habilitado por defecto)

---

🖥️ Panel de Hardware — Detección ampliada

La página Hardware se ha ampliado significativamente, con mejor detección y detalle por dispositivo más rico.

• Controladoras SCSI / SAS / RAID — modelo, driver y slot PCI mostrados en la sección de storage controllers
• Detección de PCIe Link Speed — los drives NVMe muestran la velocidad de link actual (generación PCIe y ancho de carriles), facilitando detectar drives que rinden por debajo por ancho de banda limitado del slot
• Modal de detalle de disco mejorado — los drives NVMe, SATA, SAS y USB exponen ahora sus campos específicos (info de link PCIe, versión/velocidad SAS, tipo de interfaz) en lugar de una vista genérica
• Reconocimiento más inteligente de tipo de disco — etiquetado uniforme para NVMe SSDs, SATA SSDs, HDDs y discos extraíbles
• Caching de Hardware Info (lspci, lspci -vmm) — la caché de 5 min evita escaneos repetidos de datos que no cambian

---

💽 Storage Overview — Salud, observaciones, exclusiones

El Storage Overview se ha reelaborado en torno al estado en tiempo real y al tracking controlado por el usuario.

Alineación del estado de salud de disco

• Los badges reflejan ahora el estado actual SMART reportado por Proxmox, no un peor histórico
• Observaciones preservadas — los hallazgos históricos siguen accesibles vía el badge "X obs."
• Recuperación automática — cuando SMART reporta healthy de nuevo, el disco muestra inmediatamente Healthy
• Eliminado el viejo tracking worst_health que requería limpieza manual

Mejoras del registro de discos

• Lookup inteligente por serial — cuando un serial es desconocido el sistema comprueba si existe una entrada con serial antes de insertar una nueva
• Sin duplicados — previene entradas separadas para el mismo disco apareciendo con/sin serial
• Soporte de discos USB — gestiona drives USB que pueden aparecer bajo nombres de dispositivo distintos entre reboots

Exclusiones de Storage e interfaces de Red

• Sección Storage Exclusions — excluye drives de la monitorización de salud y notificaciones
• Network Interface Exclusions — nueva sección para excluir interfaces (bridges vmbr, bonds, NICs físicas, VLANs) de salud y notificaciones; ideal para interfaces deshabilitadas intencionadamente que de otro modo generarían falsas alertas
• Toggles separados por ítem para Health monitoring y Notifications

Robustez en la detección de discos

• Validación de Power-On-Hours — detecta y corrige valores absurdamente grandes (miles de millones de horas) en drives con codificación SMART no estándar
• Bit masking inteligente — extrae el valor correcto de drives que empaquetan info extra en bytes altos
• Fallback elegante — muestra "N/A" en lugar de números imposibles cuando los datos no pueden parsearse

---

🧠 Monitor de salud y ciclo de vida de errores

Limpieza de errores obsoletos

Los errores de recursos que ya no existen se resuelven ahora automáticamente.

• VMs / CTs eliminadas — los errores relacionados se auto-resuelven cuando se elimina el recurso
• Discos retirados — los errores de drives USB desconectados o hot-swap se limpian
• Cambios de cluster — los errores de cluster se limpian cuando un nodo abandona el cluster
• Patrones de log — los errores basados en logs se auto-resuelven tras 48 horas sin recurrencia
• Updates de seguridad — las notificaciones de update se auto-resuelven tras 7 días

Sistema de migración de base de datos

• Detección automática de columnas — las columnas faltantes se añaden en el arranque
• Compatibilidad de schema — funciona tanto con convenciones de nombrado de columna antiguas como nuevas
• Retrocompatible — se soportan bases de datos de versiones anteriores de ProxMenux
• Migración elegante — sin pérdida de datos durante updates de schema

---

🧩 Modal de detalle VM / CT

El modal de detalle VM/CT se ha rediseñado por completo para mejorar la usabilidad.

• Navegación con tabs — Overview (información general, estado, uso de recursos) y Backups (historial dedicado)
• Mejoras visuales — iconos en todo, jerarquía y espaciado mejorados, mejor distinción VM vs CT
• Adaptación a móvil — se adapta correctamente a pantallas móviles tanto en webapp como en acceso directo por navegador, sin más overflow en dispositivos pequeños
• Controles touch-friendly — botones y espaciado mayores

Modal de Secure Gateway

• Lista de storage con scroll cuando hay muchos destinos disponibles
• Layout adaptado a móvil y jerarquía visual mejorada

Conexión de terminal

• Fix de bucle de reconexión que afectaba a dispositivos móviles
• Manejo mejorado de WebSocket para navegadores móviles
• Recuperación más elegante de timeouts de conexión

Gestión de Fail2ban y Lynis

• Botones de delete añadidos en Settings para ambas herramientas
• Eliminación limpia de paquetes y ficheros de configuración
• Dialog de confirmación para prevenir borrado accidental

---

⚡ Optimizaciones de rendimiento

Reducción importante de uso de CPU y eliminación de picos en el Monitor.

Intervalos de polling escalonados

Los collectors corren ahora en schedules con offset para prevenir ejecución simultánea:

Collector	Schedule
CPU sampling	Cada 30s en offset 0
Temperature sampling	Cada 15s en offset 7s
Latency pings	Cada 60s en offset 25s
Temperature record	Cada 60s en offset 40s
Health collector	Arranca en offset 55s
Notification polling	Health=10s, Updates=30s, ProxMenux=45s, AI=50s

Información de sistema cacheada

Los comandos costosos se cachean ahora para reducir ejecución repetida:

Command	Cache TTL	Impact
pveversion	6 horas	Elimina picos de CPU del 23%+ por ejecución de Perl
apt list --upgradable	6 horas	Reduce consultas del gestor de paquetes
pvesh get /cluster/resources	30 segundos	6 llamadas API por request reducidas a 1
sensors	10 segundos	Lecturas de temperatura cacheadas entre polls
smartctl (SMART health)	30 minutos	Health checks de disco reducidos desde cada 5 min
lspci / lspci -vmm	5 minutos	Info de hardware cacheada (no cambia)
journalctl --since 24h	1 hora	Conteo de intentos de login cacheado (92% de reducción)

Timeouts de journalctl aumentados

Previene cascadas de timeout bajo carga del sistema:

Query Type	Before	After
Short-term (3-10 min)	3s	10s
Medium-term (1 hour)	5s	15s
Long-term (24 hours)	5s	20s

Frecuencia de polling reducida

• Intervalo de TaskWatcher subido de 2s → 5s (60% menos comprobaciones)

GitHub Actions

• Todas las actions de workflow actualizadas a v6 para compatibilidad con Node.js 24
• Warnings de deprecación eliminados en CI/CD

---

🧰 Scripts — Trabajo en Storage, Hardware y GPU/TPU

Esta release también consolida trabajo significativo en los scripts core de ProxMenux.

Scripts de Storage

• Tests SMART programados y flujo interactivo de test SMART mejorado con feedback de progreso más claro
• Reelaboración de formateo de disco (format-disk.sh) con selección de dispositivo más segura y flujo de dialog
• Disk passthrough para VMs y CTs — enumeración de dispositivos actualizada, identificación basada en serial, y teardown más limpio
• Adición de controladora NVMe para VMs — selección de tipo de controladora y detección de slot mejoradas
• Import disk image — validación de path más suave y reporte de progreso
• Refresh de la guía manual de Disk & storage

Scripts de Hardware / GPU / TPU

• Coral TPU installer actualizado para kernels y udev rules actuales (Proxmox VE 8 & VE 9)
• NVIDIA installer — instalación de driver más limpia, manejo de kernel headers, y flujo de attachment VM/LXC
• GPU mode switch (variantes directa e interactiva) — switching más seguro entre modos iGPU
• Add GPU to VM / LXC — dialogs de selección unificados y gestión de permisos
• Herramientas de GPU Intel / AMD mantenidas en sync con los nuevos patrones compartidos
• Hardware & graphics menu reestructurado para consistencia con el resto de ProxMenux

2026-03-14

Nueva versión v1.1.9 — Helper Scripts Catalog Rebuilt

Cambiado

• Helper Scripts Menu — Reconstrucción completa del catálogo El catálogo de Helper Scripts se ha reconstruido por completo para adaptarse a la nueva arquitectura de datos del proyecto Community Scripts.

  La implementación previa dependía de un fichero metadata.json que ya no existe en el repositorio upstream. El catálogo conecta ahora directamente a la API de PocketBase (db.community-scripts.org), que es la nueva fuente de datos oficial del proyecto.

  Un nuevo workflow de GitHub Actions genera un índice local helpers_cache.json que reemplaza la antigua dependencia de metadata. Esta nueva caché es más rica, más estructurada, e incluye:

  • Tipo de script, slug, descripción, notas y credenciales por defecto
  • Variantes de OS por script (p. ej. Debian, Alpine) — cada una mostrada como una opción seleccionable separada en el menú
  • URL directa de GitHub y URL Mirror (git.community-scripts.org) para cada script
  • Nombres de categoría embebidos directamente en la caché — sin necesidad de requests externos para construir el menú
  • Metadata adicional: puerto por defecto, website, logo, soporte de update, disponibilidad ARM

  Los scripts que soportan múltiples variantes de OS (p. ej. Docker con Alpine y Debian) muestran ahora correctamente una entrada por OS, cada una con su propia opción de descarga GitHub y Mirror — restaurando el comportamiento que existía antes de la migración upstream.

---

🎖 Reconocimiento especial

Esta actualización no habría sido posible sin la apertura y colaboración de los mantenedores de Community Scripts.

Cuando la estructura de metadata upstream cambió y rompió el catálogo de ProxMenux, los mantenedores respondieron rápidamente, explicaron la nueva arquitectura en detalle y proporcionaron toda la información necesaria para reconstruir la integración limpiamente.

Agradecimientos especiales a:

• MickLeskCanbiZ (@MickLesk) — por documentar la nueva estructura de path de scripts por tipo y slug, y por la guía técnica clara y directa.
• Michel Roegl-Brunner (@michelroegl-brunner) — por explicar la nueva estructura de colecciones de PocketBase (script_scripts, script_categories).

El proyecto Helper Scripts es un recurso extraordinario para la comunidad Proxmox. Los scripts pertenecen enteramente a sus autores y mantenedores — ProxMenux simplemente ofrece una forma guiada de descubrirlos y lanzarlos. Todo el crédito va a la comunidad detrás de community-scripts/ProxmoxVE.

2025-09-18

Nueva versión v1.1.8 — ProxMenux Offline Mode

---

Añadido

• Modo de ejecución offline (sin dependencia de GitHub)
  Todos los scripts core de ProxMenux se ejecutan ahora enteramente en local, sin requerir requests en vivo a GitHub (raw.githubusercontent.com).
  Este cambio proporciona:

  • Mayor estabilidad durante la ejecución
  • Sin interrupciones por timeouts de red o bloqueos regionales de GitHub
  • Soporte para entornos offline o aislados

  ⚠️ Esta actualización resuelve issues recientes donde usuarios en ciertas regiones eran incapaces de ejecutar scripts debido a errores de CDN o filtrado TLS al descargar ficheros .sh desde URLs raw de GitHub.

  🎖 Reconocimiento especial: @cod378
  Esta conversión offline ha sido posible gracias al extraordinario trabajo de @cod378,
  que rediseñó toda la lógica interna del installer y el updater, refactorizó el sistema de gestión de ficheros,
  e implementó el nuevo workflow de ejecución totalmente local.
  Sin su colaboración, dedicación y aportación técnica, esta transformación no habría sido posible.

• ProxMenux Monitor v1.0.1
  Esta actualización trae un gran salto en la interfaz de ProxMenux Monitor.
  Nuevas funciones y mejoras:

  • Proxy Support: Accede a ProxMenux a través de proxies inversos con plena funcionalidad
  • Authentication System: Asegura tu dashboard con protección por contraseña
  • Two-Factor Authentication (2FA): Soporte opcional TOTP para mayor seguridad
  • PCIe Link Speed Detection: Ver velocidades de conexión NVMe y detectar cuellos de botella de rendimiento
  • Enhanced Storage Display: Auto-formatea tamaños de disco (GB → TB cuando corresponde)
  • SATA/SAS Interface Info: Detecta y muestra el tipo de storage (SATA, SAS, NVMe, etc.)
  • Health Monitoring System: Health check integrado del sistema con alertas descartables
  • Renderizado mejorado entre navegadores y mejor rendimiento

• Helper Scripts Menu (Mirror Support)
  El menú Helper Scripts ahora:

  • Detecta URLs mirror y muestra opciones de descarga alternativas cuando están disponibles
  • Lista las versiones de OS disponibles cuando un helper script depende de la versión (p. ej. instaladores de plantillas)

---

Arreglado

• Fixes menores y refinamientos a lo largo del codebase para asegurar compatibilidad offline total y una experiencia de usuario más suave.

2025-09-04

Nueva versión v1.1.7

Añadido

• ProxMenux Monitor
  Tu nueva herramienta de monitorización para Proxmox. Descubre todas las funciones que te ayudarán a gestionar y supervisar tu infraestructura eficientemente.

  ProxMenux Monitor está diseñado para soportar futuras actualizaciones donde se puedan disparar acciones sin usar el terminal, gestionadas a través de una interfaz amigable accesible en múltiples formatos y dispositivos.

  Accede en: http://your-server-ip:8008

  

• Nuevo método de eliminación de banner
  Una nueva función para deshabilitar el mensaje de suscripción de Proxmox con seguridad mejorada:

  • Crea un backup completo antes de modificar ningún fichero
  • Muestra un warning claro de que pueden producirse breaking changes con futuras actualizaciones de la GUI
  • Si la GUI no carga, el usuario puede revertir los cambios por SSH desde el menú post-install usando la herramienta "Uninstall Options → Restore Banner"

  Gracias especiales a @eryonki por proporcionar el método mejorado.

---

Mejorado

• CORAL TPU Installer actualizado para PVE 9
  El instalador del driver CORAL TPU soporta ahora tanto Proxmox VE 8 como VE 9, asegurando compatibilidad con los kernels y udev rules más recientes.

• Instalación e integración de Log2RAM

  • La instalación de Log2RAM es ahora idempotente y puede ejecutarse con seguridad múltiples veces.
  • Ajusta automáticamente la configuración de journald para alinearse con el tamaño y comportamiento de Log2RAM.
  • Asegura que el journaling esté correctamente afinado para evitar overflows o agotamiento de RAM en sistemas con poca memoria.

• Función de optimización de Red (LXC + NFS)
  Mejorada para prevenir warnings de "martian source" en setups donde contenedores LXC comparten storage con VMs vía NFS dentro del mismo servidor.

• Progreso de APT Upgrade
  Al ejecutar actualizaciones completas del sistema vía ProxMenux, se muestra ahora una barra de progreso en tiempo real, dando al usuario visibilidad clara del proceso de update.

---

Arreglado

• Otras pequeñas mejoras y fixes para optimizar el rendimiento en runtime y eliminar bugs menores.

2025-01-10

Nueva versión v1.1.6

Añadido

• Nuevo menú: Mount and Share Manager
  Introducido un nuevo menú integral para gestionar recursos compartidos entre el host Proxmox y los contenedores LXC:

  Opciones de configuración del host:

  • Configure NFS Shared on Host - Añadir, ver y eliminar recursos NFS compartidos en el servidor Proxmox con gestión automática de exports
  • Configure Samba Shared on Host - Añadir, ver y eliminar recursos Samba/CIFS compartidos en el servidor Proxmox con configuración de share
  • Configure Local Shared on Host - Crear y gestionar directorios locales compartidos con los permisos adecuados en el host Proxmox

  Opciones de integración LXC:

  • Configure LXC Mount Points (Host ↔ Container) - Función core que permite montar directorios del host dentro de contenedores LXC con gestión automática de permisos. Incluye la capacidad de ver los mount points existentes para cada contenedor de forma clara y organizada y eliminar mount points con verificación apropiada de que el proceso se completó con éxito. Especialmente optimizado para contenedores no privilegiados donde el mapeo UID/GID es crítico.
  • Configure NFS Client in LXC - Configura un cliente NFS dentro de contenedores privilegiados
  • Configure Samba Client in LXC - Configura un cliente Samba dentro de contenedores privilegiados
  • Configure NFS Server in LXC - Instala servidor NFS dentro de contenedores privilegiados
  • Configure Samba Server in LXC - Instala servidor Samba dentro de contenedores privilegiados

  Documentación y soporte:

  • Help & Info (commands) - Guías integrales con instrucciones manuales paso a paso para todos los escenarios de compartición

  Todo el sistema está construido en torno a la funcionalidad de LXC Mount Points, que detecta automáticamente los tipos de filesystem, gestiona el mapeo de permisos entre usuarios del host y del contenedor, y proporciona integración fluida tanto para contenedores privilegiados como no privilegiados.

---

Mejorado

• Mejora de auto-detección de Log2RAM
  En el script automático de post-install, la función de instalación de Log2RAM ahora pregunta al usuario cuando la detección automática de disco ssd/m2 falla. Esto asegura que Log2RAM pueda instalarse aún en sistemas donde la detección automática de disco no funciona correctamente.

---

Arreglado

• Verificación del repositorio de updates de Proxmox
  Arreglado un issue en la función de update de Proxmox donde los ficheros source vacíos del repositorio causaban errores durante la verificación de conflictos. La función gestiona ahora correctamente ficheros vacíos de /etc/apt/sources.list.d/ sin lanzar falsos warnings.

  Gracias a @JF_Car por reportar este issue.

---

Reconocimientos

Gracias especiales a @JF_Car, @ghosthvj y @jonatanc por sus pruebas, feedback valioso y sugerencias que ayudaron a refinar la funcionalidad de recursos compartidos y a mejorar la experiencia general de usuario.

2025-08-20

Nueva versión v1.1.5

Añadido

• Nuevo script: Upgrade PVE 8 a PVE 9
  Añadida una herramienta de upgrade completa ubicada bajo Utilities and Tools. Proporciona:

  1. Upgrade automático de PVE 8 a 9
  2. Upgrade interactivo con confirmaciones paso a paso
  3. Modo check-only usando check-pve8to9
  4. Instrucciones manuales mostradas en orden para usuarios que prefieren actualizar manualmente

• Nuevas herramientas en System Utilities

  • s-tui: Monitorización de CPU basada en terminal con gráficas
  • intel-gpu-tools: Útil para diagnósticos de GPU Intel

---

Mejorado

• Gestión de APT Upgrade
  La función de upgrade de PVE bloquea ahora el proceso si algún paquete pide confirmación manual. Esto evita upgrades parciales y asegura consistencia.

• Optimización de Red (sysctl)

  • Parámetros de kernel obsoletos eliminados (p. ej. tcp_tw_recycle, nf_conntrack_helper) para prevenir warnings en Proxmox 9 / kernel 6.14
  • Ahora genera solo parámetros sysctl válidos y al día

• Gestión de Patch de CPU AMD

  • Aplica ahora idle=nomwait correcto y opciones KVM (ignore_msrs=1, report_ignored_msrs=0)
  • El warning esperado está ahora documentado y gestionado con seguridad para estabilidad con Ryzen/EPYC

• Fixes de Timezone y NTP

  • Detecta automáticamente la timezone usando geolocalización por IP pública
  • Fallback a UTC si la detección falla
  • Reinicia Postfix tras establecer la timezone → resuelve el warning de mismatch /var/spool/postfix/etc/localtime

• Lógica del Repository & Package Installer

  • Verifica ahora que existan repositorios funcionales antes de instalar ningún paquete
  • Si no hay ninguno disponible, añade un repositorio Debian stable como fallback
  • Reemplaza el obsoleto mlocate por plocate (compatible con Debian 13 y Proxmox 9)

• Logs y Feedback de usuario mejorados

  • Las acciones que fallan proporcionan ahora mensajes precisos (en lugar de marcarse falsamente como éxito)
  • Ayuda a los usuarios a entender claramente qué se ha aplicado o saltado

2025-08-06

Nueva versión v1.1.4

Añadido

• Preparación de compatibilidad con Proxmox 9
  Esta versión prepara ProxMenux para el próximo Proxmox VE 9:

  • La función para añadir los repositorios oficiales de Proxmox soporta ahora el nuevo formato .sources usado en Proxmox 9, manteniendo retrocompatibilidad con Proxmox 8.
  • La eliminación de banner se soporta ahora opcionalmente para Proxmox 9.

• Detección de xshok-proxmox
  Añadida una comprobación para detectar si el script post-install xshok-proxmox ya ha sido ejecutado.
  Si se detecta, se muestra un warning para evitar ajustes conflictivos:

  It appears that you have already executed the xshok-proxmox post-install script on this system.
  
  If you continue, some adjustments may be duplicated or conflict with those already made by xshok.
  
  Do you want to continue anyway?
  

---

Mejorado

• Eliminación de banner (Proxmox 8.4.9+)
  Actualizada la lógica para eliminar el banner de suscripción en Proxmox 8.4.9, debido a cambios en proxmoxlib.js.

• LXC Disk Passthrough (UUID persistente)
  La función para añadir un disco físico a un contenedor LXC usa ahora paths persistentes basados en UUID.
  Esto asegura que los discos permanezcan correctamente montados, incluso si el orden /dev/sdX cambia por hardware nuevo.

  PERSISTENT_DISK=$(get_persistent_path "$DISK")
  if [[ "$PERSISTENT_DISK" != "$DISK" ]] ...
  

• System Utilities Installer
  Comprueba ahora si las sources APT están disponibles antes de instalar las herramientas seleccionadas.
  Si una nueva instalación de Proxmox no tiene repos activos, añadirá automáticamente las sources por defecto para evitar fallos de instalación.

• Activación de IOMMU en sistemas ZFS
  La función que habilita IOMMU para passthrough verifica ahora los parámetros de kernel existentes para evitar duplicación si el usuario ya los ha configurado manualmente.

---

Arreglado

• Limpieza de código menor y rendimiento de runtime mejorado en varios módulos.

2025-07-20

Cambiado

• Eliminación del banner de suscripción (Proxmox 8.4.5+)
  Mejorada la función remove_subscription_banner para asegurar compatibilidad con Proxmox 8.4.5, donde el método de eliminación de banner fallaba tras instalaciones limpias.

• Detección de Log2RAM mejorada
  Tanto en los scripts post-install automático como personalizable, se ha mejorado la lógica para la instalación de Log2RAM.
  Ahora detecta correctamente si Log2RAM ya está configurado y evita disparar errores o reconfiguración.

• Instalación de Figurine optimizada
  La función install_figurine evita ahora duplicar entradas en .bashrc si la personalización del prompt root ya existe.

Añadido

• Nueva función: Nombrado persistente de interfaces de Red
  Añadida una nueva función setup_persistent_network para crear nombres de interfaz de red estables usando ficheros .link basados en direcciones MAC.
  Esto evita renombrados impredecibles (p. ej. enp2s0 convirtiéndose en enp3s0) cuando cambia el hardware, se reordena la topología PCI o se aplican configuraciones de passthrough.

  ¿Por qué usar ficheros .link?
  Porque los nombres predecibles de interfaz en systemd pueden cambiar con reordenamientos o reemplazos de hardware. Usar ficheros .link estáticos atados a direcciones MAC asegura consistencia, especialmente en sistemas con múltiples NICs o setups de passthrough.

  Gracias especiales a [@Andres_Eduardo_Rojas_Moya] por contribuir la función de nombrado
  de red persistente y por la idea original.

[Match]
MACAddress=XX:XX:XX:XX:XX:XX

[Link]
Name=eth0

2025-07-01

Nueva versión v1.1.3

• Dos modos de instalación para ProxMenux
  El installer ofrece ahora dos modos distintos:

  1. Versión Lite (sin traducciones): Solo instala dos paquetes oficiales de Debian (dialog, jq) para habilitar menús y parsing JSON. No se escriben ficheros más allá del directorio de configuración.
  2. Versión Full (con traducciones): Usa un virtual environment y permite seleccionar el idioma de interfaz durante la instalación.

  Al actualizar, si el usuario cambia de full a lite, la versión vieja se eliminará automáticamente para una transición limpia.

Añadido

• Nuevo script: Setup automatizado de post-instalación
  Un nuevo script post-install minimal que realiza el setup esencial automáticamente:

  • Upgrade y sync del sistema
  • Eliminar el banner enterprise
  • Optimizar APT, journald, logrotate, límites del sistema
  • Mejorar gestión de kernel panic, ajustes de memoria, entropía, red
  • Añadir tweaks a .bashrc y auto-instalación de Log2RAM (si se detecta SSD/M.2)

• Nueva función: Configuración de Log2RAM
  Disponible ahora tanto en los scripts post-install personalizable como automático.
  En sistemas con SSD/NVMe, Log2RAM se habilita automáticamente para preservar la vida del disco.

• Nuevos menús:

  • 🧰 System Utilities Menu
    Permite a los usuarios seleccionar e instalar herramientas CLI útiles con validación de comando apropiada.
  • 🌐 Network Configuration & Repair
    Un nuevo menú interactivo para analizar y reparar interfaces de red.

Mejorado

• Lógica del menú Post-Install
  Las opciones están ahora agrupadas más lógicamente para mejor usabilidad.

• Menú VM Creation
  Mejorado con soporte mejorado de modelo de CPU y opciones custom.

• Script UUP Dump ISO Creator

  • Añadida opción para personalizar la ubicación de la carpeta temporal
  • Arreglado un issue donde se eliminaba la carpeta temp entera en lugar de solo el contenido
    💡 Sugerido por @igrokit
    #17, #11

• Script Physical Disk to LXC
  Gestiona ahora discos formateados con XFS correctamente.
  ¡Gracias a @antroxin por reportar y testear!

• System Utilities Installer
  Reescrito para verificar la disponibilidad del comando tras la instalación, asegurando que las herramientas funcionen como se espera.
  🐛 Fix para #18 por @DST73

Arreglado

• Habilitar IOMMU en ZFS
  La detección y configuración para habilitar IOMMU en sistemas basados en ZFS es ahora totalmente funcional.
  🐛 Fix para #15 por @troponaut

Otros

• Mejoras de rendimiento y limpieza de código en varios módulos.

2025-06-06

Añadido

• Nuevo menú: Proxmox PVE Helper Scripts
  Introducido oficialmente el nuevo menú Proxmox PVE Helper Scripts, reemplazando el anterior: Esenciales Proxmox.
  Este nuevo menú incluye:

  • Búsqueda de script por nombre en tiempo real
  • Navegación basada en categoría

  Es una forma más limpia, rápida y funcional de acceder a los scripts de la comunidad en Proxmox.

  

• Nuevos modelos de CPU en VM Creation
  El menú de selección de CPU en VM creation ha sido ampliado considerablemente para soportar perfiles avanzados de CPU QEMU y x86-64.
  Esto permite mejor compatibilidad con sistemas guest modernos y fine-tuning del rendimiento para workloads específicos, incluyendo virtualización anidada y funciones asistidas por hardware.

  

  Gracias a @Nida Légé (Nidouille) por sugerir esta mejora.

• Soporte para imágenes de disco .raw
  La herramienta de import de disco para VMs soporta ahora ficheros .raw, además de .img, .qcow2 y .vmdk.
  Esto mejora la compatibilidad cuando se trabaja con exports de disco de otros hypervisors o herramientas de backup.

  💡 Sugerido por @guilloking en GitHub Issue #5

• Detección de Locale al saltarse idiomas
  La función que deshabilita idiomas extra de APT incluye ahora:

  • Detección automática de locale (LANG)
  • Auto-generación de en_US.UTF-8 si no se encuentra ninguno
  • Previene warnings durante ejecución de scripts debido a locale indefinido

Mejorado

• Lógica de saltado de idioma APT
  La gestión mejorada de locale asegura compatibilidad del sistema antes de deshabilitar traducciones:

  if ! locale -a | grep -qi "^${default_locale//-/_}$"; then
      echo "$default_locale UTF-8" >> /etc/locale.gen
      locale-gen "$default_locale"
  fi
  

• Velocidad de System Update
  Los upgrades de sistema post-install son ahora más rápidos:

  • El proceso de upgrade (dist-upgrade) está separado de las actualizaciones de índice de plantillas de contenedor.
  • El refresh de índice es ahora una función opcional seleccionada en el script.

2025-05-27

Arreglado

• URL de ISO de Kali Linux actualizada
  Arreglada la URL de descarga incorrecta para el ISO de Kali Linux en el módulo de instalador Linux. El nuevo path correcto es:

  https://cdimage.kali.org/kali-2025.1c/kali-linux-2025.1c-installer-amd64.iso
  

Mejorado

• Transiciones de menú dialog más rápidas
  Mejorada la respuesta UI en todos los menús interactivos reemplazando whiptail por dialog, ofreciendo transiciones más rápidas y navegación más suave.

• Soporte Coral USB en LXC
  Mejorada la lógica para configurar passthrough de Coral USB TPU en contenedores LXC:

  • Refactorizada la configuración en bloques modulares con mejor estructura y comentarios inline.
  • Separación clara de la lógica de Coral USB (/dev/coral) y Coral M.2 (/dev/apex_0).
  • Mantiene retrocompatibilidad con configuraciones LXC existentes.
  • Introducido passthrough Coral USB persistente usando una udev rule:

    # Create udev rule for Coral USB
    SUBSYSTEM=="usb", ATTRS{idVendor}=="18d1", ATTRS{idProduct}=="9302", MODE="0666", TAG+="uaccess", SYMLINK+="coral"
    
    # Map /dev/coral if it exists
    if [ -e /dev/coral ]; then
        echo "lxc.mount.entry: /dev/coral dev/coral none bind,optional,create=file" >> "$CONFIG_FILE"
    fi
    

  • Gracias especiales a @Blaspt por validar el passthrough Coral USB persistente y por sugerir el uso del symlink /dev/coral.

Añadido

• Soporte de passthrough Coral USB persistente
  Añadido soporte de udev rule para dispositivos Coral USB para mapearlos persistentemente como /dev/coral, habilitando passthrough consistente entre reboots. Este path se detecta y mapea automáticamente en la configuración del contenedor.

• Integración de RSS Feed
  Añadido soporte para generar un RSS feed para el changelog, permitiendo a los usuarios mantenerse informados de updates a través de clientes de noticias.

• Automatización del Release Service
  Implementado un nuevo servicio de gestión de release para automatizar la publicación y tagging de versiones, empezando con la versión v1.1.2.

2025-05-13

Arreglado

• Fix de startup en versiones recientes de Proxmox
  Arreglado un issue donde algunas instalaciones recientes de Proxmox carecían del directorio /usr/local/bin, causando errores al instalar el menú de ejecución. El script crea ahora el directorio si no existe antes de descargar el menú principal.
  Gracias a @danielmateos por detectar y reportar este issue.

Mejorado

• Lógica de instalación de Lynis actualizada en Post-Install Settings
  La función install_lynis() se ha mejorado para instalar siempre la última versión de Lynis clonando el repositorio oficial de GitHub:

  https://github.com/CISOfy/lynis.git
  

  El proceso de instalación asegura ahora que siempre se obtenga la última versión y se enlace correctamente dentro del path del sistema.

  Gracias a @Kamunhas por reportar esta oportunidad de mejora.

• Optimización de memoria equilibrada para sistemas con poca memoria
  Mejorados los ajustes de memoria por defecto para soportar mejor sistemas con RAM limitada. La configuración previa podía impedir que servidores de bajas specs arrancaran. Ahora se usa un conjunto más equilibrado de parámetros de kernel, y la compactación de memoria se habilita si el sistema la soporta.

  cat <<EOF | sudo tee /etc/sysctl.d/99-memory.conf
  # Balanced Memory Optimization
  vm.swappiness = 10
  vm.dirty_ratio = 15
  vm.dirty_background_ratio = 5
  vm.overcommit_memory = 1
  vm.max_map_count = 65530
  EOF
  
  # Enable memory compaction if supported by the system
  if [ -f /proc/sys/vm/compaction_proactiveness ]; then
    echo "vm.compaction_proactiveness = 20" | sudo tee -a /etc/sysctl.d/99-memory.conf
  fi
  
  # Apply settings
  sudo sysctl -p /etc/sysctl.d/99-memory.conf
  

  Estos valores ayudan a mantener la capacidad de respuesta y la estabilidad del sistema incluso en condiciones de memoria constreñidas.

  Gracias a @chesspeto por señalar este issue y ayudar a refinar la optimización.

2025-05-04

Añadido

• Menú interactivo Help & Info
  Añadido un nuevo script llamado Help and Info, que proporciona un menú interactivo de referencia de comandos para Proxmox VE a través de una interfaz basada en dialog.
  Esta herramienta ofrece a los usuarios una forma rápida de navegar y copiar comandos útiles para gestionar y mantener su servidor Proxmox, todo en una ubicación centralizada.

  

  Figura 1: Menú interactivo de referencia de comandos Help and Info.

• Uninstaller para utilidades Post-Install
  Se ha añadido un nuevo script al menú Post-instalación, permitiendo a los usuarios desinstalar utilidades o paquetes que se instalaron previamente a través del script post-install.

Mejorado

• Menú de selección de utilidades en el script de Post-instalación
  La sección Install Common System Utilities incluye ahora un menú donde los usuarios pueden elegir qué utilidades instalar, en lugar de instalar todas por defecto. Esto da más control sobre lo que se añade al sistema.

• Detección de PV Header antiguo y auto-fix
  Tras actualizar el sistema, el script post-update incluye ahora una comprobación de seguridad para discos físicos con headers LVM PV (Physical Volume) obsoletos.
  Este issue puede ocurrir cuando las máquinas virtuales tienen acceso passthrough a discos y modifican involuntariamente la metadata del volumen. El script detecta y actualiza ahora automáticamente estos headers.
  Si ocurre algún error durante el proceso, se muestra un warning al usuario.

• Traducciones más rápidas en menús
  Varios menús de post-instalación con auto-traducciones se han optimizado para reducir tiempos de carga y mejorar la experiencia de usuario.

2025-04-14

Añadido

• Nuevo script: Disk Passthrough a un CT Introducido un nuevo script que permite asignar un disco físico dedicado a un contenedor (CT) en Proxmox VE. Esta utilidad lista los discos físicos disponibles (excluyendo los discos de sistema y montados), permite al usuario seleccionar un contenedor y un disco, y luego formatea o reutiliza el disco antes de montarlo dentro del CT en un path especificado. Soporta detección de filesystems existentes y asegura que los permisos estén correctamente configurados. Ideal para casos de uso como contenedores Samba, Nextcloud, o de videovigilancia.

Mejorado

• Identificación visual de discos para passthrough a VMs Mejorada la lógica de detección de discos en el script Disk Passthrough a una VM incluyendo indicadores visuales y metadata. Los discos muestran ahora tags como ⚠ In use, ⚠ RAID, ⚠ LVM, o ⚠ ZFS, facilitando reconocer su estado actual de un vistazo. Esto ayuda a prevenir errores de selección y mejora la claridad para el usuario.

2025-03-24

Mejorado

• Mejorada la lógica para detectar discos físicos en el script Disk Passthrough a una VM. Anteriormente, el script mostraba en algunos setups discos que ya estaban montados en el sistema. Esta actualización asegura que solo se muestren discos no montados en Proxmox, previniendo confusión y conflictos potenciales.

• Esta mejora asegura que los discos ya montados o asignados a otras VMs se excluyan de la lista de discos disponibles, proporcionando un proceso de selección más preciso y fiable.

[1.1.1] - 2025-03-21

Mejorado

• Mejorada la lógica del script post-install para prevenir sobrescribir o añadir ajustes duplicados si ajustes similares ya están configurados por el usuario.
• Añadida una nota de warning a la documentación explicando que usar diferentes scripts post-instalación no se recomienda para evitar conflictos y ajustes duplicados.

Añadido

• Crear VM Synology DSM:
  Un nuevo script que crea una VM para instalar Synology DSM. El script automatiza el proceso de descargar tres loaders distintos con la opción de usar un loader custom proporcionado por el usuario desde las opciones de almacenamiento local.
  Además, permite el uso tanto de discos virtuales como físicos, que son asignados automáticamente por el script.

  

  Figura 1: Resumen del setup de la VM Synology DSM.

• Nuevo menú VM Creation:
  Se ha creado un nuevo menú para habilitar la creación de VM desde plantillas o scripts custom.

• Actualización del menú principal:
  Añadida una nueva entrada al menú principal para acceder al menú de creación de VM desde plantillas o scripts.

2025-03-06

Añadido

• Completada la sección de documentación web para ampliar la información sobre scripts actualizados.

[1.1.0] - 2025-03-04

Añadido

• Creado un script post-install personalizable para Proxmox con 10 secciones y 35 opciones seleccionables distintas.

[1.0.7] - 2025-02-17

Añadido

• Creado un menú con scripts esenciales de la comunidad Proxmox VE Helper-Scripts.

[1.0.6] - 2025-02-10

Añadido

• Añadido soporte de traducción en tiempo real usando Google Translate.
• Modificados los scripts existentes para soportar múltiples idiomas.
• Actualizado el script de instalación para instalar y configurar:
  • jq (para gestionar datos JSON)
  • Python 3 y virtual environment (requerido para traducciones)
  • Google Translate (googletrans) (para soporte multi-idioma)
• Introducido soporte para los siguientes idiomas:
  • English
  • Spanish
  • French
  • German
  • Italian
  • Portuguese
• Creado un script de utilidad para funciones auxiliares que soportan la ejecución de menús y scripts.

[1.0.5] - 2025-01-31

Añadido

• Añadido el script Repair Network, que incluye:
  • Verify Network
  • Show IP Information
• Creado el Network Menu para gestionar funciones relacionadas con la red.

[1.0.4] - 2025-01-20

Añadido

• Creado un script para añadir un disco passthrough a una VM.
• Creado el Storage Menu para gestionar funciones relacionadas con almacenamiento.

[1.0.3] - 2025-01-13

Añadido

• Creado un script para importar imágenes de disco en una VM.

[1.0.2] - 2025-01-09

Modificado

• Actualizado el script de configuración de Coral TPU para:
  • Incluir también el setup de Intel iGPU.
  • Instalar drivers de GPU para aplicaciones de videovigilancia para soportar VAAPI y QuickSync.
• Añadida una función para desinstalar ProxMenux.

[1.0.1] - 2025-01-03

Añadido

• Creado un script para añadir soporte Coral TPU en un LXC para uso en programas de videovigilancia.

[1.0.0] - 2024-12-18

Añadido

• Release inicial de ProxMenux.
• Creado un script para añadir drivers Coral TPU a Proxmox.