HN en clair : scripts auxiliaires pour Proxmox VE

 (community-scripts.github.io)
3 points par GN⁺ 2024-11-14 | 1 commentaires | Partager sur WhatsApp
  • Les opérateurs de Proxmox VE traitent souvent le déploiement et la gestion des conteneurs et VM comme des tâches répétitives, et ce hub communautaire de scripts à commande unique allège l’exploitation homelab et la virtualisation
  • Le site met en avant 604 scripts, 4 497 254 installations et 26 catégories, permettant d’explorer en un seul endroit des scripts d’automatisation pour les environnements Proxmox
  • La liste des installations les plus nombreuses sur les 30 derniers jours inclut des services souvent utilisés en homelab comme Docker, Debian, Immich, Nginx Proxy Manager et Jellyfin Media Server
  • Les scripts récemment ajoutés sont répartis par types LXC, ARM LXC et PVE, avec notamment Koffan, Etherpad, Flame, PVE Disk Health Tool, Pinchflat et SnapOtter
  • Comme ces scripts s’exécutent directement sur le système, il est indispensable de vérifier le site officiel et d’examiner le code source des scripts avant toute installation

Hub communautaire de scripts pour Proxmox VE

  • Proxmox VE Helper-Scripts rassemble et propose des scripts d’automatisation communautaires pour Proxmox VE
  • Les utilisateurs peuvent explorer, installer et gérer des conteneurs et VM dans un environnement Proxmox avec une commande unique
  • Le site joue le rôle de hub central pour simplifier les workflows homelab et de virtualisation
  • L’ampleur du site se présente ainsi

    • 604 scripts

    • 4 497 254 installations

      • 26 catégories

Nouvelle page d’accueil et parcours de navigation

  • Une nouvelle page d’accueil du projet Proxmox VE Community Scripts a été dévoilée dans la mise à jour du 6 mars 2026
  • Le nouveau site est conçu pour faciliter la découverte, l’exploration et le déploiement de centaines de scripts d’automatisation pour les environnements Proxmox
  • Il s’agit d’une plateforme créée par la communauté, proposée comme hub pour simplifier les workflows homelab et de virtualisation

Scripts les plus installés sur les 30 derniers jours

  • La liste des plus populaires est triée selon le nombre d’installations sur les 30 derniers jours
  • Les principaux éléments sont les suivants
    • Docker : projet open source d’automatisation du déploiement d’applications, 30 594 installations
    • Debian : système d’exploitation libre comprenant plus de 59 000 paquets, 22 397 installations
    • Immich : solution auto-hébergée de gestion de photos et vidéos, 18 234 installations
    • Nginx Proxy Manager : interface web pour gérer des reverse proxies Nginx, 14 049 installations
    • Jellyfin Media Server : serveur multimédia libre et open source pour organiser, gérer et partager des fichiers multimédias numériques, 13 707 installations
    • Hermes Agent : agent IA auto-améliorant de Nous Research, 13 233 installations
    • Frigate : NVR open source fondé sur la détection d’objets par IA en temps réel pour caméras IP, 12 663 installations
    • AdGuard Home : outil auto-hébergé de blocage des publicités à l’échelle du réseau, 12 532 installations
    • Ollama : outil pour exécuter de grands modèles de langage sur un ordinateur local, 11 923 installations
    • Ubuntu : distribution basée sur Debian, 10 689 installations

Scripts récemment ajoutés

  • La liste des ajouts récents affiche le nom du script, son type et sa date d’ajout
  • Voici les principaux éléments
    • iVentoy : serveur PXE permettant de démarrer et d’installer des OS par le réseau sur plusieurs machines simultanément, ajouté aujourd’hui
    • FMD-Server : outil décentralisé pour localiser et contrôler à distance des appareils Android, ajouté il y a 1 jour
    • Koffan : application web de liste de courses synchronisée en temps réel pour couples et familles, ajoutée il y a 1 jour
    • Etherpad : éditeur de documents collaboratif en temps réel permettant à plusieurs personnes de modifier simultanément dans le navigateur, ajouté il y a 1 jour
    • Flame : page de démarrage auto-hébergée pour serveurs, ajoutée il y a 1 jour
    • PVE Disk Health Tool : outil qui remonte l’état des disques physiques de l’hôte Proxmox VE, ajouté il y a 2 jours
    • Pinchflat : gestionnaire multimédia YouTube auto-hébergé basé sur yt-dlp, ajouté il y a 4 jours
    • SnapOtter : boîte à outils de traitement d’images exécutée localement, ajoutée il y a 6 jours
    • Postiz : outil basé sur l’IA pour planifier et gérer des publications sur plusieurs plateformes sociales, ajouté il y a 9 jours
    • Plane : outil open source pour planifier et suivre des projets logiciels avec des issues, cycles et modules, ajouté il y a 11 jours

Scripts en développement

  • Les scripts de la section en développement n’ont pas encore été publiés officiellement et sont en cours de développement actif
  • Les éléments affichés comme en développement sont les suivants
    • Rackula : concepteur de disposition de rack en glisser-déposer pour utilisateurs homelab
    • Umbraco CMS : script de configuration automatique d’un CMS .NET open source et d’un serveur FTP
    • Nexterm : logiciel open source d’administration de serveurs pour SSH, VNC et RDP
    • Colanode : espace de travail collaboratif local-first auto-hébergé, alternative à Slack et Notion
    • ExcaliDash : tableau de bord et outil d’organisation auto-hébergé pour Excalidraw

Organisation des catégories

  • Les scripts sont répartis en plusieurs catégories, notamment Proxmox et systèmes d’exploitation, réseau, sécurité, sauvegarde, bases de données, monitoring, médias et IoT
  • Les principales catégories et leur total sont les suivantes
    • 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

Types de scripts et exemples

  • Chaque script est fourni avec des étiquettes de type comme LXC, ARM LXC, PVE, Addon, VM, DEV, Privileged
  • Exemples de la catégorie Proxmox & Virtualization
    • PVE Disk Health Tool : remonte l’état des disques physiques et installe si nécessaire smartmontools et nvme-cli
    • PVE LXC Execute : exécute des commandes personnalisées dans un ou plusieurs conteneurs LXC d’un nœud Proxmox VE
    • PVE Startup Dependency Check : vérifie les dépendances nécessaires et la disponibilité du stockage référencé avant le démarrage d’une VM ou d’un LXC
    • CronMaster : planificateur de tâches cron auto-hébergé avec interface web, logs en temps réel et authentification
    • All Templates : script qui crée l’un de plusieurs modèles LXC gratuits

Projet et consignes de sécurité

  • Le projet est relié via GitHub et Discord
  • En bas du site, il est indiqué que le projet a été créé par la communauté et qu’il est open source sous licence MIT
  • Comme il peut exister des sites clonés ou similaires, il faut toujours vérifier qu’il s’agit bien du site officiel
  • Avant toute exécution sur un système, il faut examiner minutieusement tout le code source des scripts

À lire aussi

1 commentaires

 
GN⁺ 2024-11-14
Avis de Hacker News

  • Avec l’auteur de la soumission, j’ai rejoint l’équipe de mainteneurs qui s’est portée volontaire pour aider à maintenir ce projet après la triste nouvelle de l’entrée de tteck en soins palliatifs
    Tous les membres de l’équipe sont très motivés et enthousiastes à l’idée de perpétuer l’héritage de tteck
    Nous avançons en toute transparence et répondrons volontiers aux questions
    (1) https://news.ycombinator.com/item?id=42016605

    • C’est vraiment une triste nouvelle
      Je me suis lancé assez récemment dans le homelab / self-hosting, et j’ai configuré la plupart de mes conteneurs avec les scripts de tteck

  • J’utilise Proxmox VE depuis quelques années, et je faisais tourner la plupart de mes services comme conteneurs Docker dans une seule VM
    J’ai toujours regretté de ne pas pouvoir contrôler les services individuels et les tâches de sauvegarde depuis l’interface de Proxmox ; en voyant ces scripts, j’ai déplacé Caddy et quelques instances WireGuard vers des conteneurs LXC, et j’ai été impressionné par la facilité de l’opération
    Grâce à toutes les personnes qui ont créé ces scripts, ma première impression a été excellente

    • Il faut rester prudent. J’ai eu la même idée, mais les conteneurs Docker ont un avantage sur les scripts LXC pour les mises à jour entre versions majeures et les mises à niveau automatiques
      En général, comme les développeurs du logiciel créent aussi le conteneur, c’est un environnement pris en charge ; et puisqu’ils connaissent bien l’application et ses futures mises à niveau, l’environnement est correctement configuré pour chaque version
      Pour atteindre ton objectif, je recommanderais, pour chaque application, une combinaison LXC avec ta distribution Linux préférée + Docker + conteneur de l’application. Tu obtiens le même effet tout en conservant les avantages ci-dessus

  • C’est un peu à côté du sujet, mais j’ai rencontré sans cesse des problèmes en essayant de gérer libvirt et Unraid avec Terraform, au point que j’ai presque abandonné et que je m’apprête à gérer mes VM manuellement
    Je me demande quelle technologie de virtualisation Proxmox utilise
    Je me demande aussi quels sont les avantages d’utiliser ce genre d’outil plutôt que Terraform, SaltStack ou Ansible

    • Il vaut aussi la peine de mentionner que Proxmox utilise ZFS, ce qui rend les snapshots rapides, et que son système de sauvegarde est également très bon
      Si tu veux traiter tes applications self-hosted comme un « troupeau », Terraform, Kubernetes, etc. sont de meilleurs choix
      Mais si cela ne te dérange pas de restaurer manuellement depuis une sauvegarde ou un snapshot en cas de problème, ou si tu veux que des conteneurs LXC soient déplacés automatiquement vers un autre matériel quand tu as un cluster, alors Proxmox est le bon choix. Dans un vrai environnement domestique, maintenir des « animaux de compagnie » prend autant, voire moins, de temps que gérer une « ferme »
      (1) C’est un jeu de mots utilisé en Nouvelle-Zélande
    • Proxmox met davantage l’accent sur la gestion de l’hôte et des ressources qui tournent dessus. Cela inclut la migration à chaud de VM entre hôtes, une certaine haute disponibilité et la prise en charge du failover
      Si tu le souhaites, tu pourrais aussi utiliser des outils comme Terraform avec Proxmox pour gérer la configuration à l’intérieur des VM
    • Proxmox utilise KVM pour la virtualisation et Linux Containers (LXC) pour les conteneurs
      Je suis d’accord pour dire que, pour un déploiement d’infrastructure as code, Terraform ou Ansible sont plus cohérents. Les gens qui utilisent Proxmox dans un homelab préfèrent généralement la gestion manuelle et ne se préoccupent pas vraiment de mettre en place de l’infrastructure as code
      Au travail, je crois fermement aux environnements reproductibles et à l’infrastructure as code. En pratique, j’utilise Vagrant, libvirt et KVM pour lancer rapidement des clusters locaux à des fins de test et de développement, et cela fonctionne plutôt bien. Mais mon homelab n’est pas assez complexe pour justifier de configurer Terraform/Ansible. Peut-être que je changerai d’avis si mon serveur tombe en panne
    • On peut faire un compromis avec le provider Proxmox pour Terraform[1]
      Le flux consiste à provisionner les VM avec Terraform, puis à les configurer / maintenir avec quelque chose comme Ansible
      Si tu veux cibler des LXC, ce provider permet aussi d’en réserver
      [1]: https://github.com/Telmate/terraform-provider-proxmox

  • Du point de vue de quelqu’un qui cherche à configurer sa première machine Proxmox, je voulais une configuration très basique et courante
    Modem > machine Proxmox > VM OPNsense > routeur Wi‑Fi physique via la carte réseau 10 Gb embarquée + VM de réseau interne du type OMV. L’objectif est d’ajouter un filtrage de tout le réseau avec OPNsense, et de permettre l’accès au serveur multimédia, aux sauvegardes, etc. depuis le réseau interne
    Or je ne vois pas de script OPNsense, et le script OMV devrait être une VM plutôt qu’un conteneur LXC, ce qui en fait une approche en pratique non recommandée ; je ne vois pas non plus de script « colle » pour faire communiquer les VM entre elles. Comme c’est un point important dans la configuration de Proxmox, il semble y avoir de la marge pour améliorer ou ajouter un script de configuration de base pour un simple serveur domestique

    • Ce n’est pas une configuration basique et courante. Pour moi, oui, mais probablement pas pour vous, et certainement pas pour la plupart des gens
      Vouloir virtualiser un routeur et un pare-feu, c’est très bien. J’ai déployé environ 200 pare-feu/routeurs pfSense, à la fois en VM et sur du matériel physique, et OPNSense étant similaire, je pense pouvoir aider
      Il faut au minimum deux interfaces physiques. C’est possible avec une seule, mais il faut savoir exactement ce que l’on fait. Il faut un « WAN » et un « LAN ». OPNSense étant, sauf erreur, toujours basé sur FreeBSD, il ne tournera évidemment pas dans un conteneur LXC Linux
      Le dernier paragraphe est un peu confus. Je ne sais pas ce que vous entendez par « script colle ». Les VM communiquent par le réseau
      Pour bien comprendre la virtualisation, je recommande de faire quelques expériences, puis d’avancer ensuite. Si vous avez un problème précis, venez sur les forums Proxmox et on pourra vous aider, mais au final, soit on se lance vraiment, soit non
    • J’utilise Proxmox et j’ai aussi configuré des VLAN
      Le port allant du routeur à la machine Proxmox est configuré pour des paquets tagués, afin de séparer le trafic entrant et sortant
      Ensuite, les VM et les conteneurs se configurent facilement pour « vivre » sur un ou plusieurs réseaux
      Dans mon cas, les règles de pare-feu du routeur déterminent quel trafic est relayé entre les VLAN
      Il me semble qu’en lançant OPNSense dans un conteneur ou une VM, on pourrait le configurer de la même manière pour laisser passer sélectivement le trafic entre VLAN
    • S’il n’y avait pas de script OPNSense, c’est probablement parce qu’une seule erreur de configuration pourrait exposer l’instance Proxmox à Internet
      Pour les utilisateurs avancés, il est assez facile de lancer une VM depuis l’ISO. Il y a d’ailleurs eu récemment une demande de script OPNSense
      Pour OMV, je suis d’accord. On peut l’utiliser tel quel, mais ce n’est généralement pas la manière dont les gens veulent s’en servir. Un commentaire a été ajouté au script il y a quelques jours
      Vous dites qu’il n’y a pas de script « colle » pour faire communiquer les VM entre elles, mais techniquement il existe un script Tailscale qui aide à les faire communiquer via Tailscale :)
      Ces scripts sont conçus pour configurer des conteneurs LXC autonomes. On évite de créer notre propre Kubernetes
    • J’utilise une VM OPNSense dans Proxmox, avec plusieurs cartes réseau. L’une d’elles est dédiée à l’ONT de la fibre
      J’utilise aussi un maillage Wi‑Fi externe
      J’ai également quelques autres VM. Une VM unRaid qui héberge Docker avec une carte SATA en passthrough pour des raisons de compatibilité historique, une VM pour Home Assistant OS, et beaucoup de LXC. Tout fonctionne très bien
    • Je ne sais pas ce que signifie « script colle pour faire communiquer les VM entre elles »
      Il suffit d’utiliser le réseau comme avec n’importe quel autre ordinateur, non ?
      Je n’ai jamais eu à faire de configuration spéciale pour faire communiquer des VM entre elles

  • Je compte absolument regarder Docker LXC et la VM Home Assistant
    Jusqu’ici, j’utilisais Docker avec succès dans une VM Proxmox, mais je pourrais peut-être en tirer encore plus d’efficacité

    • Faire tourner HAOS dans une VM sous Proxmox fonctionne bien
      J’ai configuré des conteneurs LXC MQTT et zigbee2mqtt avec quelques scripts d’assistance de tteck, et utilisé un périphérique USB Zigbee en passthrough
    • Les scripts pour ces deux projets fonctionnent très bien
      Pour Home Assistant, il vaut mieux utiliser une VM HAOS plutôt qu’un LXC ou Docker

  • J’ai décidé de faire tourner Proxmox dans mon homelab plutôt que Kubernetes, et je le regrette un peu
    LXC est excellent, mais être limité à LXC ou à des VM QEMU ne répond pas à tous mes besoins. Avec Kubernetes, j’aurais pu ajouter la prise en charge de VM légères comme l’hyperviseur Firecracker ou des unikernels via des projets comme Kata, alors que Proxmox manque d’extensibilité
    Par ailleurs, ce n’est pas aussi adapté à l’automatisation ou aux builds reproductibles qu’un gestionnaire de pods éprouvé comme Kubernetes. D’après ce que j’ai trouvé, il n’y a pas non plus de support Terraform, donc il faut s’appuyer sur des sauvegardes complètes de disques et des outils du type Chef/Ansible/Puppet, que je n’ai pas envie de réapprendre
    Cela dit, la gestion des ressources et le modèle de passthrough sont très bons, la configuration et la maintenance sont faciles, et le panneau de contrôle est correct

    • Le modèle de déploiement est clairement différent. Il a des inconvénients, mais je l’aime bien
      Il existe toutefois un module Terraform communautaire : https://registry.terraform.io/providers/Telmate/proxmox/late...
      Je ne l’ai jamais utilisé moi-même et je choisis généralement Ansible
      Le ZFS facile à installer rend aussi difficile de me convaincre d’essayer autre chose. Si tu veux jouer avec Kubernetes, il suffit de lancer une ou plusieurs VM
    • Je suis tombé assez profondément dans NixOS
      Pendant un temps, j’ai fait tourner Docker Swarm sur plusieurs ordinateurs monocartes, puis Kubernetes, un gros serveur sous Ubuntu + Cockpit, Proxmox, avant de finalement me poser sur NixOS
      NixOS offre aussi une prise en charge correcte des conteneurs si nécessaire, mais son caractère déclaratif fait que je les utilise très peu. « Supprimer » quelque chose revient généralement à l’enlever du fichier de configuration puis à reconstruire. Faire des choses façon cgroups pour la gestion de la mémoire n’est pas difficile non plus
      Je trouve aussi le DSL nginx de NixOS excellent. Au lieu d’écrire des scripts moi-même, j’apprécie beaucoup que l’environnement de configuration gère directement, et correctement, la configuration des proxys et Let’s Encrypt
      Je ne sais pas s’il existe des outils liés à NixOS distribué, mais j’ai l’impression qu’on pourrait construire quelque chose de chouette au-dessus de Flakes
      Mon homelab est aujourd’hui dans son état le plus simple, et c’est aussi celui dont je suis le plus satisfait
    • J’ai déployé un cluster Kubernetes en utilisant ce provider Terraform[1] avec la distribution Talos[2]
      Je suis d’accord pour dire que l’API fournie par Proxmox n’est pas complète, mais elle suffit à mes besoins
      Je fais tourner le cluster sur quatre machines SFF en fin de vie, avec des snapshots LVM sauvegardés vers un stockage TrueNAS maison, et toute cette configuration me plaît
      [1] https://github.com/Telmate/terraform-provider-proxmox
      [2] https://factory.talos.dev/
    • Utiliser Proxmox ne t’empêche pas d’utiliser Kubernetes
      Il suffit de créer des VM dans Proxmox, d’y installer Kubernetes, puis d’exécuter les workloads applicatifs dans Kubernetes
      Les VM Proxmox sont plus difficiles à automatiser, donc il faut les traiter comme des « animaux de compagnie » plutôt que comme du « bétail », mais c’est aussi le cas quand on gère des hôtes Kubernetes sur bare metal. En revanche, avec des VM sur Proxmox, on peut faire les sauvegardes complètes de VM et les migrations via Proxmox, ce qui permet de bénéficier à la fois des avantages de Proxmox et de Kubernetes
    • Chaque technologie a son approche et ses cas d’usage adaptés
      Dans Proxmox, il est relativement simple de créer ou modifier des VM avec l’utilitaire en ligne de commande pve
      Cela dit, le point de départ de cet article est qu’il existe beaucoup de scripts utiles qui rendent l’administration plus facile et plus maintenable, et qu’il y a de la gratitude pour cette aide alors que le fondateur doit se retirer

  • Quelles fonctionnalités Proxmox apporte-t-il par rapport à du KVM simple ? Juste une interface web ?

    • Rien que de tête, il y a le clustering, la migration, la haute disponibilité, les sauvegardes, l’intégration Ceph, les réseaux virtuels récents, et la prise en charge non seulement des VM mais aussi des conteneurs
      L’interface web est également optionnelle. Pour plus de détails, mieux vaut consulter le site de Proxmox
    • KVM n’est qu’un composant côté noyau, pas un gestionnaire de machines virtuelles complet en soi. Il faut toujours une application en espace utilisateur
      Firecracker, QEMU et Cloud-Hypervisor sont des gestionnaires de machines virtuelles construits au-dessus de KVM
      QEMU est la façon courante d’utiliser KVM, mais lancer QEMU directement est assez pénible. C’est pourquoi on utilise des outils qui encapsulent QEMU, comme libvirt ou Proxmox

  • C’est une excellente communauté. J’ai déjà utilisé quelques scripts et je fais tourner des conteneurs LXC Pi-hole et Paperless
    J’attends aussi Appflowy avec impatience

  • Malheureusement, même si Proxmox utilise le mot « Enterprise » dans le premier paragraphe de son site web, il ne prend toujours pas en charge par défaut le chiffrement complet du disque
    Bien sûr, on peut l’installer soi-même sur une Debian chiffrée, mais on passe alors à côté de fonctionnalités importantes et il faut assumer soi-même. Au final, cela vient du fait que ZFS ne traite pas le chiffrement complet du disque comme une fonctionnalité de premier ordre
    C’est vraiment dommage