{ "meta": { "title": "Instalar o ProxMenux | Documentação do ProxMenux", "description": "Instale o ProxMenux com um comando em anfitriões Proxmox VE 8 ou posteriores. Inclui catálogos JSON pré-gerados em oito idiomas: inglês, espanhol, francês, alemão, italiano, português, eslovaco e sueco. Escolha o idioma na instalação ou altere-o depois nas definições. O canal beta permite experimentar antecipadamente as novas funcionalidades.", "ogTitle": "Instalar o ProxMenux | Documentação do ProxMenux", "ogDescription": "Instale ProxMenux em Proxmox VE 8+ em um comando. Canais estáveis e beta disponíveis." }, "header": { "title": "Instalar o ProxMenux", "description": "Um instalador que se inicia numa linha em qualquer anfitrião Proxmox VE 8 ou posterior. Instala automaticamente as dependências, descarrega os scripts, configura o comando de arranque do menu e pede o idioma na primeira execução. Dois canais: estável (predefinido) e beta.", "section": "Instalação" }, "stable": { "heading": "Instalar", "intro": "Execute isto no terminal da sua máquina Proxmox:", "code": "bash -c \"$(wget -qLO - https://raw.githubusercontent.com/MacRimi/ProxMenux/main/install_proxmenux.sh)\"" }, "during": { "heading": "Durante a instalação", "intro": "O ProxMenux instala automaticamente e configura as dependências de que necessita:", "tablePackage": "Pacote", "tablePurpose": "Finalidade", "rows": [ { "package": "dialog", "purpose": "Menus de terminal interativos" }, { "package": "curl", "purpose": "Transferências e verificações de conectividade" }, { "package": "jq", "purpose": "Processamento JSON" }, { "package": "git", "purpose": "Clonagem e atualização de repositórios" } ], "outro": "O instalador também descarrega os scripts para /usr/local/share/proxmenux/ e cria o comando de arranque /usr/local/bin/menu. O painel web ProxMenux Monitor é registado como serviço proxmenux-monitor.service.", "imageAlt": "Instalação ProxMenux em curso" }, "first": { "heading": "Primeiro arranque", "intro": "Uma vez instalado, execute:", "code": "menu", "outro": "O ProxMenux abre no menu principal, onde pode iniciar os procedimentos documentados neste site. Num anfitrião Proxmox recém-instalado, Pós-instalação é um bom ponto de partida." }, "beta": { "heading": "Canal Beta", "calloutTitle": "O que é o Programa Beta?", "calloutBody": "Quer experimentar as novidades antes do lançamento oficial e ajudar a definir a versão final? O programa beta do ProxMenux dá acesso antecipado às novas funcionalidades, incluindo as últimas compilações do Monitor, a partir do ramo develop. As versões beta podem conter erros ou funções incompletas. Os seus comentários ajudam a corrigi-los antes da versão estável.", "intro": "Instale a versão beta em vez da estável com:", "code": "bash -c \"$(wget -qLO - https://raw.githubusercontent.com/MacRimi/ProxMenux/develop/install_proxmenux_beta.sh)\"", "outro": "A beta é opcional: tem de executar explicitamente o respetivo instalador. Quando é publicada uma versão estável, o ProxMenux avisa na próxima execução de menu e propõe a mudança automática. Para sair antes da beta, escolha Desativar programa beta nas definições." }, "updating": { "heading": "Actualização", "body": "O ProxMenux gere as suas atualizações. Quando há uma nova versão, a próxima execução de menu propõe a instalação. Ao aceitar, os ficheiros e a configuração da ferramenta são substituídos na instalação existente, sem downloads manuais. O canal estável recebe versões estáveis e a beta recebe versões beta, com a proposta de mudança descrita acima. O aviso depende de onde executa menu: por SSH ou na consola Proxmox, surge um diálogo sim/não e a aceitação aplica a atualização imediatamente. No terminal WebSocket do ProxMenux Monitor surge uma mensagem informativa, porque esse terminal seria interrompido durante a operação. A mensagem apresenta o instalador numa linha (bash -c \"$(wget -qLO - https://raw.githubusercontent.com/MacRimi/ProxMenux/main/install_proxmenux.sh)\" para estável, ou o URL equivalente de install_proxmenux_beta.sh para beta), que deve executar por SSH ou na consola." }, "uninstall": { "heading": "Desinstalar", "body": "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 pelo Post-Install, caso existam (caso contrário, remove a linha do ProxMenux do MOTD). Procedimento completo: Desinstalar ProxMenux." }, "troubleshoot": { "heading": "Resolução de Problemas", "virustotalTitle": "VirusTotal sinaliza o URL de instalação", "virustotalBody": "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 é executado com um comando que descarrega e executa o script (bash -c \"$(wget -qLO - …)\") 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. O código do instalador é aberto e pode ser analisado. Mais contexto na issue #162.", "aptTitle": "A instalação falhou com erros apt", "aptBody": "Normalmente falta um repositório Proxmox ou está mal configurado. O instalador obtém as dependências via apt, que falha se a configuração dos repositórios estiver incorreta. É comum em instalações mínimas do Proxmox 8 ainda não atualizadas. Execute primeiro apt-get update manualmente, resolva todos os erros e volte a executar o instalador.", "menuTitle": "`menu: command not found` após a instalação", "menuBody": "O comando de arranque está em /usr/local/bin/menu. Confirme com ls -lh /usr/local/bin/menu. Se faltar, a instalação terminou antes de concluir: execute-a novamente. Se existir mas o comando não for encontrado, PATH não inclui /usr/local/bin. Corrija PATH ou execute diretamente /usr/local/bin/menu.", "stuckTitle": "A instalação trava ou não avança", "stuckBody": "Se uma instalação, reinstalação ou atualização ficar presa por causa de um problema de conexão, cancele com Ctrl + C e execute o instalador manualmente.", "otherTitle": "Outros problemas", "otherBody": "Consulte GitHub Issues para problemas conhecidos ou abra uma issue com os registos relevantes. Se usar a beta e o problema estiver relacionado com o Monitor, inclua a saída de journalctl -u proxmenux-monitor -n 50." }, "next": { "heading": "E agora?", "postInstall": "Script de pós-instalação — ajustes e reforço de segurança de um anfitrião Proxmox recém-instalado.", "introduction": "Introdução — apresentação completa das funcionalidades.", "monitor": "ProxMenux Monitor — painel web para o host (instalado automaticamente ao lado do menu)." }, "requirements": { "heading": "Requisitos e boas práticas", "reqTitle": "Requisitos", "reqBody": "Proxmox VE 8.x ou posterior. O PVE 7 e as versões anteriores não são suportados. O anfitrião precisa de acesso à Internet para descarregar scripts, dependências e a AppImage do ProxMenux Monitor. Execute o instalador como root no anfitrião Proxmox.", "inspectTitle": "Sempre inspecione scripts que você executa da internet", "inspectReview": "Reveja o código do instalador antes de executar.", "inspectCoc": "Todas as ligações executáveis seguem o código de conduta do ProxMenux." } }