HN en abierto: scripts auxiliares para Proxmox VE

 (community-scripts.github.io)
3 puntos por GN⁺ 2024-11-14 | 1 comentarios | Compartir por WhatsApp
  • Los operadores de Proxmox VE suelen manejar la implementación y administración de contenedores y VM mediante tareas repetitivas, por lo que un hub comunitario de scripts basado en un solo comando ayuda a reducir la carga en homelabs y operaciones de virtualización
  • El sitio destaca 604 scripts, 4,497,254 instalaciones y 26 categorías, y permite explorar en un solo lugar scripts de automatización para entornos Proxmox
  • La lista de más instalaciones de los últimos 30 días incluye servicios usados con frecuencia en homelabs, como Docker, Debian, Immich, Nginx Proxy Manager y Jellyfin Media Server
  • Los scripts agregados recientemente se dividen en tipos LXC, ARM LXC y PVE, e incluyen Koffan, Etherpad, Flame, PVE Disk Health Tool, Pinchflat y SnapOtter
  • Como se trata de scripts que se ejecutan directamente en el sistema, es indispensable verificar el sitio oficial y revisar el código fuente del script antes de instalar

Hub comunitario de scripts para Proxmox VE

  • Proxmox VE Helper-Scripts reúne y ofrece scripts de automatización creados por la comunidad para Proxmox VE
  • Los usuarios pueden explorar, instalar y administrar contenedores y VM en entornos Proxmox con un solo comando
  • Funciona como un hub central para simplificar flujos de trabajo de homelab y virtualización
  • La escala del sitio es la siguiente

    • 604 scripts

    • 4,497,254 instalaciones

      • 26 categorías

Nueva página principal y flujo de exploración

  • En la actualización del 6 de marzo de 2026 se presentó la nueva página principal del proyecto Proxmox VE Community Scripts
  • El nuevo sitio web está diseñado para descubrir, explorar e implementar con mayor facilidad cientos de scripts de automatización para entornos Proxmox
  • Es una plataforma creada por la comunidad y se ofrece como un hub para simplificar flujos de trabajo de homelab y virtualización

Scripts con más instalaciones en los últimos 30 días

  • La lista de popularidad está ordenada según el número de instalaciones en los últimos 30 días
  • Los primeros elementos son los siguientes
    • Docker: proyecto de automatización para el despliegue de aplicaciones de código abierto, 30,594 instalaciones
    • Debian: sistema operativo gratuito con más de 59,000 paquetes, 22,397 instalaciones
    • Immich: solución self-hosted para gestionar fotos y videos, 18,234 instalaciones
    • Nginx Proxy Manager: interfaz web para administrar el reverse proxy de Nginx, 14,049 instalaciones
    • Jellyfin Media Server: servidor multimedia gratuito y de código abierto para organizar, administrar y compartir archivos multimedia digitales, 13,707 instalaciones
    • Hermes Agent: agente de IA con auto-mejora de Nous Research, 13,233 instalaciones
    • Frigate: NVR de código abierto basado en detección de objetos con IA en tiempo real para cámaras IP, 12,663 instalaciones
    • AdGuard Home: herramienta self-hosted para bloquear publicidad en toda la red, 12,532 instalaciones
    • Ollama: herramienta para ejecutar modelos de lenguaje grandes en computadoras locales, 11,923 instalaciones
    • Ubuntu: distribución basada en Debian, 10,689 instalaciones

Scripts agregados recientemente

  • La lista de agregados recientes muestra el nombre del script, su tipo y cuándo fue añadido
  • Los principales elementos son los siguientes
    • iVentoy: servidor PXE que permite arrancar e instalar sistemas operativos por red en varias máquinas al mismo tiempo, agregado hoy
    • FMD-Server: herramienta descentralizada para localizar y controlar remotamente dispositivos Android, agregado hace 1 día
    • Koffan: app web de lista de compras con sincronización en tiempo real para parejas y familias, agregado hace 1 día
    • Etherpad: editor de documentos colaborativo en tiempo real donde varias personas pueden editar simultáneamente desde el navegador, agregado hace 1 día
    • Flame: página de inicio self-hosted para servidores, agregado hace 1 día
    • PVE Disk Health Tool: herramienta que reporta el estado de los discos físicos del host Proxmox VE, agregado hace 2 días
    • Pinchflat: administrador multimedia self-hosted para YouTube basado en yt-dlp, agregado hace 4 días
    • SnapOtter: conjunto de herramientas de procesamiento de imágenes para ejecución local, agregado hace 6 días
    • Postiz: herramienta impulsada por IA para programar y administrar publicaciones en múltiples plataformas sociales, agregado hace 9 días
    • Plane: herramienta de código abierto para planificar y seguir proyectos de software con issues, ciclos y módulos, agregado hace 11 días

Scripts en desarrollo

  • Los scripts de la sección en desarrollo todavía no han sido lanzados oficialmente y siguen en desarrollo activo
  • Los elementos marcados como en desarrollo son los siguientes
    • Rackula: diseñador de distribución de racks con drag and drop para usuarios de homelab
    • Umbraco CMS: script de configuración automática para el CMS .NET de código abierto y un servidor FTP
    • Nexterm: software de administración de servidores de código abierto para SSH, VNC y RDP
    • Colanode: espacio de trabajo colaborativo local-first self-hosted, alternativa a Slack y Notion
    • ExcaliDash: dashboard self-hosted y herramienta de organización para Excalidraw

Estructura de categorías

  • Los scripts se dividen en varias categorías como Proxmox y sistemas operativos, red, seguridad, respaldo, bases de datos, monitoreo, medios, IoT y más
  • Las principales categorías y sus cantidades totales son las siguientes
    • Proxmox & Virtualization: 40
    • Operating Systems: 27
    • Containers & Docker: 10
    • Network & Firewall: 40
    • Adblock & DNS: 8
    • Authentication & Security: 21
    • Backup & Recovery: 11
    • Databases: 24
    • Monitoring & Analytics: 50
    • Dashboards & Frontends: 17
    • Files & Downloads: 35
    • Documents & Notes: 59
    • Media & Streaming: 58
    • AI / Coding & Dev-Tools: 35

Tipos de scripts y ejemplos

  • Cada script se ofrece con etiquetas de tipo como LXC, ARM LXC, PVE, Addon, VM, DEV, Privileged
  • Algunos ejemplos de la categoría Proxmox & Virtualization son los siguientes
    • PVE Disk Health Tool: reporta el estado de los discos físicos e instala smartmontools y nvme-cli si hace falta
    • PVE LXC Execute: ejecuta comandos personalizados dentro de uno o más contenedores LXC en un nodo Proxmox VE
    • PVE Startup Dependency Check: verifica las dependencias necesarias y la disponibilidad del almacenamiento referenciado antes de iniciar una VM o un LXC
    • CronMaster: programador self-hosted de tareas cron con web UI, logs en tiempo real y autenticación
    • All Templates: script que crea una de varias plantillas LXC gratuitas

Proyecto y guía de seguridad

  • El proyecto está conectado a través de GitHub y Discord
  • En la parte inferior del sitio se indica que el proyecto fue creado por la comunidad y que es código abierto bajo licencia MIT
  • Como puede haber sitios clonados o similares, siempre se debe comprobar que sea el sitio oficial
  • Antes de ejecutar cualquier cosa en el sistema, se debe revisar a fondo todo el código fuente del script

Lecturas relacionadas

1 comentarios

 
GN⁺ 2024-11-14
Opiniones en Hacker News

  • Junto con quien lo envió, formo parte del equipo de mantenedores que se ofreció a ayudar con el mantenimiento de este proyecto después de que tteck compartiera la triste noticia de que entraría en cuidados paliativos.
    Todos los integrantes del equipo tienen mucha voluntad y entusiasmo por continuar el legado de tteck.
    Estamos trabajando con transparencia y con gusto responderemos cualquier pregunta.
    (1) https://news.ycombinator.com/item?id=42016605

    • Es una noticia realmente triste.
      Apenas hace poco empecé con mi homelab/self-hosting, y configuré la mayoría de mis contenedores con los scripts de tteck.

  • Uso Proxmox VE desde hace varios años y tenía la mayoría de mis servicios corriendo como contenedores Docker dentro de una sola VM.
    Siempre me quedaba la espina de querer controlar los servicios individuales y las tareas de backup desde la interfaz de Proxmox; al ver estos scripts, moví Caddy y algunos WireGuard a contenedores LXC, y me impresionó lo fácil que fue.
    Gracias a todos los que crearon estos scripts, mi primera impresión fue muy buena.

    • Hay que tener cuidado. Yo pensé lo mismo, pero los contenedores Docker tienen ventajas frente a los scripts LXC en cuanto a actualizaciones entre versiones mayores y actualizaciones automáticas.
      Por lo general, quien desarrolla el software también crea el contenedor, así que es un entorno soportado; como conoce bien la aplicación y sus futuras actualizaciones, el entorno queda configurado correctamente para cada versión.
      Para lograr tu objetivo, recomiendo una combinación de LXC con tu distribución Linux favorita para cada app + Docker + el contenedor de la app. Obtienes el mismo efecto y conservas esas ventajas.

  • Un poco tangencial, pero he tenido tantos problemas intentando administrar libvirt y Unraid con Terraform que casi me rendí y estoy por administrar las VM manualmente.
    Me da curiosidad qué tecnología de virtualización usa Proxmox.
    También me interesa saber qué ventajas tiene usar una herramienta así en lugar de Terraform, SaltStack o Ansible.

    • Vale la pena mencionar que Proxmox usa ZFS, por lo que los snapshots son rápidos, y su sistema de backups también es muy bueno.
      Si quieres tratar tus aplicaciones self-hosted como un “rebaño”, Terraform, Kubernetes y similares son mejores opciones.
      Pero si te parece bien recuperar manualmente desde un backup o snapshot cuando algo falla, o si tienes un clúster y quieres que los contenedores LXC se muevan automáticamente a otro hardware, Proxmox es lo indicado. En un entorno doméstico real, mantener “mascotas” toma un tiempo similar, o incluso menor, que operar una “granja”.
      (1) Es un juego de palabras usado en Nueva Zelanda.
    • Proxmox se enfoca más en la administración del host y de los recursos sobre él. Incluye migración en vivo de VM entre hosts, algo de alta disponibilidad y soporte para conmutación por error.
      Si quieres, también podrías usar herramientas como Terraform junto con Proxmox para administrar la configuración dentro de las VM.
    • Proxmox usa KVM para virtualización y Linux Containers(LXC) para contenedores.
      Coincido en que, para despliegues de infraestructura como código, tiene más sentido algo como Terraform o Ansible. Quienes usan Proxmox en un homelab por lo general prefieren la administración manual y no se preocupan por implementar infraestructura como código.
      En el trabajo creo firmemente en entornos reproducibles e infraestructura como código. De hecho, levanto rápidamente clústeres locales con Vagrant, libvirt y KVM para pruebas y desarrollo, y funciona bastante bien. Pero mi homelab no es lo bastante complejo como para configurar Terraform/Ansible. Tal vez cambie de opinión si se rompe el servidor.
    • Se puede llegar a un punto medio con un proveedor de Proxmox para Terraform[1].
      El flujo sería aprovisionar las VM con Terraform y configurarlas/mantenerlas con algo como Ansible.
      Si quieres apuntar a LXC, también puedes reservar LXC con este proveedor.
      [1]: https://github.com/Telmate/terraform-provider-proxmox

  • Desde la perspectiva de alguien que está investigando cómo configurar su primer equipo Proxmox, quería una configuración muy básica y común.
    La estructura sería módem > equipo Proxmox > VM con OPNsense > router Wi-Fi físico mediante la NIC onboard de 10 Gb + VMs de red interna como OMV. El objetivo es agregar un filtro para toda la red con OPNsense y permitir el acceso a un servidor de medios, backups, etc., desde la red interna.
    Pero no veo un script para OPNsense, y el script de OMV debería ser una VM y no un contenedor LXC, así que en la práctica es una forma no recomendada; tampoco veo un script “pegamento” para hacer que las VMs se comuniquen entre sí. Como esta parte es importante en la configuración de Proxmox, parece haber margen para mejorar o agregar un script de configuración básica para un home server sencillo.

    • Eso no es una configuración básica ni común. Para mí sí lo es, pero quizá para ti tampoco, y para la mayoría definitivamente no.
      Querer virtualizar el router y el firewall está bien. He desplegado unas 200 instancias de firewalls/routers pfSense tanto en VMs como en equipos físicos, y OPNSense es similar, así que creo que podría ayudar.
      Como mínimo necesitas dos interfaces físicas. Con una sola también se puede, pero tienes que saber exactamente qué estás haciendo. Necesitas “WAN” y “LAN”. OPNSense seguramente todavía está basado en FreeBSD, así que obviamente no se ejecuta en un contenedor Linux LXC.
      El último párrafo es algo confuso. No sé a qué te refieres con “script pegamento”. Las VMs se comunican por red.
      Para entender bien la virtualización, recomiendo hacer algunos experimentos y luego avanzar. Si tienes un problema concreto, ven al foro de Proxmox y te ayudaremos, pero al final es una de dos: te metes de lleno o no.
    • Uso Proxmox y también tengo configuradas VLAN.
      El puerto que va del router al equipo Proxmox está configurado para paquetes etiquetados que separan el tráfico entrante y saliente.
      Luego las VMs y los contenedores se configuran fácilmente para “vivir” en una o más redes.
      En mi caso, las reglas del firewall del router deciden qué tráfico se reenvía entre las VLAN.
      Creo que, si levantas OPNSense como contenedor o VM, podrías configurarlo de la misma manera para permitir selectivamente el tráfico entre VLAN.
    • Creo que no había script para OPNSense porque un solo error de configuración podría dejar la instancia de Proxmox expuesta a Internet.
      Para usuarios avanzados, levantar una VM desde la ISO es bastante fácil. También hubo una solicitud reciente para un script de OPNSense.
      Sobre OMV, estoy de acuerdo. Se puede usar tal cual, pero no es la forma en que la mayoría de la gente quiere usarlo. Hace unos días se agregó un comentario al script.
      Dices que no hay un script pegamento para hacer que las VMs se comuniquen entre sí, pero técnicamente existe un script de Tailscale que ayuda a que se comuniquen mediante Tailscale :)
      Estos scripts están diseñados para configurar contenedores LXC autocontenidos. Estamos evitando crear nuestro propio Kubernetes.
    • Uso una VM de OPNSense en Proxmox y también tengo varias NIC. Una de ellas está dedicada al ONT de la fibra.
      También uso una malla Wi-Fi externa.
      Tengo algunas otras VMs. Por compatibilidad histórica, una VM de unRaid que hospeda Docker con passthrough de una tarjeta SATA, una VM para Home Assistant OS y muchos LXC. Funciona de maravilla.
    • No sé qué significa “script pegamento para hacer que las VMs se comuniquen entre sí”.
      ¿No basta con usar la red como con cualquier otra computadora?
      Nunca hice ninguna configuración especial para que las VMs se comunicaran entre sí.

  • Definitivamente pienso revisar Docker LXC y Home Assistant VM.
    Hasta ahora he estado usando Docker con éxito dentro de una VM en Proxmox, pero tal vez pueda exprimirle un poco más de eficiencia.

    • Ejecutar HAOS como VM en Proxmox funciona bien.
      Usé algunos scripts auxiliares de tteck para configurar contenedores LXC de MQTT y zigbee2mqtt, y pasé por passthrough un dispositivo USB Zigbee.
    • Los scripts para estos dos proyectos funcionan muy bien.
      Para Home Assistant se recomienda una VM con HAOS en lugar de LXC o Docker.

  • Decidí usar Proxmox en mi homelab en vez de Kubernetes, y me arrepiento un poco
    LXC es excelente, pero quedar limitado solo a LXC o a máquinas virtuales QEMU no cubre todas mis necesidades. Con Kubernetes podría haber agregado soporte para máquinas virtuales ligeras, como el hipervisor Firecracker o unikernels, mediante proyectos como Kata, pero a Proxmox le falta extensibilidad
    Además, no se presta tanto a la automatización ni a builds reproducibles como un administrador de pods probado como Kubernetes. Por lo que encontré, tampoco hay soporte para Terraform, así que tendría que depender de backups completos de disco y herramientas tipo Chef/Ansible/Puppet, y no quiero invertir en volver a aprender eso
    Aun así, la gestión de recursos y el modelo de passthrough son muy buenos, la configuración y el mantenimiento son fáciles, y el panel de control también está bien

    • Definitivamente el modelo de despliegue es distinto. Tiene sus desventajas, pero a mí me gusta
      Eso sí, existe un módulo de Terraform de la comunidad: https://registry.terraform.io/providers/Telmate/proxmox/late...
      Nunca lo usé personalmente y normalmente elijo Ansible
      También es difícil convencerme de probar otra cosa por lo fácil que es instalar ZFS. Si quiero jugar con Kubernetes, puedo levantar una o varias VM
    • Yo me metí bastante a fondo con NixOS
      Durante un tiempo corrí Docker Swarm en varias computadoras de placa única, luego Kubernetes, un servidor grande con Ubuntu + Cockpit, pasé por Proxmox y finalmente me quedé con NixOS
      NixOS también tiene soporte decente para contenedores si hace falta, pero por su naturaleza declarativa casi no termino usándolos. “Eliminar” algo normalmente es simplemente sacarlo del archivo de configuración y volver a compilar. Tampoco es difícil hacer cosas estilo cgroups para temas como gestión de memoria
      También creo que el DSL de nginx de NixOS es excelente. Me encanta que, en vez de escribir scripts yo mismo, el entorno de configuración gestione directamente, y correctamente, la configuración de proxies y Let’s Encrypt
      No sé si existen herramientas relacionadas con NixOS distribuido, pero siento que se podría construir algo genial sobre Flakes
      Mi homelab ahora está en su punto más simple y es el que más me satisface
    • Usé este proveedor de Terraform[1] junto con la distribución Talos[2] para desplegar un clúster de Kubernetes
      Coincido en que la API que ofrece Proxmox no es completa, pero para mis necesidades alcanza
      Tengo el clúster corriendo en cuatro equipos SFF a punto de ser descartados, y hago backups de snapshots LVM a un almacenamiento TrueNAS armado por mí; toda esta configuración me gusta
      [1] https://github.com/Telmate/terraform-provider-proxmox
      [2] https://factory.talos.dev/
    • Usar Proxmox no significa que no puedas usar Kubernetes
      Puedes crear VM en Proxmox, instalar Kubernetes encima y ejecutar las cargas de trabajo de las aplicaciones en Kubernetes
      Las VM de Proxmox son más difíciles de automatizar, así que hay que tratarlas como “mascotas, no ganado”, pero lo mismo pasa al administrar hosts de Kubernetes en bare metal. La diferencia es que con VM sobre Proxmox puedes hacer backups completos de las VM y migraciones con Proxmox, así que obtienes las ventajas tanto de Proxmox como de Kubernetes
    • Cada tecnología tiene su enfoque y sus casos de uso adecuados
      En Proxmox, crear o modificar VM con la utilidad de línea de comandos pve es relativamente sencillo
      Aun así, el punto de partida de este artículo es que hay muchos scripts útiles que facilitan y hacen más mantenible la administración, y que existe gratitud por esa ayuda en un momento en que el fundador tiene que hacerse a un lado

  • ¿Qué funciones tiene Proxmox que no tenga KVM simple? ¿Solo una interfaz web?

    • De entrada se me ocurren clustering, migración, alta disponibilidad, backups, integración con Ceph, redes virtuales recientes y soporte no solo para VM sino también para contenedores
      La interfaz web también es opcional. Para más detalles, conviene ver la página web de Proxmox
    • KVM es solo un componente del lado del kernel, y por sí mismo no es un administrador de máquinas virtuales completo. Siempre necesita una aplicación en espacio de usuario
      Firecracker, QEMU y Cloud-Hypervisor son administradores de máquinas virtuales construidos sobre KVM
      QEMU es la forma habitual de usar KVM, pero ejecutar QEMU directamente es bastante engorroso. Por eso se usan herramientas que envuelven QEMU, como libvirt o Proxmox

  • Es una comunidad excelente. Ya probé algunos scripts y estoy corriendo contenedores LXC de Pi-hole y Paperless
    También estoy esperando Appflowy

  • Lamentablemente, Proxmox usa la palabra “Enterprise” en el primer párrafo de su sitio web, pero todavía no ofrece soporte nativo para cifrado de disco completo
    Claro que se puede instalar sobre un Debian cifrado manualmente, pero te pierdes funciones importantes y tienes que hacerte cargo tú mismo. Al final, el problema viene de que ZFS no trata el cifrado de disco completo como una función de primera clase
    Es una situación muy decepcionante