Sobre el proyecto
Los Proxmox VE Helper-Scripts (Community Edition) son una colección de scripts de automatización mantenidos por la comunidad que instalan y configuran servicios autoalojados en Proxmox VE. En lugar de buscar paquetes manualmente y editar archivos de configuración, los usuarios pegan un único comando en el shell de Proxmox, responden unas pocas preguntas y obtienen un contenedor o máquina virtual en funcionamiento.
El proyecto se presenta como una continuación comunitaria basada en el trabajo original de tteck, y está mantenido por un pequeño equipo central junto con colaboradores externos. Los scripts tienen licencia MIT, por lo que pueden usarse, modificarse y redistribuirse para fines personales y comerciales.
Requisitos
- Proxmox VE versión 8.4, 9.0, 9.1 o 9.2 (un host Proxmox basado en Debian).
- Acceso a shell root en el host Proxmox.
- Conexión a Internet durante la instalación.
Primeros pasos
1. Navega al sitio web del proyecto para encontrar el servicio deseado, como Home Assistant, Nginx Proxy Manager o Jellyfin.
2. Copia el comando de instalación de una sola línea que aparece en la página del script.
3. Abre el shell de Proxmox y pega el comando.
4. Elige entre configuración Default o Advanced y sigue las indicaciones.
Cada página del script incluye documentación sobre qué contiene el contenedor, su asignación por defecto de recursos y notas posteriores a la instalación.
Comportamiento de los scripts
El modo Default selecciona valores razonables por defecto para CPU, RAM y almacenamiento, y realiza solo las preguntas mínimas necesarias; la mayoría de las instalaciones se completan en menos de cinco minutos. El modo Advanced expone la configuración del contenedor, redes, sistemas de almacenamiento y configuración a nivel de aplicación antes de instalar cualquier cosa. Después de la instalación, cada contenedor incluye un asistente post-instalación accesible desde el shell de Proxmox, que puede aplicar actualizaciones al servicio instalado, cambiar configuraciones de la aplicación sin editar archivos de configuración manualmente, y ofrecer diagnóstico básico y acceso a registros.
Alcance de la colección
El README describe la cobertura de cientos de servicios, agrupados en categorías como automatización del hogar (Home Assistant, Zigbee2MQTT, ESPHome, Node-RED), medios (Jellyfin, Plex, Radarr, Sonarr, Immich), red (AdGuard Home, Nginx Proxy Manager, Pi-hole, Traefik), monitoreo (Grafana, Prometheus, Uptime Kuma, Netdata), bases de datos (PostgreSQL, MariaDB, Redis, InfluxDB), seguridad (Vaultwarden, CrowdSec, Authentik) y herramientas de desarrollo (Gitea, Portainer, VS Code Server, n8n). Una lista completa y actualizada regularmente se publica en las páginas de categorías del sitio web del proyecto.
Contribuir
No se aceptan nuevos scripts directamente en este repositorio: primero se envían y prueban en el repositorio separado ProxmoxVED, y se cierran los pull requests que añadan nuevos scripts aquí. Las correcciones de errores y las mejoras a scripts existentes pertenecen a este repositorio y deben seguir las guías de contribución, con un cambio focalizado por pull request y documentación de lo que instala el script, además de cualquier decisión no obvia, en el archivo de metadatos JSON correspondiente. Los errores se reportan a través del sistema de issues, las solicitudes y preguntas a través de las discusiones o el Discord del proyecto, y las vulnerabilidades de seguridad según la política de seguridad.
Soporte y licenciamiento
El proyecto es mantenido por voluntarios, con costos de infraestructura pagados de propio bolsillo; el README indica que el 30% de todas las donaciones se destina a investigación contra el cáncer y atención de hospicio, una causa importante para tteck. Proxmox se menciona como marca registrada de Proxmox Server Solutions GmbH, y el código se distribuye bajo la Licencia MIT.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.