HN em destaque: scripts auxiliares do Proxmox VE

 (community-scripts.github.io)
3 pontos por GN⁺ 2024-11-14 | 1 comentários | Compartilhar no WhatsApp
  • Operadores do Proxmox VE frequentemente lidam com tarefas repetitivas de implantação e gerenciamento de contêineres e VMs, e um hub comunitário de scripts baseados em comando único ajuda a reduzir esse trabalho em homelabs e operações de virtualização
  • O site destaca 604 scripts, 4.497.254 instalações e 26 categorias, permitindo explorar em um só lugar scripts de automação para ambientes Proxmox
  • A lista dos mais instalados nos últimos 30 dias inclui serviços muito usados em homelabs, como Docker, Debian, Immich, Nginx Proxy Manager e Jellyfin Media Server
  • Os scripts adicionados recentemente são divididos em tipos como LXC, ARM LXC e PVE, com itens como Koffan, Etherpad, Flame, PVE Disk Health Tool, Pinchflat e SnapOtter
  • Como são scripts executados diretamente no sistema, é essencial confirmar o site oficial e revisar o código-fonte dos scripts antes da instalação

Hub comunitário de scripts para Proxmox VE

  • Proxmox VE Helper-Scripts reúne e disponibiliza scripts de automação criados pela comunidade para Proxmox VE
  • Os usuários podem explorar, instalar e gerenciar contêineres e VMs em ambientes Proxmox com um único comando
  • Ele funciona como um hub central para simplificar fluxos de trabalho de homelab e virtualização
  • A escala do site é a seguinte

    • 604 scripts

    • 4.497.254 instalações

      • 26 categorias

Nova página inicial e fluxo de navegação

  • Na atualização de 6 de março de 2026, foi lançada a nova página inicial do projeto Proxmox VE Community Scripts
  • O novo site foi estruturado para facilitar a descoberta, navegação e implantação de centenas de scripts de automação para ambientes Proxmox
  • É uma plataforma criada pela comunidade e oferecida como um hub para simplificar fluxos de trabalho de homelab e virtualização

Scripts mais instalados nos últimos 30 dias

  • A lista de popularidade é ordenada pelo número de instalações nos últimos 30 dias
  • Os principais itens são os seguintes
    • Docker: projeto de código aberto para automatizar a implantação de aplicações, 30.594 instalações
    • Debian: sistema operacional livre com mais de 59 mil pacotes, 22.397 instalações
    • Immich: solução self-hosted de gerenciamento de fotos e vídeos, 18.234 instalações
    • Nginx Proxy Manager: interface baseada na web para gerenciar proxy reverso Nginx, 14.049 instalações
    • Jellyfin Media Server: servidor de mídia gratuito e de código aberto para organizar, gerenciar e compartilhar arquivos de mídia digital, 13.707 instalações
    • Hermes Agent: agente de IA autoaperfeiçoável da Nous Research, 13.233 instalações
    • Frigate: NVR de código aberto baseado em detecção de objetos por IA em tempo real para câmeras IP, 12.663 instalações
    • AdGuard Home: ferramenta self-hosted de bloqueio de anúncios para toda a rede, 12.532 instalações
    • Ollama: ferramenta para executar modelos de linguagem de grande porte em computadores locais, 11.923 instalações
    • Ubuntu: distribuição baseada em Debian, 10.689 instalações

Scripts adicionados recentemente

  • A lista de adições recentes mostra junto o nome do script, o tipo e o momento em que foi adicionado
  • Os principais itens são os seguintes
    • iVentoy: servidor PXE que permite inicializar e instalar sistemas operacionais pela rede em várias máquinas ao mesmo tempo, adicionado hoje
    • FMD-Server: ferramenta distribuída para localizar e controlar remotamente dispositivos Android, adicionado há 1 dia
    • Koffan: aplicativo web de lista de compras com sincronização em tempo real para casais e famílias, adicionado há 1 dia
    • Etherpad: editor colaborativo de documentos em tempo real no navegador para edição simultânea por várias pessoas, adicionado há 1 dia
    • Flame: página inicial self-hosted para servidores, adicionado há 1 dia
    • PVE Disk Health Tool: ferramenta que informa a saúde dos discos físicos do host Proxmox VE, adicionada há 2 dias
    • Pinchflat: gerenciador self-hosted de mídia do YouTube baseado em yt-dlp, adicionado há 4 dias
    • SnapOtter: conjunto de ferramentas de processamento de imagens com execução local, adicionado há 6 dias
    • Postiz: ferramenta com IA para agendamento e gerenciamento de postagens em várias plataformas sociais, adicionado há 9 dias
    • Plane: ferramenta de código aberto para planejar e acompanhar projetos de software com issues, ciclos e módulos, adicionada há 11 dias

Scripts em desenvolvimento

  • Os scripts na seção de desenvolvimento ainda não foram lançados oficialmente e estão em desenvolvimento ativo
  • Os itens marcados como em desenvolvimento são os seguintes
    • Rackula: designer de layout de racks com arrastar e soltar para usuários de homelab
    • Umbraco CMS: script de configuração automática para CMS .NET de código aberto e servidor FTP
    • Nexterm: software de código aberto para gerenciamento de servidores via SSH, VNC e RDP
    • Colanode: workspace colaborativo local-first, alternativa self-hosted a Slack e Notion
    • ExcaliDash: painel self-hosted e ferramenta de organização para Excalidraw

Estrutura de categorias

  • Os scripts são divididos em várias categorias, como Proxmox e sistemas operacionais, rede, segurança, backup, bancos de dados, monitoramento, mídia e IoT
  • As principais categorias e o total de cada uma são as seguintes
    • 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 script e exemplos

  • Cada script é fornecido com rótulos de tipo como LXC, ARM LXC, PVE, Addon, VM, DEV, Privileged
  • Exemplos da categoria Proxmox & Virtualization são os seguintes
    • PVE Disk Health Tool: informa a saúde dos discos físicos e instala smartmontools e nvme-cli quando necessário
    • PVE LXC Execute: executa comandos personalizados dentro de um ou mais contêineres LXC em um nó Proxmox VE
    • PVE Startup Dependency Check: verifica dependências necessárias e a disponibilidade do armazenamento referenciado antes da inicialização de uma VM ou LXC
    • CronMaster: agendador self-hosted de tarefas cron com interface web, logs em tempo real e autenticação
    • All Templates: script que cria um entre vários templates LXC gratuitos

Projeto e orientações de segurança

  • O projeto está conectado por meio de GitHub e Discord
  • Na parte inferior do site, consta que o projeto foi criado pela comunidade e é open source sob a licença MIT
  • Como podem existir sites clonados ou semelhantes, é preciso sempre verificar se se trata do site oficial
  • Antes de executar no sistema, todo o código-fonte dos scripts deve ser revisado cuidadosamente

Leituras relacionadas

1 comentários

 
GN⁺ 2024-11-14
Opiniões no Hacker News

  • Junto com quem enviou, faço parte da equipe de mantenedores que se ofereceu para ajudar na manutenção deste projeto depois que tteck compartilhou a triste notícia de que entraria em cuidados paliativos
    Todos na equipe têm muita vontade e entusiasmo para dar continuidade ao legado de tteck
    Estamos conduzindo tudo com transparência e ficaremos felizes em responder a quaisquer perguntas
    (1) https://news.ycombinator.com/item?id=42016605

    • Que notícia realmente triste
      Só recentemente comecei com homelab/self-hosting, e configurei a maioria dos meus contêineres com os scripts do tteck

  • Uso Proxmox VE há alguns anos e rodava a maioria dos serviços como contêineres Docker dentro de uma única VM
    Sempre senti falta de controlar serviços individuais e tarefas de backup pela interface do Proxmox; ao ver estes scripts, movi o Caddy e alguns WireGuard para contêineres LXC, e fiquei impressionado com a facilidade do processo
    Graças a todos que criaram estes scripts, minha primeira impressão foi muito boa

    • É preciso ter cuidado. Eu também pensei o mesmo, mas contêineres Docker têm vantagem sobre scripts LXC em atualizações entre versões principais e upgrades automáticos
      Normalmente, quem desenvolve o software também cria o contêiner, então é um ambiente com suporte; como essa pessoa conhece bem a aplicação e os upgrades futuros, o ambiente fica configurado corretamente para cada versão
      Para atingir seu objetivo, recomendo a combinação LXC + Docker + contêiner da aplicação, com a distribuição Linux de sua preferência para cada app. Você obtém o mesmo efeito e ainda mantém as vantagens acima

  • Fugindo um pouco do assunto, tentei gerenciar libvirt e Unraid com Terraform, mas encontrei problemas continuamente e estou quase desistindo para gerenciar as VMs manualmente
    Fico curioso sobre qual tecnologia de virtualização o Proxmox usa
    Também fico curioso sobre a vantagem de usar ferramentas assim em vez de Terraform, SaltStack, Ansible e similares

    • Também vale mencionar que o Proxmox usa ZFS, então os snapshots são rápidos, e o sistema de backup também é muito bom
      Se você quer tratar aplicações self-hosted como “gado”, Terraform, Kubernetes etc. são escolhas melhores
      Mas, se você não se importa em recuperar manualmente a partir de backups ou snapshots quando algo dá errado, ou se, tendo um cluster, quer que contêineres LXC sejam movidos automaticamente para outro hardware, o Proxmox é a opção certa. Em um ambiente doméstico real, manter “pets” leva um tempo parecido ou até menor do que administrar uma “fazenda”
      (1) É um trocadilho usado na Nova Zelândia
    • O Proxmox dá mais ênfase ao gerenciamento do host e dos recursos sobre ele. Isso inclui migração ao vivo de VMs entre hosts, alguma alta disponibilidade e suporte a failover
      Se quiser, você também poderia usar ferramentas como Terraform junto com o Proxmox para gerenciar a configuração interna das VMs
    • O Proxmox usa KVM para virtualização e Linux Containers(LXC) para contêineres
      Concordo que, para implantações de infraestrutura como código, Terraform ou Ansible fazem mais sentido. Quem usa Proxmox em homelab geralmente prefere gerenciamento manual e não se preocupa muito em implementar infraestrutura como código
      No trabalho, acredito firmemente em ambientes reproduzíveis e infraestrutura como código. Na prática, uso a combinação Vagrant, libvirt e KVM para subir rapidamente clusters locais para testes e desenvolvimento, e funciona muito bem. Só que meu homelab não é complexo o suficiente para justificar configurar Terraform/Ansible. Talvez eu mude de ideia se o servidor quebrar
    • Dá para chegar a um meio-termo com o provedor do Proxmox para Terraform[1]
      O fluxo é provisionar VMs com Terraform e configurá-las/mantê-las com algo como Ansible
      Se quiser mirar em LXC, também é possível reservar LXC com esse provedor
      [1]: https://github.com/Telmate/terraform-provider-proxmox

  • Do ponto de vista de alguém que está pesquisando para montar seu primeiro equipamento com Proxmox, eu queria uma configuração bem básica e comum
    A estrutura seria: modem > equipamento Proxmox > VM do OPNsense > roteador Wi-Fi físico via NIC onboard de 10 Gb + VMs de rede interna como OMV. O objetivo é adicionar filtragem para toda a rede com o OPNsense e permitir acesso a servidor de mídia, backups etc. na rede interna
    Mas não vejo script para OPNsense, e o script do OMV precisa ser uma VM, não um contêiner LXC, então na prática é uma forma não recomendada; também não vejo um script de “cola” para fazer as VMs se comunicarem entre si. Essa parte é importante na configuração do Proxmox, então parece haver espaço para melhorar ou adicionar um script de configuração básica simples de servidor doméstico

    • Isso não é uma configuração básica e comum. Para mim é, mas talvez não seja para você, e certamente não é para a maioria
      Querer virtualizar o roteador e o firewall não tem problema. Já implantei cerca de 200 firewalls/roteadores pfSense em VMs e equipamentos físicos, e o OPNSense é parecido, então acho que posso ajudar
      No mínimo, você precisa de duas interfaces físicas. Dá para fazer com uma só, mas é preciso saber exatamente o que está fazendo. Você precisa de uma “WAN” e uma “LAN”. O OPNSense provavelmente ainda é baseado em FreeBSD, então obviamente não roda em um contêiner Linux LXC
      O último parágrafo está um tanto confuso. Não sei o que você quer dizer com “script de cola”. VMs se comunicam pela rede
      Para entender virtualização direito, recomendo fazer alguns experimentos e só então seguir em frente. Se tiver problemas específicos, venha ao fórum do Proxmox que ajudaremos, mas no fim das contas é uma questão de mergulhar de verdade ou não
    • Uso Proxmox e também configurei VLAN
      A porta que vai do roteador para o equipamento Proxmox está configurada para pacotes etiquetados, separando o tráfego de entrada e saída
      Depois, VMs e contêineres são facilmente configurados para “viver” em uma ou mais redes
      No meu caso, as regras de firewall do roteador decidem qual tráfego será encaminhado entre as VLANs
      Acho que, mesmo rodando o OPNSense como contêiner ou VM, dá para configurá-lo da mesma forma para encaminhar seletivamente o tráfego entre VLANs
    • Acho que não havia script para OPNSense porque um único erro de configuração poderia expor a instância do Proxmox à internet
      Para usuários avançados, é simples o bastante subir uma VM a partir da ISO. Também houve recentemente um pedido de script para OPNSense
      Quanto ao OMV, concordo. Dá para usar como está, mas não é o modo de uso que as pessoas normalmente querem. Há alguns dias foram adicionados comentários ao script
      Você disse que não há um script de cola para fazer as VMs se comunicarem, mas tecnicamente existe um script do Tailscale que ajuda a fazer com que elas se comuniquem via Tailscale :)
      Esses scripts foram projetados para configurar contêineres LXC autocontidos. Estamos evitando criar nosso próprio Kubernetes
    • Uso uma VM do OPNSense no Proxmox e também tenho várias NICs. Uma delas é dedicada ao ONT da conexão de fibra
      Também uso uma malha Wi-Fi externa
      Tenho também algumas outras VMs. Uma VM do unRaid que hospeda Docker com passthrough de placa SATA por compatibilidade legada, uma VM para o Home Assistant OS e muitos LXCs. Funciona muito bem
    • Não sei o que você quer dizer com “script de cola para fazer as VMs se comunicarem”
      Não é só usar a rede como em qualquer outro computador?
      Nunca fiz nenhuma configuração especial para fazer VMs se comunicarem entre si

  • Com certeza pretendo dar uma olhada em Docker LXC e VM do Home Assistant
    Até agora eu vinha usando Docker com sucesso dentro de uma VM no Proxmox, mas talvez dê para extrair ainda mais eficiência

    • Rodar HAOS como VM no Proxmox funciona bem
      Usei alguns scripts auxiliares do tteck para configurar contêineres LXC com MQTT e zigbee2mqtt, e fiz passthrough de um dispositivo USB Zigbee
    • Os scripts para esses dois projetos funcionam muito bem
      Para o Home Assistant, recomenda-se HAOS VM em vez de LXC ou Docker

  • Decidi rodar Proxmox no meu homelab em vez de Kubernetes, e me arrependo um pouco disso
    LXC é excelente, mas ficar limitado a LXC ou VMs QEMU não atende a todas as minhas necessidades. Com Kubernetes, eu poderia adicionar suporte a VMs leves, como o hipervisor Firecracker ou unikernels, por meio de projetos como Kata, mas o Proxmox não tem extensibilidade
    Além disso, ele não é tão adequado para automação ou builds reproduzíveis quanto um gerenciador de pods consolidado como Kubernetes. Pelo que encontrei, também não há suporte a Terraform, então eu teria que depender de backups de disco inteiro e ferramentas do tipo Chef/Ansible/Puppet, nas quais não quero investir tempo para reaprender
    Ainda assim, o gerenciamento de recursos e o modelo de passthrough são muito bons, a configuração e a manutenção são fáceis, e o painel de controle também é decente

    • Com certeza o modelo de implantação é diferente. Tem desvantagens, mas eu gosto
      Dito isso, há um módulo Terraform da comunidade: https://registry.terraform.io/providers/Telmate/proxmox/late...
      Nunca usei pessoalmente e normalmente escolho Ansible
      O ZFS, que é fácil de instalar, também torna difícil me convencer a tentar outra coisa. Se quiser brincar com Kubernetes, é só subir uma ou várias VMs
    • Eu mergulhei bem fundo no NixOS
      Por um tempo rodei Docker Swarm em vários computadores de placa única, depois Kubernetes, um servidor grande rodando Ubuntu + Cockpit, passei pelo Proxmox e acabei ficando no NixOS
      O NixOS tem um suporte razoável a contêineres quando necessário, mas, graças à sua natureza declarativa, acabo quase não usando contêineres. Para “remover” algo, geralmente basta tirar do arquivo de configuração e reconstruir. Também não é difícil fazer coisas no estilo cgroup para gerenciamento de memória e afins
      Também acho excelente a DSL de nginx do NixOS. É muito bom a própria configuração gerenciar as definições de proxy e o Let’s Encrypt diretamente, e do jeito certo, em vez de eu escrever scripts
      Não sei se existem ferramentas para NixOS distribuído, mas acho que algo bacana poderia ser construído em cima de Flakes
      Meu homelab está agora no ponto mais simples e com o maior nível de satisfação
    • Usei este provedor Terraform[1] junto com a distribuição Talos[2] para implantar um cluster Kubernetes
      Concordo que a API fornecida pelo Proxmox não é completa, mas é suficiente para as minhas necessidades
      Rodo o cluster em quatro máquinas SFF quase aposentadas e faço backup de snapshots LVM em um armazenamento TrueNAS que montei eu mesmo; gosto de toda essa configuração
      [1] https://github.com/Telmate/terraform-provider-proxmox
      [2] https://factory.talos.dev/
    • Usar Proxmox não significa que você não possa usar Kubernetes
      Basta criar VMs no Proxmox, instalar Kubernetes nelas e executar as cargas de trabalho das aplicações no Kubernetes
      VMs do Proxmox são mais difíceis de automatizar, então você precisa tratá-las como “pets, não gado”, mas isso também vale ao gerenciar hosts Kubernetes em bare metal. A diferença é que, com VMs sobre Proxmox, você consegue fazer backup e migração da VM inteira pelo Proxmox, obtendo as vantagens tanto do Proxmox quanto do Kubernetes
    • Cada tecnologia tem a abordagem e o caso de uso adequados
      No Proxmox, criar ou modificar VMs com o utilitário de linha de comando pve é relativamente simples
      Ainda assim, o ponto de partida deste post é que há muitos scripts úteis que tornam a administração mais fácil e sustentável, e que existe gratidão por essa ajuda em um momento em que o fundador precisa se afastar

  • Que recursos o Proxmox tem que um KVM simples não tem? É só uma interface web?

    • Só de cabeça: clustering, migração, alta disponibilidade, backups, integração com Ceph, redes virtuais mais recentes e suporte não só a VMs, mas também a contêineres
      A interface web também é opcional. Para mais detalhes, é melhor ver a página do Proxmox
    • KVM é apenas o componente do lado do kernel, não um gerenciador de máquinas virtuais completo por si só. Ele sempre precisa de uma aplicação em espaço de usuário
      Firecracker, QEMU e Cloud-Hypervisor são gerenciadores de máquinas virtuais construídos sobre KVM
      A forma comum de o QEMU usar KVM é essa, mas executar o QEMU diretamente é bem trabalhoso. Por isso acabamos usando ferramentas que envolvem o QEMU, como libvirt ou Proxmox

  • É uma comunidade excelente. Já usei alguns scripts e estou rodando contêineres LXC de Pi-hole e Paperless
    Também estou ansioso pelo Appflowy

  • Infelizmente, embora o Proxmox use a palavra “Enterprise” no primeiro parágrafo do site, até hoje ele não oferece suporte nativo a criptografia de disco inteiro
    Claro, dá para instalá-lo sobre um Debian criptografado manualmente, mas você perde recursos importantes e precisa arcar com isso sozinho. No fim, isso vem do fato de o ZFS não tratar criptografia de disco inteiro como recurso de primeira classe
    É uma situação muito lamentável