Sobre o projeto
O Proxmox VE Helper-Scripts (Community Edition) é uma coleção mantida pela comunidade de scripts de automação que instalam e configuram serviços auto-hospedados no Proxmox VE. Em vez de procurar pacotes manualmente e editar arquivos de configuração, os usuários colam um único comando no shell do Proxmox, respondem a algumas perguntas e terminam com um contêiner ou máquina virtual funcionando.
O projeto é apresentado como uma continuação da comunidade construída sobre a base do trabalho original de tteck, e é mantido por uma pequena equipe central juntamente com contribuidores externos. Os scripts são licenciados sob MIT, podendo ser usados, modificados e redistribuídos para fins pessoais e comerciais.
Requisitos
- Proxmox VE versão 8.4, 9.0, 9.1 ou 9.2 (um host Proxmox baseado em Debian).
- Acesso ao shell root no host Proxmox.
- Uma conexão com a internet durante a instalação.
Primeiros passos
1. Navegue pelo site do projeto para encontrar o serviço desejado, por exemplo Home Assistant, Nginx Proxy Manager ou Jellyfin.
2. Copie o comando de instalação de uma linha mostrado na página daquele script.
3. Abra o shell do Proxmox e cole o comando.
4. Escolha entre a configuração padrão ou avançada e siga as instruções.
Cada página de script é documentada com o que o contêiner inclui, sua alocação padrão de recursos e notas após a instalação.
Como os scripts se comportam
O modo padrão seleciona configurações sensatas de CPU, RAM e armazenamento por padrão e faz apenas as perguntas mínimas necessárias, com a maioria das instalações concluídas em menos de cinco minutos. O modo avançado expõe configurações de contêiner, rede, backends de armazenamento e configuração específica do aplicativo antes que qualquer coisa seja instalada. Após a instalação, cada contêiner inclui um assistente pós-instalação acessível pelo shell do Proxmox, que pode aplicar atualizações ao serviço instalado, alterar configurações do aplicativo sem editar manualmente arquivos de configuração e fornecer solução básica de problemas e acesso aos logs.
Escopo da coleção
O README descreve a cobertura de centenas de serviços, agrupados por categorias como automação residencial (Home Assistant, Zigbee2MQTT, ESPHome, Node-RED), mídia (Jellyfin, Plex, Radarr, Sonarr, Immich), rede (AdGuard Home, Nginx Proxy Manager, Pi-hole, Traefik), monitoramento (Grafana, Prometheus, Uptime Kuma, Netdata), bancos de dados (PostgreSQL, MariaDB, Redis, InfluxDB), segurança (Vaultwarden, CrowdSec, Authentik) e ferramentas de desenvolvimento (Gitea, Portainer, VS Code Server, n8n). Uma lista completa e regularmente atualizada é publicada nas páginas de categoria do site do projeto.
Contribuindo
Novos scripts não são aceitos diretamente neste repositório: eles são primeiro submetidos e testados no repositório separado ProxmoxVED, e pull requests adicionando novos scripts aqui são fechados. Correções de bugs e melhorias nos scripts existentes pertencem a este repositório e devem seguir as diretrizes de contribuição, com uma alteração focada por pull request e documentação do que o script instala além de quaisquer decisões não óbvias no arquivo JSON de metadados correspondente. Bugs são relatados através do rastreador de issues, solicitações e perguntas através de discussões ou do Discord do projeto, e vulnerabilidades de segurança através da política de segurança.
Suporte e licenciamento
O projeto é mantido por voluntários, com custos de infraestrutura pagos do próprio bolso; o README afirma que 30% de todas as doações são encaminhadas para pesquisa contra o câncer e cuidados hospice, uma causa importante para tteck. Proxmox é uma marca registrada da Proxmox Server Solutions GmbH, e o código é lançado sob a Licença MIT.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.