{ "meta": { "title": "Perguntas frequentes | Documentação ProxMenux", "description": "Perguntas frequentes sobre o ProxMenux: funcionalidades, instalação, compatibilidade a partir do PVE 8, personalização, atualizações, segurança, uso em produção, ficheiros do sistema, contributos e desinstalação.", "ogTitle": "Perguntas frequentes | Documentação ProxMenux", "ogDescription": "Perguntas frequentes sobre instalação, compatibilidade, segurança e contribuição do ProxMenux." }, "header": { "title": "Perguntas frequentes", "description": "Perguntas comuns sobre o ProxMenux: o que é, a quem se destina, instalação, atualização, desinstalação, compatibilidade, personalização, segurança e contributos. Se não encontrar a sua pergunta, consulte GitHub Discussions ou abra uma issue.", "section": "Sobre" }, "quickLinks": { "title": "Ligações rápidas", "installationLabel": "Instalação", "installationSuffix": " — o comando de instalação de uma linha + dependências.", "introductionLabel": "Introdução", "introductionSuffix": " — o que faz ProxMenux, em 5 minutos.", "uninstallLabel": "Desinstalar", "uninstallSuffix": " — remoção limpa.", "issuesLabel": "GitHub Issues", "discussionsLabel": "Discussões" }, "q1": { "question": "O que é o ProxMenux e para que é utilizado?", "p1Rich": "ProxMenux é uma ferramenta de menu interativa projetada para tornar o Proxmox VE acessível a todos os usuários, independentemente de sua experiência técnica. Ele simplifica a execução de comandos, permitindo que os usuários executem ações em seu sistema sem exigir conhecimento avançado do Linux.", "p2": "Os utilizadores menos experientes executam comandos através de menus estruturados, reduzindo a escrita manual no terminal. Os administradores experientes poupam passos em tarefas repetitivas: reforço de segurança após a instalação, passthrough de GPU, importação de VM OVF e rotação de snapshots ZFS.", "p3": "Proxmox VE é amplamente utilizado para:", "items": [ "Virtualização de nível empresarial", "HomeLab e soluções de nuvem pessoal", "Servidores multimídia, automação e muito mais" ] }, "q2": { "question": "Como faço para instalar ProxMenux?", "p1Rich": "Siga o guia de instalação. Em resumo:", "stableInstall": "bash -c \"$(wget -qLO - https://raw.githubusercontent.com/MacRimi/ProxMenux/main/install_proxmenux.sh)\"", "p2": "Uma vez instalado, basta iniciar com:", "menuCmd": "menu" }, "q3": { "question": "O ProxMenux é compatível com todas as versões do Proxmox?", "bodyRich": "Não — o ProxMenux requer Proxmox VE 8 ou posterior. O PVE 7 e as versões anteriores não são suportados. Se ainda usa o PVE 7, atualize primeiro para 8.x segundo o procedimento oficial do Proxmox. Depois, o ProxMenux pode tratar da passagem de 8 para 9 em Utilitários → Atualizar PVE 8 para PVE 9." }, "q4": { "question": "Posso personalizar ProxMenux?", "p1Rich": "As atualizações podem substituir alterações locais aos scripts principais, pelo que deve evitar editar esses ficheiros diretamente. O que pode personalizar:", "items": [ "O banner do console através da ferramenta FastFetch nas opções de Post-Install.", "Quais componentes opcionais são instalados (Monitor, Fail2Ban, Lynis...) — escolha durante a instalação ou através do menu relevante mais tarde." ] }, "q5": { "question": "Como faço para atualizar o ProxMenux?", "p1Rich": "Quando há uma nova versão, o ProxMenux deteta-a na próxima execução de menu e propõe a atualização. Se aceitar, os ficheiros e a configuração da ferramenta são substituídos na instalação existente, sem downloads manuais.", "p2Rich": "Os utilizadores da versão estável recebem atualizações estáveis; os da beta recebem atualizações beta. Quando é publicada uma versão estável, a beta avisa na próxima abertura do menu e propõe a mudança automática. Consulte o programa beta." }, "q6": { "question": "Onde posso comunicar problemas ou sugerir funcionalidades?", "p1Rich": "Comunique erros em GitHub Issues. Inclua os passos para os reproduzir, a mensagem de erro e, quando relevante, a saída do Monitor obtida com journalctl -u proxmenux-monitor -n 50.", "p2Rich": "No caso de problemas de segurança, não publique os detalhes. Siga o procedimento de divulgação responsável no código de conduta e boas práticas." }, "q7": { "question": "Posso contribuir para o ProxMenux?", "p1Rich": "Claro. O ProxMenux é um projeto colaborativo e de código aberto. Pode contribuir com código (Bash, Next.js/TypeScript e ferramentas de tradução em Python), testes, documentação, design ou ideias.", "item1Rich": "Discuta as ideias em GitHub Discussions antes de abrir um pedido de funcionalidade.", "item2Rich": "Antes de enviar uma pull request, leia o código de conduta e boas práticas.", "item3Rich": "Consulte a página de colaboradores para saber quem participa atualmente nos testes e revisões." }, "q8": { "question": "ProxMenux modifica arquivos críticos do sistema?", "p1Rich": "A instalação do ProxMenux adiciona os seguintes componentes.", "item1Rich": "Dependências via apt: dialog, curl, jq e git. As traduções usam catálogos JSON pré-gerados; o instalador não adiciona ao anfitrião um ambiente virtual de tradução.", "item2Rich": "A árvore de scripts em /usr/local/share/proxmenux/.", "item3Rich": "O comando de arranque em /usr/local/bin/menu.", "item4Rich": "Opcional: o serviço systemd do Monitor, proxmenux-monitor.service.", "p2Rich": "O ProxMenux não altera a configuração principal do Proxmox, salvo se o pedir explicitamente num menu específico. Por exemplo, a reparação de rede edita /etc/network/interfaces, mas apenas após a sua confirmação e a criação de uma cópia de segurança." }, "q9": { "question": "É seguro usar ProxMenux na produção?", "bodyRich": "Sim. Como o ProxMenux só altera os ficheiros principais do Proxmox quando solicitado explicitamente, pode ser usado em ambientes de produção. Como em qualquer automação, teste primeiro num ambiente controlado e tenha cópias de segurança antes de operações destrutivas: atualização do PVE 8 para 9, formatação de discos, eliminação de VM, entre outras." }, "q10": { "question": "Como faço para desinstalar ProxMenux?", "p1Rich": "No ProxMenux: Definições → Desinstalar ProxMenux. A desinstalação remove os scripts, o comando de arranque e o serviço Monitor, além das dependências selecionadas, se assim escolher. Restaura /root/.bashrc e /etc/motd a partir das cópias criadas na instalação, caso existam.", "p2Rich": "Passo a passo completo: Desinstalar ProxMenux." }, "q11": { "question": "VirusTotal sinaliza o URL de instalação — é seguro?", "p1Rich": "O resultado de 1/95 do motor Chong Lua Dao, comunicado na issue #162, foi identificado pelo responsável do projeto como um falso positivo. O instalador usa o padrão curl | bash e pode descarregar jq da sua versão oficial no GitHub. Este comportamento pode ativar análises heurísticas; esse relatório histórico não avalia todos os downloads futuros.", "p2Rich": "O ProxMenux é totalmente de código aberto e pode analisar o script de instalação linha a linha: install_proxmenux.sh. Mais contexto na issue #162." } }