Mirrors/ProxMenux
1
0
Fork 0
mirror of https://github.com/MacRimi/ProxMenux.git synced 2026-11-02 19:02:31 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs: review post-install documentation in all seven translations

Browse Source
This commit is contained in:
Jonatan
2026-10-17 15:08:53 +02:00
parent ce1a3de719
commit 11b1c895f4
119 changed files with 12203 additions and 337 deletions
Download Patch File Download Diff File Expand all files Collapse all files
web/messages/pt/docs/post-install/automated.json
+172
View File
@@ -0,0 +1,172 @@
{
"meta": {
"title": "Script pós-instalação automatizado | Documentação ProxMenux",
"description": "O script pós-instalação automatizado ProxMenux executa 14 otimizações predefinidas adaptadas ao hardware num host Proxmox VE novo. Não tem lista de funções para selecionar, mas pode pedir confirmação para ocultar o aviso de subscrição, instalar Log2RAM em certos casos e reiniciar. As alterações reversíveis ficam registadas.",
"ogTitle": "Script pós-instalação automatizado | Documentação ProxMenux",
"ogDescription": "14 otimizações predefinidas adaptadas ao hardware para um host Proxmox VE novo, com confirmações para algumas ações e registo de alterações reversíveis."
},
"header": {
"title": "Script pós-instalação automatizado",
"description": "O ProxMenux executa 14 otimizações de base predefinidas sem lista de funções para selecionar. Algumas ações pedem confirmação. As alterações reversíveis ficam registadas em Desinstalar otimizações; as atualizações de pacotes não são descritas como reversíveis.",
"section": "Pós-instalação · Automatizada"
},
"intro": {
"title": "Quando escolher Automatizado",
"body": "Execute isso em um host Proxmox recém-instalado quando desejar uma linha de base sensata sem tomar decisões. O script é idempotente – executá-lo duas vezes é seguro, basta reaplicar as mesmas configurações. Recursos opcionais (Fastfetch, IOMMU, repositório Ceph, HA, correções AMD…) intencionalmente <strong>não</strong> fazem parte deste caminho; escolha-os em <link>Personalizáveis</link> se precisar deles."
},
"applies": {
"heading": "O que o script aplica",
"intro": "As otimizações são aplicadas nesta ordem exata. A coluna <em>Categoria</em> liga à documentação detalhada de cada alteração na referência personalizável.",
"headerNum": "#",
"headerTool": "Ferramenta",
"headerWhat": "O que ele faz",
"headerCategory": "Categoria"
},
"optimizations": [
{
"tool": "Repositórios APT + atualização completa",
"what": "Desativa as fontes Enterprise pve-enterprise.sources e ceph.sources, cria uma fonte no-subscription para o nome de código Debian do host e executa apt update && apt full-upgrade -y (comando oficial de atualização Proxmox).",
"category": "Configurações básicas",
"categorySlug": "basic-settings"
},
{
"tool": "Remoção de banner de assinatura",
"what": "Aplica patches na interface web para ocultar o banner 'Sem assinatura válida'. Pede confirmação antes de aplicar; reversível de Desinstalar Otimizações.",
"category": "Personalização",
"categorySlug": "customization"
},
{
"tool": "Forçar IPv4",
"what": "Escreve /etc/apt/apt.conf.d/99-force-ipv4 para o apt usar apenas IPv4, contornando ligações IPv6 instáveis aos espelhos.",
"category": "Rede",
"categorySlug": "network"
},
{
"tool": "Ignorar pacotes de idioma",
"what": "Escreve /etc/apt/apt.conf.d/99-disable-translations para deixar de transferir índices de descrições traduzidas de pacotes, reduzindo os dados das atualizações apt.",
"category": "Configurações básicas",
"categorySlug": "basic-settings"
},
{
"tool": "Aumentar os limites do sistema",
"what": "Aumenta as monitorizações inotify, os limites nofile/nproc, os limites do chaveiro do kernel e fs.file-max através de sysctl.d, limits.d, pam e systemd, para hosts com muitos contentores.",
"category": "Sistema",
"categorySlug": "system"
},
{
"tool": "Ajuste de memória",
"what": "Define vm.swappiness=10, proporções equilibradas de páginas modificadas ainda não gravadas, vm.max_map_count=262144 e compactação proativa quando suportada. A política de sobrealocação de memória do kernel mantém a predefinição Proxmox.",
"category": "Sistema",
"categorySlug": "system"
},
{
"tool": "Comportamento de pânico no Kernel",
"what": "Configura o host para reiniciar 10 segundos após um pânico / oops / hardlockup em vez de congelar indefinidamente.",
"category": "Sistema",
"categorySlug": "system"
},
{
"tool": "Ajuste de pilha de rede",
"what": "Dimensionamento dos buffers TCP, reforço IPv4 (redirecionamentos desligados, rp_filter=2, registo martian desligado), portas locais 1024-65535, deteção MTU TCP, RFC 1337 e script /usr/local/sbin/proxmenux-fwbr-tune ligado a uma unidade systemd de execução única e regra udev. Assim, rp_filter=0 / log_martians=0 são reaplicados às interfaces fwbr*/fwln*/fwpr*/tap* sempre que Proxmox as recria ao iniciar/parar VMs, reiniciar ou migrar em funcionamento.",
"category": "Rede",
"categorySlug": "network"
},
{
"tool": "Personalização de bashrc (root)",
"what": "PS1 colorido, aliases comuns (l/la/ll/ls/grep), histórico com datas e horas e carregamento de bash-completion, num bloco delimitado PMX_CORE_BASHRC fácil de remover.",
"category": "Personalização",
"categorySlug": "customization"
},
{
"tool": "Log2RAM (adaptado a SSD, automático)",
"what": "Reduz o desgaste SSD/NVMe movendo /var/log para um ramdisk tmpfs com sincronização periódica para disco. Instalação a partir do projeto original quando o disco raiz é SSD ou NVMe. Dimensiona pela RAM do host (128M / 256M / 512M), agenda sincronização periódica e proteção automática que limpa journals antigos aos 80% e trunca registos muito ativos aos 92% antes de gravar. Ajusta limites journald ao ramdisk. Detalhes em <link>Log2RAM</link>.",
"category": "Armazenamento",
"categorySlug": "storage"
},
{
"tool": "Autotrim ZFS (apenas SSD)",
"what": "Ativa zpool autotrim=on em cada pool ZFS cujos vdevs sejam todos SSD/NVMe com TRIM (verifica /sys/block/[dev]/queue/rotational e discard_granularity). Ignora automaticamente pools com HDDs. Só regista para desinstalação os pools realmente alterados pelo ProxMenux; autotrim ativado manualmente é preservado.",
"category": "Armazenamento",
"categorySlug": "storage"
},
{
"tool": "Limites de tamanho do journald",
"what": "Força armazenamento persistente, limita SystemMaxUse=64M / RuntimeMaxUse=60M e ativa compressão e registos de nível info necessários ao Monitor. É ignorado se Log2RAM estiver ativo, pois faz o seu próprio ajuste.",
"category": "Sistema",
"categorySlug": "system"
},
{
"tool": "Ajuste de logrotate",
"what": "Define globalmente daily e depois size 10M, retém 7 rotações e ativa compressão e copytruncate. O critério de tamanho posterior prevalece; regras específicas podem substituí-lo. Adequado ao Log2RAM, mas a frequência depende das regras e do temporizador.",
"category": "Sistema",
"categorySlug": "system"
},
{
"tool": "Nomes de interface persistentes",
"what": "Escreve um ficheiro <code>/etc/systemd/network/10-proxmenux-&lt;iface&gt;.link</code> por placa física, com cabeçalho «Managed by ProxMenux», associando o MAC ao nome atual. Os nomes <code>eth0</code> / <code>enp…</code> ficam estáveis após reinícios e adição de placas.",
"category": "Rede",
"categorySlug": "network"
}
],
"hardwareTitle": "Predefinições adaptadas ao hardware",
"hardwareBody": "O script lê o hardware do host antes de aplicar as configurações. Log2RAM é instalado apenas em discos raiz SSD / NVMe por padrão (ele avisa se a detecção indicar o contrário). O tamanho do ramdisk Log2RAM é escolhido do total RAM (<code>≤ 8 GB → 128M</code>, <code>≤ 16 GB → 256M</code>, <code>'>' 16 GB → 512M</code>). Os limites journald correspondem ao tamanho do disco RAM quando Log2RAM está ativo, para evitar preenchê-lo.",
"upgrade": {
"heading": "Atualizar listas de pacotes e sistema",
"intro": "O primeiro passo do percurso automatizado é atualizar o Proxmox. Para um host em funcionamento dentro da mesma versão principal, o Proxmox recomenda:",
"after": "Esta linha é o comando oficial das versões atuais do Proxmox. O script automatizado executa <strong>exatamente</strong> isso e acrescenta a limpeza dos repositórios e as tarefas após atualização recomendadas pelo guia — como o utilitário independente <link>Atualização do sistema Proxmox</link>:",
"items": [
"Desativa as fontes Enterprise <code>pve-enterprise.sources</code> / <code>ceph.sources</code>, remove ficheiros antigos de repositórios e cria uma fonte no-subscription para o nome de código do host.",
"Executa a atualização não-interativa com <code>DEBIAN_FRONTEND=noninteractive</code> e <code>--force-confdef --force-confold</code> — os arquivos de configuração que você personalizou permanecem seus quando o upstream também os alterou.",
"Instala pacotes essenciais do Proxmox em falta (<code>zfsutils-linux</code>, <code>proxmox-backup-restore-image</code>, <code>chrony</code>).",
"Verificação de sanidade de metadados LVM, <code>apt-get autoremove -y</code> + <code>apt-get autoclean -y</code>, e um prompt de reinicialização apenas se o kernel realmente mudou."
],
"sameTitle": "Mesmo atualizador, dois pontos de entrada",
"sameBody": "O pacote automatizado e o utilitário independente <link>Proxmox System Update</link> compartilham os mesmos scripts subjacentes (<code>update-pve8.sh</code> / <code>update-pve9_2.sh</code>). Use o utilitário por conta própria quando você só quiser atualizar o host sem aplicar o resto das otimizações."
},
"endResult": {
"heading": "Resultado final esperado",
"body": "No fim, verá uma mensagem de sucesso com a saída de cada passo e uma pergunta de reinício, necessário para algumas definições do kernel. Pode adiá-lo; as definições aplicam-se no próximo arranque.",
"imageAlt": "Programa pós-instalação automatizado — saída final do terminal mostrando cada otimização aplicada com sucesso"
},
"notDoes": {
"heading": "O que este script NÃO faz",
"items": [
"Deteção automática do fuso horário (comentada no código original; use Personalizável se precisar).",
"Desativar portmapper / rpcbind (ver <secLink>Segurança</secLink>).",
"Activar IOMMU / VFIO (ver <virtLink>Virtualização</virtLink>).",
"Instalar Fastfetch / Figurine / repositório Ceph / HA / correções de CPU AMD (ver <optLink>Opcionais</optLink>).",
"Instalar pigz ou ajustar ZFS ARC (ver <perfLink>Desempenho</perfLink> / <storLink>Armazenamento</storLink>)."
]
},
"xshokTitle": "detecção xshok-proxmox",
"xshokBody": "Se o host tiver executado anteriormente o script <code>xshok-proxmox</code>, ProxMenux detecta o arquivo marcador e avisa você antes de continuar. Alguns ajustes podem se sobrepor. O script companheiro está desatualizado — se você decidir continuar de qualquer forma, reveja <link>a visão geral</link> para o contexto.",
"revert": {
"heading": "Revertendo",
"body": "Cada ferramenta da tabela fica registada em <code>/usr/local/share/proxmenux/installed_tools.json</code>. Abra <link>Desinstalar otimizações</link> para escolher os itens a reverter. As cópias dos ficheiros modificados ficam junto dos originais com sufixo <code>.bak</code>."
},
"related": {
"heading": "Relacionado",
"items": [
{
"label": "Pós-instalação personalizável",
"href": "/docs/post-install/customizable",
"tail": " — escolher exactamente o que pretende do mesmo catálogo."
},
{
"label": "Desinstalar otimizações",
"href": "/docs/post-install/uninstall",
"tail": " — reverter qualquer subconjunto do que foi aqui aplicado."
},
{
"label": "Comandos úteis do sistema",
"href": "/docs/help-info/system-commands",
"tail": " — verificar as alterações (uptime, free, journalctl, etc.)."
},
{
"label": "Visão geral da pós-instalação",
"href": "/docs/post-install",
"tail": "."
}
]
}
}
web/messages/pt/docs/post-install/basic-settings.json
+240
View File
@@ -0,0 +1,240 @@
{
"meta": {
"title": "Pós-instalação: Configurações básicas | Documentação ProxMenux",
"description": "Opções de pós-instalação fundamentais: mude para repositórios gratuitos do Proxmox e atualize, detecte automaticamente o fuso horário e habilite o NTP, pule downloads de linguagem APT e escolha os utilitários comuns do sistema 25 para instalar."
},
"header": {
"title": "Pós-instalação: Configurações básicas",
"section": "Configurações pós-instalação do Proxmox"
},
"intro": {
"title": "O que esta categoria abrange",
"body": "Cinco opções de base para um host Proxmox novo: usar repositórios comunitários sem subscrição, atualizar todo o sistema, configurar automaticamente o fuso horário e NTP, desativar traduções APT para poupar largura de banda e espaço e escolher entre 25 utilitários comuns."
},
"upgrade": {
"heading": "Atualizar listas de pacotes e sistema",
"intro": "Reconfigura o APT para usar o repositório <em>pve-no-subscription</em> gratuito (em vez do repositório corporativo que requer uma assinatura) e executa uma atualização completa do sistema. Os passos exatos dependem da versão principal do Proxmox VE: ProxMenux detecta e envia para o script certo.",
"headerVersion": "Versão PVE",
"headerScript": "Script de seleção por versão",
"headerCodename": "Nome de código Debian",
"rows": [
{
"version": "9.x",
"script": "update-pve9_2.sh",
"codename": "trixie"
},
{
"version": "8.x",
"script": "update-pve8.sh",
"codename": "bookworm"
}
],
"officialTitle": "A recomendação oficial da Proxmox",
"officialBody": "A própria orientação de atualização da Proxmox é executar, nesta ordem exata:",
"officialOutro": "É o comando habitual para atualizações dentro da versão principal instalada do Proxmox VE. Verifique os repositórios e as alterações propostas aos pacotes <em>antes</em> de continuar. A mudança de versão principal exige o procedimento oficial de migração.",
"doesTitle": "O que a opção ProxMenux faz — verificado contra o script",
"doesIntro": "A atualização ProxMenux executa os comandos apt acima e acrescenta passos prévios e posteriores que teria de gerir manualmente. Cada item abaixo corresponde ao script de seleção; consulte <link>Atualização do sistema Proxmox</link> para o detalhe completo.",
"doesItems": [
"<strong>Primeiro, organizar os repositórios.</strong> Desativa as fontes Enterprise <code>pve-enterprise.sources</code> / <code>ceph.sources</code>, remove ficheiros antigos de versões PVE anteriores e cria um <code>proxmox.sources</code> limpo para o canal gratuito <em>pve-no-subscription</em>, conforme o nome de código Debian: trixie para PVE 9, bookworm para PVE 8.",
"<strong>Reescreve os repositórios Debian</strong> com main / updates / security e <code>non-free-firmware</code>, para eliminar o aviso de firmware durante a atualização.",
"<strong>Executa a atualização oficial.</strong> <code>apt-get update</code> seguido por <code>apt full-upgrade -y</code> (PVE 9) ou <code>apt dist-upgrade -y</code> (PVE 8), ambos lançados não-interactivamente com <code>--force-confdef --force-confold</code> para que quaisquer arquivos de configuração que você personalizou permaneçam seus.",
"<strong>Instala pacotes essenciais</strong> se estiverem faltando: <code>zfsutils-linux</code>, <code>proxmox-backup-restore-image</code>, <code>chrony</code>.",
"<strong>Verifica os metadados LVM.</strong> Procura VMs com passthrough de discos que possam ter deixado cabeçalhos antigos de volumes físicos nos discos em bruto. Avisa sobre anomalias sem as corrigir automaticamente.",
"<strong>Limpa depois:</strong> <code>apt-get autoremove -y</code> + <code>apt-get autoclean -y</code>, então pede uma reinicialização se o kernel foi atualizado ou <code>/var/run/reboot-required</code> está presente."
],
"shortTitle": "Em suma",
"shortBody": "A opção executa o comando recomendado <code>apt update && apt full-upgrade -y</code>, com a organização dos repositórios e a limpeza final indicadas no guia oficial, e pede reinício no fim. Consulte <link>Atualização do sistema Proxmox</link> para o diagrama completo; o mesmo atualizador está disponível separadamente no menu principal.",
"subTitle": "Não aplicar a um host com subscrição",
"subBody": "Se você realmente tiver uma assinatura Proxmox e quiser continuar usando os repositórios empresariais, pule esta opção. Executando-o desabilita o repositório corporativo e encaminha o host para o canal comunitário. A atualização do pacote e reescrita do repositório não são apresentadas como reversíveis em Desinstalar Otimizações; restaure sua configuração do repositório deliberadamente se você precisar mudar de canal mais tarde.",
"safetyTitle": "Controlo de segurança pós-atualização",
"safetyBody": "Após a atualização, o script procura metadados antigos de volumes físicos (PV) nos discos. Pode acontecer quando uma VM com passthrough escreve cabeçalhos LVM num disco em bruto. Se detetar algo suspeito, avisa e sugere <code>pvs</code> para inspeção. Não altera nada automaticamente."
},
"time": {
"heading": "Sincronizar a hora automaticamente",
"intro": "Detecta o IP público do servidor via <code>dig myip.opendns.com @resolver1.opendns.com</code>, em seguida, consulta o <code>ipapi.co/'{'ip'}'/timezone</code> para procurar o fuso horário IANA correspondente, e aplica-o com o <code>timedatectl set-timezone</code>. Finalmente permite NTP com <code>timedatectl set-ntp true</code>.",
"depTitle": "Depende de dois serviços externos",
"depBody": "A pesquisa depende de OpenDNS e <code>ipapi.co</code> serem alcançáveis, e de suas respostas serem corretas. Se você executar o Proxmox atrás de uma VPN ou em um VLAN que sai de uma região diferente, o fuso horário detectado automaticamente pode estar errado. Nesse caso, ignore esta opção e defina o fuso- horário à mão:",
"revertTitle": "Reversível do menu Desinstalar",
"revertBody": "<link>Desinstalar otimizações</link> repõe o fuso horário em UTC, um valor seguro. NTP continua ativo: o relógio sincroniza e mostra UTC até definir outro fuso manualmente."
},
"languages": {
"heading": "ignorar o download de idiomas adicionais",
"intro": "Durante <code>apt update</code>, o APT pode transferir descrições de pacotes traduzidas além dos metadados principais. A opção desativa-as para poupar largura de banda e espaço. Antes, o ProxMenux <strong>confirma que as definições regionais do host foram geradas</strong>: lê <code>/etc/default/locale</code> ou <code>/etc/environment</code>, acrescenta a <code>/etc/locale.gen</code> se faltar e executa <code>locale-gen</code>. Assim mantém as definições regionais da shell.",
"writtenTitle": "O que é escrito",
"revertTitle": "Reversível do menu Desinstalar",
"revertBody": "Excluindo <code>/etc/apt/apt.conf.d/99-disable-translations</code> (quer manualmente ou a partir do menu Desinstalar) restaura o comportamento padrão e APT baixa arquivos de idioma novamente."
},
"utilities": {
"heading": "Instale utilitários comuns do sistema",
"intro": "Abre uma lista de <strong>25 utilitários selecionados</strong> por grupos. Escolha e confirme; o ProxMenux instala-os pelo <code>apt</code>, verifica o resultado e mostra um resumo final.",
"imageAlt": "Seletor de utilitários ProxMenux: Espaço para selecionar, Enter para confirmar",
"reuseTitle": "A mesma lista é reutilizada em outro lugar",
"reuseBody": "O catálogo dos 25 utilitários tem uma única definição: <code>PROXMENUX_UTILS</code> em <code>scripts/global/utils-install-functions.sh</code>. O menu <em>Utilitários e ferramentas → Utilitários do sistema</em> oferece a mesma lista para instalar mais tarde sem repetir a pós-instalação.",
"listTitle": "O que está na lista",
"groups": [
{
"group": "Monitores de sistemas",
"items": [
{
"pkg": "htop",
"desc": "Visualizador interativo de processos"
},
{
"pkg": "btop",
"desc": "Monitor moderno de recursos (CPU, RAM, discos, rede, processos)"
},
{
"pkg": "s-tui",
"desc": "Interface de terminal para testes de esforço e monitorização da CPU"
},
{
"pkg": "iftop",
"desc": "Utilização de largura de banda ao vivo por ligação"
},
{
"pkg": "iotop",
"desc": "I/O do disco por processo"
},
{
"pkg": "iptraf-ng",
"desc": "Monitor Interativo IP LAN"
}
]
},
{
"group": "Rede",
"items": [
{
"pkg": "iperf3",
"desc": "Medir largura de banda máxima alcançável entre máquinas"
},
{
"pkg": "net-tools",
"desc": "Ferramentas antigas (ifconfig, netstat, route). Ainda úteis para verificações rápidas"
},
{
"pkg": "ipset",
"desc": "Gerencie grandes conjuntos de IP no kernel — úteis com regras iptables/nftables."
}
]
},
{
"group": "Transferências e arquivos",
"items": [
{
"pkg": "axel",
"desc": "Acelerador de transferência paralelo leve"
},
{
"pkg": "aria2",
"desc": "Downloader multi-fonte / multi-protocolo (HTTP, FTP, BitTorrent, Metalink)"
},
{
"pkg": "unzip",
"desc": "Extrair arquivos ZIP"
},
{
"pkg": "zip",
"desc": "Criar arquivos ZIP"
},
{
"pkg": "cabextract",
"desc": "Extrair arquivos Microsoft CAB (útil com ISOs do Windows)"
},
{
"pkg": "wimtools",
"desc": "Manipular imagens WIM do Windows (extrair, dividir, montar, aplicar)"
},
{
"pkg": "genisoimage",
"desc": "Compila imagens ISO 9660 de uma árvore de diretórios"
}
]
},
{
"group": "Texto e ficheiros",
"items": [
{
"pkg": "dos2unix",
"desc": "Converter final de linha CRLF (Windows) para LF (Unix)"
},
{
"pkg": "grc",
"desc": "Colorização genérica: aplica realce de sintaxe às saídas de ping, traceroute, dig, tail e outros comandos"
},
{
"pkg": "plocate",
"desc": "Pesquisa rápida de arquivos (indexado). Executar `updatedb` após instalar para construir o índice."
}
]
},
{
"group": "Remoto e sessões",
"items": [
{
"pkg": "sshpass",
"desc": "Autenticação de senha SSH não interativa — útil para scripts, não para uso diário"
},
{
"pkg": "tmux",
"desc": "Multiplexador de terminal — desacoplar sessões, dividir painéis, sobreviver a desconexão"
}
]
},
{
"group": "Hardware e baixo nível",
"items": [
{
"pkg": "msr-tools",
"desc": "Ler/escrever registos específicos do modelo de CPU (rdmsr, wrmsr)"
},
{
"pkg": "intel-gpu-tools",
"desc": "Utilitários de diagnóstico Intel GPU incluindo `intel_gpu_top`"
}
]
},
{
"group": "Virtualização",
"items": [
{
"pkg": "libguestfs-tools",
"desc": "Inspecionar e modificar imagens de disco VM (virt-ls, virt-cat, guestmount...)"
},
{
"pkg": "chntpw",
"desc": "Editar Windows SAM — útil para recuperação de senha em Windows VMs você herda"
}
]
}
],
"actionTitle": "Alguns deles em acção",
"noBulkTitle": "Apenas os utilitários instalados pelo ProxMenux são removidos",
"noBulkBody": "ProxMenux registra apenas os pacotes utilitários selecionados que ainda não estavam instalados antes desta ação. Desinstalar Otimizações pode purgar esses pacotes mais tarde, enquanto utilitários que já estavam presentes no host são deixados intocados. A atualização geral do sistema APT não é intencionalmente rastreada como reversível porque os pacotes atualizados não têm retorno atômico seguro."
},
"related": {
"heading": "Relacionado",
"items": [
{
"label": "Atualização do sistema Proxmox",
"href": "/docs/utils/system-update",
"tail": " — reexecuta o ciclo apt update + dist-upgrade a pedido."
},
{
"label": "Instalador de utilitários de sistema",
"href": "/docs/utils/system-utils",
"tail": " — instalar (ou reinstalar) utilitários individualmente após a pós-instalação."
},
{
"label": "Comandos de atualizações e pacotes",
"href": "/docs/help-info/update-commands",
"tail": " — Referência apt para a shell."
},
{
"label": "Pós-instalação personalizável",
"href": "/docs/post-install/customizable",
"tail": " — voltar ao menu superior."
}
]
}
}
web/messages/pt/docs/post-install/customizable.json
+106
View File
@@ -0,0 +1,106 @@
{
"meta": {
"title": "Script pós-instalação personalizável | Documentação ProxMenux",
"description": "Escolha exatamente que otimizações aplicar a um host Proxmox VE com ProxMenux. 10 categorias, cerca de 35 ferramentas e uma interface com caixas de seleção. Inclui tudo do script Automatizado, mais opções de ativação explícita (IOMMU, Fastfetch, Figurine, Ceph, HA, correções AMD…).",
"ogTitle": "Script pós-instalação personalizável | Documentação ProxMenux",
"ogDescription": "10 categorias, cerca de 35 otimizações individuais. Escolha exatamente o que pretende num host Proxmox VE. As alterações reversíveis são registadas."
},
"header": {
"title": "Script pós-instalação personalizável",
"description": "Escolha exatamente que otimizações aplicar a um host Proxmox VE. O ProxMenux agrupa cerca de 35 ferramentas em 10 categorias numa única janela com caixas de seleção. O mesmo motor de Automatizado, com controlo total sobre o que é aplicado.",
"section": "Pós-instalação · Personalizável"
},
"intro": {
"title": "Quando escolher Personalizável",
"body": "Escolha esta opção se já souber os ajustes que quer ou não quer no host. Uma lista com caixas agrupadas por categoria permite selecionar, desmarcar e combinar otimizações. Pode voltar a aplicá-las mais tarde; as alterações reversíveis são registadas para <link>Desinstalar otimizações</link>. As atualizações de pacotes não são apresentadas como reversíveis."
},
"compare": {
"heading": "Comparação com Automatizado",
"body": "Personalizável inclui todo o <link>script Automatizado</link>: as mesmas 14 otimizações de base e várias opções deliberadamente omitidas por Automatizado, úteis em hardware específico (correções AMD), alojamento específico (OVH RTM) ou cargas particulares (IOMMU/VFIO, repositório Ceph, alta disponibilidade, Fastfetch, Figurine, ajuste do ARC ZFS, pigz, instantâneos ZFS automáticos, limites de velocidade vzdump, Open vSwitch, TCP BBR…)."
},
"categoriesSection": {
"heading": "As 10 categorias",
"body": "O script Personalizável agrupa as otimizações em 10 categorias numa única janela com caixas de seleção. Cada categoria tem a sua página de documentação: abra um cartão para consultar a justificação, os valores predefinidos e as verificações de cada opção."
},
"categories": [
{
"name": "Configurações básicas",
"description": "Limpa as fontes APT, executa a atualização oficial Proxmox e define o fuso horário, as definições regionais e utilitários comuns. A base de todas as outras categorias."
},
{
"name": "Sistema",
"description": "Ajusta os registos e os limites do kernel para um host com muitas VMs e contentores. Abrange journald, logrotate, sysctl (memória, limites de ficheiros), comportamento em caso de kernel panic e reinícios rápidos."
},
{
"name": "Virtualização",
"description": "Prepara o host para virtualização avançada. Instala o agente convidado adequado quando o próprio Proxmox corre numa VM suportada e ativa IOMMU/VFIO para passthrough PCI de GPUs, controladores e TPUs."
},
{
"name": "Rede",
"description": "Proteja e ajuste a pilha de rede do host. Força o APT sobre IPv4, aplica proteção sysctl + TCP ajuste de buffer, oferece Open vSwitch, TCP BBR + TCP Fast Open e fixa nomes de interface persistentes por MAC."
},
{
"name": "Armazenamento",
"description": "Configure os subsistemas comuns de armazenamento do Proxmox: ZFS Dimensionamento do ARC, ZFS auto-snapshot, ZFS Autotrim para SSD/NVMe pools, e vzdump limites de velocidade para evitar saturar o disco durante backups."
},
{
"name": "Segurança",
"description": "Reduz a superfície de ataque exposta por predefinição. Desativa os serviços RPC portmapper/rpcbind de que o Proxmox não precisa mas que deixa à escuta."
},
{
"name": "Personalização",
"description": "Altera a aparência e a experiência da shell do host: cores e aliases no bashrc, faixa MOTD e remoção do aviso de subscrição na interface web."
},
{
"name": "Monitoramento",
"description": "Integra o host com OVH Real-Time Monitoring. Só instala RTM se o ProxMenux detetar um servidor OVH; nos outros hosts não faz alterações."
},
{
"name": "Desempenho",
"description": "Acelerar as operações de compressão (backups, transferências) substituindo o gzip por seu equivalente paralelo pigz."
},
{
"name": "Opcional",
"description": "Opções especializadas de que nem todos os hosts precisam: correções CPU AMD, faixa Fastfetch, nome 3D com Figurine, atualização do índice PVE Appliance Manager, repositório Ceph, serviços de alta disponibilidade, Log2RAM para reduzir o desgaste dos SSD e perfil swap ZRAM."
}
],
"mixTip": {
"title": "Misturar automatizado e personalizável",
"body": "Um uso comum: execute primeiro <strong>Automatizado</strong> para estabelecer uma base sensata, abra depois <strong>Personalizável</strong> e escolha apenas as opções úteis, como IOMMU para passthrough de GPU. As alterações são registadas separadamente; Desinstalar mostra tudo o que foi aplicado, independentemente da opção usada."
},
"related": {
"heading": "Relacionado",
"items": [
{
"label": "Pós-instalação automatizada",
"href": "/docs/post-install/automated",
"tail": " — valores predefinidos sensatos aplicados sem perguntas."
},
{
"label": "Desinstalar otimizações",
"href": "/docs/post-install/uninstall",
"tail": " — reverter de forma limpa as opções selecionadas."
},
{
"label": "Configurações básicas",
"href": "/docs/post-install/basic-settings",
"tail": " — repositórios, hora, idioma e utilitários."
},
{
"label": "Virtualização",
"href": "/docs/post-install/virtualization",
"tail": " — IOMMU + VFIO para passagem."
},
{
"label": "Segurança",
"href": "/docs/post-install/security",
"tailRich": " · <storageLink>Armazenamento</storageLink> · <networkLink>Rede</networkLink> · <customLink>Personalização</customLink> — outras categorias."
},
{
"label": "Visão geral pós-instalação",
"href": "/docs/post-install",
"tail": "."
}
]
}
}
web/messages/pt/docs/post-install/customization.json
+74
View File
@@ -0,0 +1,74 @@
{
"meta": {
"title": "Pós-instalação: Personalização | Documentação ProxMenux",
"description": "Opções de personalização no script pós-instalação personalizável do ProxMenux: prompt bash colorido com aliases úteis, faixa ProxMenux no MOTD e remoção do aviso de subscrição da interface web Proxmox."
},
"header": {
"title": "Após a instalação: personalização",
"description": "Ajustes visuais e de utilização do host Proxmox. Melhoram a shell e ocultam o aviso de subscrição na interface web. Bashrc, MOTD e a faixa de subscrição são registados e reversíveis pelo menu Desinstalar.",
"section": "Configurações pós-instalação do Proxmox"
},
"intro": {
"title": "O que esta categoria abrange",
"body": "Três opções pequenas e independentes: um <strong>prompt bash colorido com aliases</strong> para a shell root, uma <strong>faixa MOTD</strong> de uma linha no acesso SSH e remoção da <strong>janela «Sem subscrição válida»</strong> apresentada a cada acesso à interface web Proxmox."
},
"bashrc": {
"heading": "Personalizar bashrc",
"intro": "Insere em <code>/root/.bashrc</code> um bloco com prompt colorido, histórico com data e hora, aliases comuns de <code>ls</code> / <code>grep</code> e um <code>source</code> para o preenchimento automático bash. Torna o trabalho por SSH mais agradável e identifica claramente o host quando tem muitos separadores abertos.",
"writesTitle": "O que o ProxMenux adiciona ao .bashrc",
"writesOutro": "O bloco é delimitado pelos marcadores <code>PMX_CORE_BASHRC</code>. Voltar a executar o script substitui o bloco anterior sem o duplicar. O <code>.bashrc</code> original é guardado uma vez em <code>/root/.bashrc.bak</code> e acrescenta-se a linha <code>source /root/.bashrc</code> a <code>/root/.bash_profile</code> para aplicar o prompt também nas shells de login, por exemplo após <code>su -</code>.",
"rootTitle": "Aplica-se apenas ao root",
"rootBody": "A personalização visa o shell da conta root. Outros usuários que você cria no host mantêm seus próprios padrões. Se você administrar o Proxmox exclusivamente na interface web e nunca usar o shell, esta opção é estética pura e você pode pular."
},
"motd": {
"heading": "configurar banner MOTD personalizado",
"intro": "Acrescenta <em>\"This system is optimised by: ProxMenux\"</em> ao início de <code>/etc/motd</code>, a mensagem após um acesso SSH bem-sucedido, acima do prompt e antes dos scripts <code>update-motd</code>. Inofensivo e apenas informativo: confirma visualmente que o ProxMenux foi aplicado no host.",
"writesTitle": "O que o ProxMenux escreve",
"writesOutro": "Em primeiro lugar, ProxMenux registra se <code>/etc/motd</code> existia e armazena seu conteúdo original sob <code>/usr/local/share/proxmenux</code>. A operação é idempotente: se a linha do marcador já está presente, nada é adicionado. Instalações antigas com <code>/etc/motd.bak</code> existentes são migradas para o mesmo estado reversível."
},
"banner": {
"heading": "Remover banner de assinatura",
"intro": "Remove o <em>\"Você não tem uma assinatura válida para este servidor\"</em> modal que aparece toda vez que alguém entra na interface web do Proxmox sem uma assinatura corporativa. O patch tem conhecimento de versão: diferentes versões principais do Proxmox têm diferentes pacotes de UI, então o ProxMenux envia para o script certo.",
"versionTitle": "Escolha do script conforme a versão",
"versionItems": [
"<strong>PVE 9.x</strong> → executa <code>remove-banner-pve-v3.sh</code>, que altera <code>proxmoxlib.js</code> para desktop e a nova interface móvel baseada em Yew.",
"<strong>PVE 8.x</strong> → executa <code>remove-banner-pve8.sh</code> (somente desktop)."
],
"versionOutro": "Antes do patch, o ProxMenux faz backup dos arquivos originais JS/template para <code>/usr/local/share/proxmenux/backups/</code> com um timestamp. O fluxo de desinstalação usa esses backups para restaurar os arquivos originais, e cai de volta para reinstalar os pacotes de UI Proxmox se o backup estiver faltando ou corrompido.",
"breakTitle": "Pode quebrar após as atualizações do Proxmox",
"breakBody": "As atualizações da interface Proxmox substituem regularmente <code>proxmoxlib.js</code> e podem fazer regressar o aviso. Pode voltar a aplicar a opção para alterar o ficheiro ou aceitar o aviso até lá. O ProxMenux também instala um hook APT que reaplica a alteração após atualizações de pacotes; consulte <link>Desinstalar otimizações</link> para o remover.",
"legalTitle": "Nota legal (sempre vale a pena repetir)",
"legalBody": "Esta opção só oculta o aviso da interface. <strong>Não</strong> dá suporte Enterprise nem acesso ao repositório Enterprise e não altera a licença do software. O Proxmox VE é distribuído sob GNU AGPLv3. Uma subscrição apoia o projeto e dá acesso ao canal de atualizações Enterprise; escolha o suporte adequado ao seu ambiente."
},
"verify": {
"heading": "Verificação",
"intro": "Após a aplicação dos três:",
"reversibleTitle": "Todas as três alterações de personalização são monitoradas",
"reversibleBody": "<link>Desinstalar otimizações</link> repõe <code>/root/.bashrc</code>, devolve ao MOTD o conteúdo exato anterior ao ProxMenux ou remove o ficheiro se antes não existia e restaura os ficheiros de interface alterados a partir das cópias ou reinstala os pacotes necessários."
},
"related": {
"heading": "Relacionado",
"items": [
{
"label": "Opcional",
"href": "/docs/post-install/optional",
"tail": " — Fastfetch e Figurine (outras personalizações visuais)."
},
{
"label": "Mostrar informações da versão",
"href": "/docs/settings/show-version-information",
"tail": " — confirma que as personalizações são seguidas como instaladas."
},
{
"label": "Desinstalar otimizações",
"href": "/docs/post-install/uninstall",
"tail": " — reverter bashrc, motd e o aviso de subscrição."
},
{
"label": "Pós-instalação personalizável",
"href": "/docs/post-install/customizable",
"tail": " — voltar ao menu superior."
}
]
}
}
web/messages/pt/docs/post-install/index.json
+106
View File
@@ -0,0 +1,106 @@
{
"meta": {
"title": "Script pós-instalação Proxmox VE — Automatizado e personalizável | ProxMenux",
"description": "Visão geral dos scripts pós-instalação ProxMenux para Proxmox VE. Automatizado aplica valores predefinidos sensatos sem perguntas; Personalizável permite escolher exatamente o que pretende em 10 categorias; Desinstalar otimizações repõe as alterações reversíveis suportadas.",
"ogTitle": "Script pós-instalação Proxmox VE — Automatizado e personalizável",
"ogDescription": "Aplique otimizações comuns após a instalação do Proxmox VE em 10 categorias, automaticamente ou à escolha, com opções reversíveis.",
"twitterTitle": "Script pós-instalação Proxmox VE | ProxMenux",
"twitterDescription": "Otimizações pós-instalação automatizadas e personalizáveis para Proxmox VE — com opções reversíveis."
},
"header": {
"title": "Scripts pós-instalação",
"description": "Configure um host Proxmox VE recém-instalado com as otimizações pós-instalação do ProxMenux. Aplique automaticamente a configuração de base, escolha opções individuais, atualize funções instaladas ou reponha as alterações reversíveis suportadas. As atualizações de pacotes não são apresentadas como reversíveis.",
"section": "Configurações pós-instalação do Proxmox"
},
"intro": {
"title": "Para que serve este menu",
"body": "Após instalar o Proxmox VE, dezenas de pequenas alterações tornam o host mais rápido e fácil de manter: repositórios sem subscrição, limites sensatos para journald, buffers TCP adequados, armazenamento de registos que protege os SSD, melhorias no bashrc e mais. O ProxMenux automatiza-as e acompanha as alterações de configuração reversíveis suportadas."
},
"openingMenu": {
"heading": "Abrir o menu",
"body": "No menu principal do ProxMenux, selecione <strong>Configurações pós-instalação Proxmox</strong>. Você verá isto:",
"imageAlt": "Menu de Scripts pós-instalação — Automatizado, Personalizável, o condicional Aplicar Atualizações Disponíveis (somente quando as atualizações estão pendentes) e Desinstalar, seguido da seção de scripts comunitários"
},
"threeWays": {
"heading": "Quatro maneiras de aplicar otimizações",
"body": "As quatro entradas ProxMenux compartilham o mesmo código subjacente e o mesmo registro de ferramentas instaladas — elas apenas lhe dão diferentes níveis de controle. A entrada <em>Aplicar atualizações disponíveis</em> só mostra quando pelo menos uma otimização instalada tem uma versão mais recente no disco do que o registrado; em um host recém-aplicado ele permanece oculto."
},
"routes": [
{
"title": "Automatizado",
"description": "Um conjunto curado de 14 otimizações seguras e sempre úteis aplicadas em sequência com zero prompts. Bom padrão para a maioria dos usuários.",
"bullets": [
"Repositórios sem subscrição + atualização do sistema",
"Memória, kernel, ajuste de rede",
"Log2RAM (detectado automaticamente em SSD/NVMe)",
"Limites de tamanho para journald + logrotate",
"Nomes de interface persistentes"
]
},
{
"title": "Personalizável",
"description": "Cerca de 35 otimizações individuais em 10 categorias. Escolhe exatamente quais aplicar. O mesmo motor de Automatizado, com controlo total.",
"bullets": [
"Interface com caixas de seleção por categoria",
"Inclui tudo o que Automatizado faz, mais opções de ativação explícita (IOMMU, Fastfetch, Figurine, Ceph, HA, correções AMD…)",
"Executar quantas vezes quiser — as alterações são idempotentes"
]
},
{
"title": "Aplicar atualizações disponíveis",
"description": "Quando uma otimização pós-instalação (Log2Ram, definições de memória, Logrotate…) tem uma versão no disco mais recente do que a registada no host, esta entrada mostra apenas as que mudaram. Volta a executar a função correspondente e atualiza o registo, sem tocar em mais nada.",
"bullets": [
"Aceitação por otimização, apenas as que mudaram",
"O mesmo seletor disponível no painel do Monitor",
"Uma única notificação agrupada quando chegam novas atualizações"
]
},
{
"title": "Desinstalar otimizações",
"description": "Alterações reversíveis suportadas são monitoradas em um registro JSON e emparelhadas com uma função de restauração. Ações sem um retorno seguro, como uma atualização completa do pacote, são intencionalmente excluídas.",
"bullets": [
"Detecta otimizações aplicadas anteriormente automaticamente",
"Escolhe a reversão adequada a cada item: repõe a cópia .bak, se existir, elimina o fragmento de configuração sysctl.d se nada precisava de cópia ou reinstala o pacote original com --force-confnew (por exemplo para o aviso de subscrição)",
"Pedido de reinício se necessário (VFIO, nomes persistentes, etc.)"
]
}
],
"whichTitle": "Qual deve escolher?",
"whichBody": "Para uma instalação nova do Proxmox com uma base sensata sem decisões: <autoLink><strong>Automatizado</strong></autoLink>. Se já souber os ajustes que quer ou não quer: <customLink><strong>Personalizável</strong></customLink>. Para atualizar apenas uma otimização já aplicada com versão mais recente no disco: <updatesLink><strong>Aplicar atualizações disponíveis</strong></updatesLink>. Para anular alterações anteriores de forma limpa: <uninstallLink><strong>Desinstalar otimizações</strong></uninstallLink>. Pode combiná-los: comece por Automatizado, adicione opções como Fastfetch ou IOMMU com Personalizável e reverta itens individuais mais tarde.",
"mixing": {
"heading": "Combinar com outros scripts pós-instalação",
"stackTitle": "Não empilhar vários scripts pós-instalação",
"stackBody": "Executar vários scripts pós-instalação no mesmo host pode causar arquivos de configuração duplicados, entradas de sysctl conflitantes, ou pior — rede quebrada após reinicialização. Se você já aplicou o <strong>Helper-Scripts Post Install</strong>, algumas otimizações ProxMenux podem se sobrepor ao que ele já configurou. Atenha-se a uma ferramenta pós-instalação por máquina.",
"xshokTitle": "xshok-proxmox: desactualizado",
"xshokBody": "As versões anteriores do ProxMenux indicavam <a>xshok-proxmox</a> como ferramenta pós-instalação complementar. O projeto está obsoleto e já não é oferecido no ProxMenux. Se uma execução antiga tiver deixado marcadores no host, o ProxMenux continua a detetá-los e avisa. Hoje não é uma ferramenta que deva instalar em conjunto com o ProxMenux."
},
"community": {
"heading": "Scripts da comunidade",
"body": "O menu também oferece dois scripts de terceiros do projeto <a>community-scripts</a>: <em>Proxmox VE Post Install</em> e <em>Proxmox VE Microcode</em>. São invólucros que transferem e executam os scripts originais através de <code>wget | bash</code>. Não são mantidos pelo ProxMenux. Consulte <link>Repositórios externos</link> para detalhes e questões de confiança antes de os executar."
},
"related": {
"heading": "Relacionado",
"items": [
{
"label": "Atualização do sistema Proxmox",
"href": "/docs/utils/system-update",
"tail": " — mantém o host atualizado depois de instalado."
},
{
"label": "Segurança",
"href": "/docs/security",
"tail": " — Fail2Ban + Lynis além do reforço de segurança pós-instalação."
},
{
"label": "Mostrar informações da versão",
"href": "/docs/settings/show-version-information",
"tail": " — ver que componentes pós-instalação são rastreados como instalados."
},
{
"label": "Comandos de atualizações e pacotes",
"href": "/docs/help-info/update-commands",
"tail": " — referência para o apt/pveupgrade."
}
]
}
}
web/messages/pt/docs/post-install/monitoring.json
+56
View File
@@ -0,0 +1,56 @@
{
"meta": {
"title": "Pós-instalação: Monitorização | Documentação ProxMenux",
"description": "Opções de monitoramento no script de pós-instalação personalizável ProxMenux. Atualmente uma única opção: instalar OVH Real-Time Monitoring (RTM), que só se ativa se o host for detectado como um servidor OVH."
},
"header": {
"title": "Após a instalação: monitorização",
"description": "Opções de monitoramento dentro do script pós-instalação personalizável. Esta categoria é pequena e específica do provedor — instala o agente OVH Real-Time Monitoring em servidores OVH dedicados e não faz nada em nenhum outro lugar.",
"section": "Configurações pós-instalação do Proxmox"
},
"intro": {
"title": "Âmbito intencionalmente limitado",
"body": "A monitorização pós-instalação limita-se a <strong>um agente específico de um fornecedor</strong>. Ferramentas gerais (Prometheus, Grafana, node_exporter) ficam fora deste âmbito, pois exigem decisões de arquitetura — host separado, retenção de dados e destinos de alertas — que não cabem num passo com um clique. O ProxMenux Monitor, incluído no ProxMenux, cobre grande parte dessa função sem agentes externos."
},
"ovh": {
"heading": "Instalar o Monitoramento em Tempo Real OVH (RTM)",
"intro": "Se o host Proxmox for um servidor dedicado alugado à <a>OVHcloud</a>, pode ativar o RTM para apresentar telemetria de hardware (temperatura da CPU, estado da fonte de alimentação, SMART dos discos, estado do controlador RAID, etc.) no painel de controlo OVH. É o mesmo agente usado pela OVH na função «Server Monitoring».",
"decisionsTitle": "Como ProxMenux decide",
"decisionsItems": [
"Obtém o IP público do host via <code>curl ipinfo.io/ip</code>.",
"Procura o ISP proprietário com uma consulta <code>whois</code> para <code>v4.whois.cymru.com</code>.",
"Se o resultado mencionar OVH, transfere <code>last-public-ovh-infra-yak.snap.mirrors.ovh.net/yak/archives/apply.sh</code> e passa-o para <code>bash</code> com o manifesto Puppet do RTM v2.",
"Se o resultado <em>não</em> mencionar OVH, nada é instalado. A opção não faz alterações."
],
"remoteTitle": "Script remoto passado para bash através de um pipe",
"remoteBody": "A instalação executa <code>wget -qO - https://…apply.sh | bash</code>. Se o espelho OVH for comprometido, o script corre como root no host. Antes de ativar a opção, pondere a confiança na cadeia de espelhos OVH face ao benefício da monitorização. Para a maioria dos utilizadores domésticos ou fora da OVH, a opção deve ficar desativada.",
"noOpTitle": "Só activar se a máquina estiver em OVH",
"noOpBody": "A opção não altera servidores fora da OVH, pelo que selecioná-la num Proxmox doméstico não causa problemas. Num host não OVH, o script mostra <em>«Não é um servidor OVH, a instalação RTM será ignorada»</em> e termina sem instalar pacotes.",
"runsTitle": "O que o ProxMenux executa",
"verifyTitle": "Verificação",
"verifyBody": "Em um host OVH real, após uma reinicialização você deve ver o painel <a>RTM</a> em seu OVH Manager povoado com dados ao vivo para o host. No lado Proxmox, o coletor RTM é um serviço systemd — verifique-o diretamente:",
"troubleTitle": "Resolução de Problemas",
"revertTitle": "Remover RTM pelo menu Desinstalar",
"revertBody": "Quando RTM está registado como instalado, Desinstalar otimizações oferece uma entrada OVH Real-Time Monitoring. Executa <code>apt-get purge -y ''ovh-rtm*'' ''rtm'' ''rtm-*''</code>, remove /etc/rtm e marca RTM como desinstalado. Os artefactos Puppet podem precisar de limpeza manual; reveja os manifestos específicos do RTM em <code>/etc/puppet/</code>. Num host fora da OVH não foram instalados pacotes RTM, pelo que nada há a remover."
},
"related": {
"heading": "Relacionado",
"items": [
{
"label": "ProxMenux Monitor",
"href": "/docs/settings/proxmenux-monitor",
"tail": " — painel web local para o host (funciona em qualquer fornecedor, não apenas OVH)."
},
{
"label": "Comandos úteis do sistema",
"href": "/docs/help-info/system-commands",
"tail": " — referência de monitorização do host local."
},
{
"label": "Pós-instalação personalizável",
"href": "/docs/post-install/customizable",
"tail": " — voltar ao menu superior."
}
]
}
}
web/messages/pt/docs/post-install/network.json
+128
View File
@@ -0,0 +1,128 @@
{
"meta": {
"title": "Pós-instalação: Rede | Documentação ProxMenux",
"description": "Opções de rede do script de pós-instalação personalizável ProxMenux: forçar APT por IPv4, aplicar um perfil sysctl selecionado, instalar Open vSwitch, ativar TCP BBR + Fast Open e associar os nomes das interfaces aos seus endereços MAC."
},
"header": {
"title": "Pós-instalação: Rede",
"section": "Configurações pós-instalação do Proxmox"
},
"intro": {
"title": "O que esta categoria abrange",
"body": "Cinco opções de rede independentes. Duas são simples (<strong>APT por IPv4</strong>, <strong>instalação do Open vSwitch</strong>), duas ajustam o comportamento TCP (<strong>perfil sysctl de rede</strong>, <strong>BBR + Fast Open</strong>) e uma resolve um problema comum: <strong>fixar os nomes das interfaces</strong> para que uma nova placa de rede ou atualização do BIOS não mude <code>enp3s0</code> para <code>enp4s0</code> e interrompa as pontes."
},
"ipv4": {
"heading": "Forçar o APT a usar IPv4",
"intro": "Escreve <code>Acquire::ForceIPv4 \"true\";</code> para <code>/etc/apt/apt.conf.d/99-force-ipv4</code>. APT então se recusa a usar IPv6 para downloads de pacotes, mesmo que o host tenha conectividade IPv6.",
"tipTitle": "Quem beneficia",
"tipBody": "Útil se a ligação IPv6 for instável, mais lenta que IPv4 ou se o espelho Debian/Proxmox falhar ocasionalmente por IPv6. Não causa problemas em hosts sem IPv6. Numa rede de pilha dupla funcional, torna o comportamento previsível: apt não o surpreende com um tempo limite de IPv6."
},
"sysctl": {
"heading": "Aplicar otimizações de rede",
"intro": "Escreve um perfil sysctl selecionado em <code>/etc/sysctl.d/99-network.conf</code>: buffers de sockets do kernel, reforço do ICMP, proteção básica contra falsificação de endereços e tamanhos de buffers TCP adequados a um hipervisor com muitos fluxos simultâneos.",
"tunedTitle": "O que é ajustado",
"headerArea": "Área",
"headerSettings": "Principais definições",
"rows": [
{
"area": "Buffers de sockets do kernel",
"settings": "<code>netdev_max_backlog=8192</code>, <code>rmem_max=16M</code>, <code>wmem_max=16M</code>, <code>somaxconn=8192</code>"
},
{
"area": "Endurecimento do ICMP",
"settings": "<code>icmp_echo_ignore_broadcasts=1</code>, <code>icmp_ignore_bogus_error_responses=1</code>"
},
{
"area": "Segurança de roteamento",
"settings": "<code>accept_redirects=0</code>, <code>accept_source_route=0</code>, <code>secure_redirects=0</code>, <code>send_redirects=0</code>, <code>log_martians=0</code>"
},
{
"area": "Filtro de caminho inverso",
"settings": "<code>rp_filter=2</code> (modo solto, ver nota abaixo)"
},
{
"area": "TCP",
"settings": "<code>tcp_mtu_probing=1</code>, <code>tcp_rfc1337=1</code>, <code>tcp_sack=1</code>, <code>tcp_rmem=8K/87K/16M</code>, <code>tcp_wmem=8K/64K/16M</code>"
},
{
"area": "Portas",
"settings": "<code>ip_local_port_range=1024 65535</code> (conjunto de portas efémeras)"
},
{
"area": "Soquetes Unix",
"settings": "<code>net.unix.max_dgram_qlen=4096</code>"
}
],
"sourceOutro": "Ele também adiciona <code>source /etc/network/interfaces.d/*</code> ao <code>/etc/network/interfaces</code> se ainda não estiver presente — prática padrão para que você possa soltar trechos de interface modular sem editar o arquivo principal.",
"fwbrTitle": "Ajuste automático de pontes de firewall virtuais",
"fwbrBody": "Além do perfil sysctl, o ProxMenux instala o script auxiliar <code>/usr/local/sbin/proxmenux-fwbr-tune</code>, que aplica <code>rp_filter=0</code> e <code>log_martians=0</code> às interfaces <code>fwbr*</code> / <code>fwln*</code> / <code>fwpr*</code> / <code>tap*</code> criadas pelo Proxmox para VMs e contentores. A unidade de execução única <code>proxmenux-fwbr-tune.service</code> chama-o no arranque, e a regra <code>/etc/udev/rules.d/99-zz-proxmenux-fwbr-tune.rules</code> a cada evento <code>net add</code> com esses prefixos. Abrange assim interfaces recriadas ao iniciar/parar VMs, reiniciar e migrar em funcionamento. O script também processa as interfaces já presentes imediatamente após a instalação.",
"rpFilterTitle": "Porquê rp_filter=2 (permissivo) em vez de 1 (estrito)",
"rpFilterBody": "A filtragem estrita do caminho inverso descarta pacotes cuja origem seria alcançada por uma interface <em>diferente</em>. É uma predefinição adequada a clientes, mas problemática num host Proxmox onde o tráfego das VMs chega frequentemente por uma ponte e sai por um uplink com rotas assimétricas. <code>rp_filter=2</code> (permissivo) só descarta pacotes com origens realmente inalcançáveis pelo encaminhamento. É um compromisso: reduz ligeiramente a deteção de falsificação de IP local para preservar a rede das VMs."
},
"ovs": {
"heading": "Instalar Open vSwitch",
"intro": "Instala <code>openvswitch-switch</code> + <code>openvswitch-common</code>. Os pacotes acrescentam OVS como alternativa às pontes Linux predefinidas do Proxmox. A instalação por si só não altera a rede: as pontes <code>vmbrX</code> existentes continuam a funcionar. Ao <em>criar</em> uma nova ponte na interface Proxmox, pode escolher OVS na lista de tipos.",
"tipTitle": "Quando a OVS faz sentido",
"tipBody": "Considere OVS se precisar de <strong>trunks VLAN com IDs não contíguos</strong>, <strong>LACP com LLDP em modos específicos</strong>, <strong>programação detalhada de fluxos</strong> (OpenFlow) ou interoperabilidade com controladores SDN. Num laboratório doméstico com poucas VLANs e um único uplink LACP, pontes Linux + <code>vmbrX.VID</code> são mais simples e adequadas.",
"revertTitle": "Reversível do menu Desinstalar",
"revertBody": "OVS fica registado. <link>Desinstalar otimizações</link> executa <code>apt purge</code> em <code>openvswitch-switch</code> e <code>openvswitch-common</code>. Migre as pontes OVS para pontes Linux <em>antes</em> de desinstalar; caso contrário, as VMs nessas pontes perderão a rede no próximo arranque. Equivalente manual:"
},
"bbr": {
"heading": "Ativar TCP BBR + TCP Fast Open",
"intro": "Escreve dois ficheiros sysctl e recarrega-os. BBR substitui CUBIC pelo algoritmo de congestionamento da Google baseado em largura de banda, que lida melhor com ligações de alta capacidade e latência ou com perdas. TCP Fast Open (TFO) elimina uma ida e volta nas ligações TCP repetidas enviando dados no SYN.",
"verifyTitle": "Verificação",
"impactTitle": "O impacto depende da carga de trabalho",
"impactBody": "BBR destaca-se em ligações de alta latência ou com perdas (replicação intercontinental, túneis VPN, clientes móveis). Numa LAN entre duas máquinas no mesmo switch, a diferença costuma ficar nas variações de medição. TFO ajuda sobretudo em ligações HTTP curtas e repetidas.",
"revertTitle": "Reversível do menu Desinstalar",
"revertBody": "BBR/TFO ficam registados. <link>Desinstalar otimizações</link> remove os dois ficheiros sysctl (<code>/etc/sysctl.d/99-kernel-bbr.conf</code> e <code>99-tcp-fastopen.conf</code>) e recarrega a configuração restante. Eliminar um ficheiro não repõe os valores ativos do kernel. As predefinições como <code>cubic</code> e <code>tcp_fastopen=1</code> regressam após reiniciar, salvo se outra configuração as substituir. Equivalente manual:"
},
"names": {
"heading": "Nomes de interfaces persistentes",
"intro": "Percorre as placas de rede físicas do host, excluindo loopback, veths Docker, pontes, dispositivos TAP, bonds, Cilium, ZeroTier e WireGuard. Escreve um ficheiro systemd <code>.link</code> que associa o nome atual ao endereço MAC atual. A associação MAC passa a prevalecer sobre a lógica de nomes do kernel.",
"whyTitle": "Por que isso importa?",
"whyItems": [
"Adicionar ou remover dispositivos PCIe pode mudar a numeração do barramento, transformando <code>enp3s0</code> em <code>enp4s0</code>. Se <code>/etc/network/interfaces</code> mencionar o nome antigo, a ponte desaparece ao reiniciar.",
"As atualizações de BIOS / firmware às vezes alteram como os dispositivos enumeram, com o mesmo efeito.",
"O script fixa os nomes das placas físicas, incluindo portas físicas usadas por bonds. Ignora interfaces virtuais, como veths LXC e os próprios dispositivos bond; não corrige condições de corrida nos nomes de placas virtuais <code>hotplug</code>."
],
"writtenTitle": "O que é escrito",
"writtenIntro": "Um ficheiro por NIC físico, em <code>/etc/systemd/network/10-proxmenux-&lt;iface&gt;.link</code>. Cada arquivo começa com o cabeçalho <code># Managed by ProxMenux — do not edit</code> para que ProxMenux possa distinguir seus próprios arquivos de arquivos <code>.link</code> fornecidos pelo usuário ou pacote.",
"writtenOutro": "Os ficheiros <code>.link</code> de outros pacotes ou escritos pelo utilizador são preservados; só os que têm o cabeçalho ProxMenux são geridos. Em cada nova execução, a função verifica os seus ficheiros: relê <code>MACAddress=</code> de cada <code>10-proxmenux-*.link</code> e remove os que têm uma MAC ausente de <code>/sys/class/net/</code>. Os ficheiros de versões anteriores no formato <code>10-&lt;iface&gt;.link</code> são migrados automaticamente na primeira execução.",
"pveTitle": "PVE 9 vs PVE 8",
"pveBody": "O script usa ficheiros systemd <code>.link</code> para os nomes persistentes. No Proxmox VE 9 também recarrega as regras udev após os escrever, para que novas placas possam usá-las sem reiniciar. Verifique as interfaces existentes após reiniciar tanto no PVE 8 como no PVE 9. Isto não substitui <code>ifupdown2</code> no host. Em ambos os casos, o script assinala a necessidade de reinício na pós-instalação personalizável.",
"reviewTitle": "Reveja primeiro o /etc/network/interfaces existente",
"reviewBody": "Se a configuração antiga em <code>/etc/network/interfaces</code> usa nomes de placas gerados pelo kernel, fixar os nomes <em>atuais</em> é o resultado pretendido. Se já adaptou manualmente a configuração a nomes específicos, confirme antes de reiniciar que os nomes fixados correspondem ao ficheiro interfaces.",
"revertTitle": "Reversível do menu Desinstalar",
"revertBody": "<link>Desinstalar otimizações</link> elimina apenas os ficheiros <code>10-proxmenux-*.link</code> com cabeçalho ProxMenux de <code>/etc/systemd/network/</code>. Preserva todos os ficheiros <code>.link</code> do utilizador ou de outros pacotes. No próximo reinício regressa o comportamento de nomes predefinido do systemd."
},
"related": {
"heading": "Relacionado",
"items": [
{
"label": "Gerenciamento de rede",
"href": "/docs/network",
"tail": " — diagnóstico, análise da ponte, reparação guiada."
},
{
"label": "Nomes de interface persistentes",
"href": "/docs/network/persistent-names",
"tail": " — a mesma função num menu próprio para mais tarde; use uma das opções, não ambas."
},
{
"label": "Referência de comandos de rede",
"href": "/docs/help-info/network-commands",
"tail": " — ip, ss, ethtool, sysctl."
},
{
"label": "Desinstalar otimizações",
"href": "/docs/post-install/uninstall",
"tail": " — reverte qualquer uma destas alterações de rede."
},
{
"label": "Pós-instalação personalizável",
"href": "/docs/post-install/customizable",
"tail": " — voltar ao menu superior."
}
]
}
}
web/messages/pt/docs/post-install/optional.json
+177
View File
@@ -0,0 +1,177 @@
{
"meta": {
"title": "Pós-instalação ProxMenux: Configurações opcionais",
"description": "Guia de configurações opcionais no script pós-instalação ProxMenux para recursos e otimizações adicionais Proxmox VE.",
"ogTitle": "Pós-instalação ProxMenux: Configurações opcionais",
"ogDescription": "Guia de configurações opcionais no script pós-instalação ProxMenux para recursos e otimizações adicionais Proxmox VE.",
"ogImageAlt": "Configurações opcionais da pós-instalação ProxMenux"
},
"title": "Configurações Opcionais",
"intro": "A categoria <strong>Configurações opcionais</strong> oferece funções e otimizações adicionais para Proxmox VE. Não são essenciais, mas podem melhorar as capacidades do sistema em situações específicas.",
"available": "Funções opcionais disponíveis",
"stepLabel": "Etapa",
"ceph": {
"title": "Adicionar suporte mais recente ao Ceph",
"intro": "Esta opção instala o mais recente suporte ao sistema de armazenamento Ceph para Proxmox VE. O Ceph é um sistema de armazenamento distribuído que oferece alto desempenho, confiabilidade e escalabilidade.",
"doesIntro": "O que faz:",
"doesItems": [
"Adiciona o repositório Ceph ao seu sistema",
"Atualiza as listas de pacotes",
"Instala pacotes Ceph usando o comando 'pveceph install'",
"Verifica a instalação"
],
"howUse": "Como usar: Após a instalação, você pode configurar e gerenciar o armazenamento Ceph usando a interface web Proxmox VE ou ferramentas de linha de comando.",
"automates": "Este ajuste automatiza os seguintes comandos:"
},
"amd": {
"title": "Aplicar correções AMD CPU",
"intro": "Esta opção aplica correções específicas para CPUs AMD EPYC e Ryzen para melhorar a estabilidade e compatibilidade.",
"doesIntro": "O que faz:",
"doesItems": [
"Detecta se está presente um AMD EPYC ou Ryzen CPU",
"Aplica o parâmetro 'idle=nomwait' para evitar falhas aleatórias (via /etc/kernel/cmdline em máquinas systemd-boot, ou /etc/default/grub em máquinas GRUB — com um .bak do original)",
"Configura o KVM para ignorar certos MSRs (registos específicos do modelo) e melhorar a compatibilidade com máquinas virtuais Windows."
],
"howUse": "Como usar: Estas correções são aplicadas automaticamente e requerem uma reinicialização do sistema para fazer efeito.",
"automates": "Este ajuste automatiza os seguintes comandos:"
},
"ha": {
"title": "Habilitar serviços de alta disponibilidade",
"intro": "Esta opção permite serviços de Alta Disponibilidade (HA) em Proxmox VE, permitindo failover automático de VMs e contêineres em caso de falha de nó.",
"doesIntro": "O que faz:",
"doesItems": [
"Activa e inicia o serviço pve-ha-lrm (Local Resource Manager)",
"Activa e inicia o serviço pve-ha-crm (Cluster Resource Manager)",
"Activa e inicia o serviço corosync para comunicação de clusters"
],
"howUse": "Como usar: Depois de ativar esses serviços, você pode configurar grupos e recursos HA na interface web Proxmox VE.",
"automates": "Este ajuste automatiza os seguintes comandos:"
},
"pveam": {
"title": "Atualizar Proxmox VE Appliance Manager",
"intro": "Atualiza o índice local dos modelos de contentores apresentado pelo <code>pveam</code> no Proxmox, para que a lista de modelos de software esteja atualizada ao criar o próximo LXC.",
"doesIntro": "O que faz:",
"doesItems": [
"Executa <code>pveam update</code> nos espelhos Proxmox para obter o catálogo atual de modelos de software",
"Preenche a lista de modelos de software apresentada ao criar um contentor"
],
"howUse": "Utilização: execute se a lista de modelos na interface parecer desatualizada ou após mudar de espelho. Transfere apenas o índice do catálogo, não os próprios modelos.",
"automates": "Este ajuste automatiza o seguinte comando:"
},
"fastfetch": {
"title": "Instalar e Configurar o Fastfetch",
"intro": "Esta opção instala silenciosamente e configura Fastfetch, uma ferramenta de informação do sistema que exibe especificações do sistema e um logotipo personalizado no login.",
"doesLabel": "O que faz:",
"doesItems": [
"Silenciosamente baixa e instala a versão mais recente do Fastfetch",
"Permite-lhe escolher um logotipo personalizado (<strong>ProxMenux, Proxmox, Helper-Scripts, Home-Labs-Club, Proxmology</strong>, ou um personalizado)",
"Configura Fastfetch para exibir <em>\"Sistema otimizado por ProxMenux\"</em>",
"Configura o Fastfetch para executar automaticamente no login do console"
],
"importantLabel": "Importante:",
"importantBody": "Se você se conectar ao Proxmox via SSH, você deve selecionar o logotipo <strong>Proxmox</strong> ou criar um personalizado usando <code>jp2a</code> ou <code>img2txt</code>. Os outros logotipos são gerados usando <code>chafa</code> e podem não exibir corretamente em uma sessão padrão SSH.",
"customLabel": "Logótipos personalizados:",
"customBody1": "Para usar um logotipo personalizado, coloque seu arquivo de texto de arte ASCII em: <code>/usr/local/share/fastfetch/logos/</code>",
"customBody2": "Você pode criar logotipos personalizados usando ferramentas como <code>chafa</code>, <code>jp2a</code>, ou <code>img2txt</code>.",
"customBody3": "Para melhores resultados:",
"customItems": [
"Limite a altura do logótipo a 35 linhas para manter as proporções e caber no terminal",
"Use <code>chafa</code> para logotipos de cores (pode não exibir corretamente em sessões de SSH)",
"Use <code>jp2a</code> ou <code>img2txt</code> para logotipos compatíveis com SSH"
],
"examplesLabel": "Logotipos de Exemplo:",
"logos": [
{
"name": "ProxMenux",
"alt": "Logótipo do ProxMenux",
"src": "https://macrimi.github.io/ProxMenux/fastfetch/proxmenux.png"
},
{
"name": "Proxmox",
"alt": "Logótipo do Proxmox",
"src": "https://macrimi.github.io/ProxMenux/fastfetch/proxmox.png"
},
{
"name": "JC Channel",
"alt": "Logótipo do JC Channel",
"src": "/fastfetch/jc-channel.png"
},
{
"name": "Helper-Scripts",
"alt": "Logótipo do Helper-Scripts",
"src": "https://macrimi.github.io/ProxMenux/fastfetch/helper-scripts.png"
},
{
"name": "Home-Labs-Club",
"alt": "Logótipo do Home-Labs-Club",
"src": "https://macrimi.github.io/ProxMenux/fastfetch/home-labs-club.png"
},
{
"name": "Proxmology",
"alt": "Logótipo Proxmology",
"src": "https://macrimi.github.io/ProxMenux/fastfetch/proxmology.png"
}
],
"automates": "Este ajuste automatiza os seguintes comandos:"
},
"figurine": {
"title": "Instalar e Configurar Figurine",
"intro": "Esta opção instala e configura o Figurine, uma ferramenta que cria banners de texto elegantes ASCII para o seu terminal, exibindo o seu nome de máquina em um formato 3D visualmente atraente.",
"doesLabel": "O que faz:",
"doesItems": [
"Descarrega e instala o Figurine v2.1.1 a partir do GitHub para a arquitetura do host (AMD64, ARM64 ou ARMv7)",
"Cria uma mensagem de boas- vindas que mostra o seu nome de máquina na arte ASCII 3D quando você entra",
"Atualiza o binário existente do Figurine após concluir a transferência e a extração com sucesso",
"Configura a mensagem de boas- vindas a executar automaticamente na autenticação"
],
"practicalLabel": "Uso prático:",
"practicalBody": "Ao gerenciar vários nós Proxmox em um cluster, o Figurine fornece uma indicação visual imediata de qual nó você está conectado atualmente. Isso ajuda a prevenir comandos acidentais no nó errado e melhora seu fluxo de trabalho ao gerenciar vários servidores.",
"exampleLabel": "Resultado do Exemplo:",
"imageAlt": "Saída de Exemplo Figurine",
"automates": "Este ajuste automatiza o seguinte processo:",
"outro": "Após a instalação, você verá seu hostname exibido na arte ASCII 3D cada vez que você entrar, deixando imediatamente claro em que nó Proxmox você está trabalhando."
},
"log2ram": {
"title": "Instalar Log2RAM (redução do desgaste de SSD/NVMe)",
"intro": "Log2RAM monta <code>/var/log</code> num ramdisk tmpfs e sincroniza-o periodicamente para disco. Guardar temporariamente na RAM as escritas frequentes do journald pode reduzir desgaste SSD e E/S. A sincronização e o encerramento normal guardam os registos; um corte abrupto pode perder entradas desde a última sincronização.",
"upstreamLabel": "Projeto a montante:",
"upstreamUrl": "https://github.com/azlux/log2ram",
"upstreamLinkLabel": "azlux/log2ram em GitHub",
"doesLabel": "O que o ProxMenux faz:",
"doesItems": [
"Detecta se o disco raiz é SSD/NVMe lendo <code>/sys/block/&lt;dev&gt;/queue/rotational</code>. Em um disco rotacional o fluxo automatizado pede primeiro antes de instalar.",
"Clona o repositório original (<code>azlux/log2ram</code>) para <code>/tmp/log2ram</code> e modifica <code>install.sh</code>, substituindo <code>rsync -aAXv</code> por <code>rsync -aXv --no-acls</code>. Evita o erro <em>set_acl: Operation not supported</em> com código de saída 23, gerado pelo script original ao mover /var/log em sistemas sem ACL. A unidade systemd <code>log2ram</code> é ativada após instalação.",
"Dimensiona o ramdisk pela RAM do host: <code>≤ 8 GB → 128M</code>, <code>≤ 16 GB → 256M</code>, <code>&gt; 16 GB → 512M</code>. Escreve o valor em <code>SIZE=</code> de <code>/etc/log2ram.conf</code>.",
"Agenda uma sincronização periódica do disco via <code>/etc/cron.d/log2ram</code>: a cada 1h / 3h / 6h de acordo com o mesmo nível RAM.",
"Instala <code>/usr/local/bin/log2ram-check.sh</code>, executado a cada 10 minutos por <code>/etc/cron.d/log2ram-auto-sync</code>. Quando <code>/var/log</code> chega a 80% do ramdisk, limpa journals antigos. Aos 92%, executa primeiro <code>logrotate -f /etc/logrotate.d/proxmox-backup-api</code> se o ficheiro existir: os registos API PBS costumam ocupar mais espaço num host PBS. Depois trunca <code>pveproxy access/error</code> e <code>pveam.log</code> antes de sincronizar. <code>log2ram write</code> apenas copia tmpfs para disco, sem o reduzir. A proteção ajuda a evitar falhas PVE com <em>No space left on device</em> por crescimento descontrolado dos registos.",
"Deteta o serviço <code>proxmox-backup-server</code> no host. Se existir, cria <code>/etc/logrotate.d/proxmox-backup-api</code> (20 MB × 3 rotações) e <code>/etc/cron.hourly/proxmox-backup-logrotate</code> para limitar os registos API PBS, fonte habitual de crescimento, mesmo entre sincronizações Log2RAM. Sem PBS não altera nada.",
"Ajusta os limites systemd-journald (<code>SystemMaxUse</code>, <code>RuntimeMaxUse</code>) ao ramdisk para que uma rajada de registos não o encha.",
"Fica registado em <code>installed_tools.json</code> para poder ser revertido em Desinstalar otimizações."
],
"howUseLabel": "Como utilizar:",
"howUseBody": "O percurso automatizado instala Log2RAM sem intervenção se detetar disco raiz SSD/NVMe. O personalizável pergunta tamanho, intervalo e ativação da proteção. A pergunta indica 90%, mas o script gerado usa os limiares de limpeza de 80% e intensiva de 92% descritos acima.",
"verifyLabel": "Verificar e gerenciar a partir da shell:",
"verifyCode": "# Service state and configured timers\nsystemctl status log2ram\nsystemctl list-timers log2ram*\n\n# Current ramdisk usage — /var/log IS the tmpfs itself\ndf -h /var/log\n\n# Force a sync now (tmpfs → disk); does NOT shrink the tmpfs\nlog2ram write\n\n# Trigger the auto-sync guard on demand (vacuum + sync when usage is high)\n/usr/local/bin/log2ram-check.sh\n\n# Current config: SIZE, mail settings, path\ncat /etc/log2ram.conf\n\n# ProxMenux-specific cron jobs\ncat /etc/cron.d/log2ram /etc/cron.d/log2ram-auto-sync\n\n# Recent Log2RAM activity\njournalctl -u log2ram -n 50 --no-pager"
},
"zram": {
"title": "Habilitar perfil de troca ZRAM",
"intro": "Cria um dispositivo swap comprimido em RAM, <code>/dev/zram0</code>, com <code>systemd-zram-generator</code>. As páginas movidas pelo kernel para swap são comprimidas com zstd e mantidas em memória antes de usar swap em disco.",
"doesLabel": "O que faz:",
"doesItems": [
"Instala <code>systemd-zram-generator</code> se estiver faltando, e registra se ProxMenux o instalou.",
"Escreve <code>/etc/systemd/zram-generator.conf.d/90-proxmenux.conf</code>: um dispositivo <code>zram0</code> de um décimo da RAM do host, compressão zstd (<code>zstd(level=9)</code> com systemd-zram-generator 1.2.0 ou posterior) e prioridade swap 32767.",
"Com essa prioridade, o kernel preenche primeiro o ZRAM. Uma troca existente no disco mantém sua própria prioridade e leva as páginas que já não se encaixam no ZRAM.",
"Antes de mudar qualquer coisa, procura outra configuração ZRAM: uma troca zram ativa, uma linha zram em <code>/etc/fstab</code>, uma unidade systemd ou outro arquivo gerador. Se encontrar uma, a opção pára e deixa essa configuração como está.",
"Inicia o <code>dev-zram0.swap</code> e verifica se o dispositivo ativo corresponde ao perfil. Caso contrário, o estado anterior é restaurado.",
"Fica registado em <code>installed_tools.json</code> para poder ser revertido em Desinstalar otimizações."
],
"howUseLabel": "Como utilizar:",
"howUseBody": "A opção só existe no percurso personalizável, não no automatizado. O dispositivo é recriado em cada arranque. Enquanto estiver ativo, o painel Memória do ProxMenux Monitor mostra capacidade, swap utilizado, algoritmo, relação de compressão e memória física ocupada.",
"verifyLabel": "Verificar a partir do shell:",
"verifyCode": "# Active swap devices and their priority\nswapon --show\n\n# ZRAM device: algorithm, size and compressed data\nzramctl\n\n# Profile written by ProxMenux\ncat /etc/systemd/zram-generator.conf.d/90-proxmenux.conf\n\n# State of the swap unit\nsystemctl status dev-zram0.swap"
},
"autoApplication": {
"title": "Aplicação automática",
"body": "No percurso personalizável, selecione as funções conforme as necessidades. Log2RAM também integra o automatizado com deteção de hardware; ZRAM é exclusivo do personalizável. Consulte cada secção para confirmações e requisitos."
}
}
web/messages/pt/docs/post-install/performance.json
+61
View File
@@ -0,0 +1,61 @@
{
"meta": {
"title": "Pós-instalação: Desempenho | Documentação ProxMenux",
"description": "Opções de desempenho no script pós-instalação personalizável do ProxMenux. Substitui o gzip de uma só thread pelo pigz (gzip paralelo) para acelerar cópias de segurança e compressão em hosts com vários núcleos."
},
"header": {
"title": "Após a instalação: desempenho",
"description": "Opções de desempenho do script pós-instalação Personalizável. Esta categoria contém uma só otimização: substituir gzip por pigz para que as cópias de segurança e a compressão usem todos os núcleos da CPU em vez de um.",
"section": "Configurações pós-instalação do Proxmox"
},
"intro": {
"title": "O que esta categoria abrange",
"body": "A única opção de desempenho aqui redireciona o gzip para uma implementação paralela. Os outros ajustes de desempenho (memória, escalonamento de E/S, tamanho do ARC ZFS, limites do kernel) ficam nas respetivas categorias (<em>Sistema</em>, <em>Armazenamento</em>), pois afetam subsistemas diferentes."
},
"pigz": {
"heading": "Use pigz para compactação gzip mais rápida",
"intro": "O <code>gzip</code> normal comprime usando <strong>um só núcleo da CPU</strong>. Nos hosts Proxmox modernos com 8, 16 ou 32 núcleos, isto limita muito as cópias VM/CT com <code>vzdump</code>, a rotação de registos e tudo o que passa pelo <code>gzip</code>. O <a>pigz</a> é um substituto paralelo diretamente compatível: produz o mesmo formato gzip, mas distribui o trabalho por todos os núcleos.",
"doesTitle": "O que o ProxMenux faz",
"doesIntro": "Cinco passos, todos idempotentes:",
"doesItems": [
"Define <code>pigz: 1</code> em <code>/etc/vzdump.conf</code> para que a ferramenta de backup do Proxmox use pigz nativamente.",
"Instala o pacote apt <code>pigz</code> se ainda não estiver presente.",
"Cria um script wrapper em <code>/bin/pigzwrapper</code> que encaminha todos os argumentos para <code>/usr/bin/pigz</code>.",
"Registra um desvio de dpkg para o binário <code>gzip</code> do sistema (<code>/usr/bin/gzip</code> em Proxmox VE 9, <code>/bin/gzip</code> em Proxmox VE 8): o binário real é mantido ao lado dele como <code>gzip.distrib</code> e o invólucro toma o seu lugar. A partir de agora, <em> qualquer coisa</em> que chama <code>gzip</code> — logrotate, <code>tar czf</code>, scripts, vzdump — usa pigz de forma transparente.",
"Verifica que o arquivo mantido como <code>gzip.distrib</code> é um gzip funcional antes da embalagem ser colocada no lugar, e reinstala o pacote <code>gzip</code> primeiro quando não estiver. Uma máquina que ainda tenha o swap <code>/bin/gzip.original</code> anterior é movida para o desvio quando a opção é aplicada novamente."
],
"replacesTitle": "Substitui um binário do sistema",
"replacesBody": "Colocar um wrapper no lugar do <code>gzip</code> é invulgar. É seguro porque produz saída compatível com gzip, mas scripts com caminhos fixos, executados em chroots restritivos ou que verificam hashes dos binários podem comportar-se de forma diferente. O binário original fica em <code>gzip.distrib</code>. Graças ao desvio dpkg, uma atualização do pacote <code>gzip</code> ou a passagem do Proxmox VE 8 para 9 atualiza esse ficheiro e mantém o wrapper.",
"revertTitle": "Reversível do menu Desinstalar",
"revertBody": "Esta otimização é registada. <link>Desinstalar otimizações</link> copia o binário original de <code>gzip.distrib</code> para o lugar do wrapper, remove o desvio e <code>pigzwrapper</code>, comenta a linha <code>pigz</code> em <code>/etc/vzdump.conf</code> e executa <code>apt purge pigz</code> após confirmar que o gzip funciona. Equivalente manual no Proxmox VE 9:",
"verifyTitle": "Verificação",
"verifyBody": "Após a aplicação, <code>gzip --version</code> deve mencionar pigz. Um benchmark rápido também mostra a diferença de velocidade em um host multi-core:",
"whenTitle": "Quando isto é mais importante",
"whenBody": "O benefício aumenta com o <strong>número de núcleos do host</strong> e a <strong>frequência das cópias de segurança</strong>. Num servidor doméstico de 2 núcleos com um vzdump diário, o ganho é marginal. Num host de produção com 16 núcleos que guarda uma dúzia de VMs todas as noites, o pigz pode reduzir a janela de cópia a uma fração do tempo do gzip de uma thread."
},
"related": {
"heading": "Relacionado",
"items": [
{
"label": "Comandos de backup e restauração",
"href": "/docs/help-info/backup-commands",
"tailRich": " — vzdump CLI, incluindo a opção de threads <code>--pigz</code>."
},
{
"label": "Armazenamento",
"href": "/docs/post-install/storage",
"tail": " — limites de velocidade vzdump e afinação ZFS ARC."
},
{
"label": "Sistema",
"href": "/docs/post-install/system",
"tail": " — ajuste de descritores de ficheiros e memória."
},
{
"label": "Pós-instalação personalizável",
"href": "/docs/post-install/customizable",
"tail": " — voltar ao menu superior."
}
]
}
}
web/messages/pt/docs/post-install/security.json
+57
View File
@@ -0,0 +1,57 @@
{
"meta": {
"title": "Pós-instalação: Segurança | Documentação ProxMenux",
"description": "Opções de segurança disponíveis no script pós-instalação personalizável ProxMenux. Atualmente uma única opção: desabilitar o serviço portmapper/rpcbind para reduzir a superfície de ataque do host."
},
"header": {
"title": "Pós-instalação: Segurança",
"section": "Configurações pós-instalação do Proxmox"
},
"intro": {
"title": "O que esta categoria abrange",
"body": "A segurança pós-instalação limita-se ao <strong>reforço do host que pode ser aplicado em segurança sem supervisão</strong>: desativar serviços raramente necessários, com reversão pelo menu Desinstalar. As ferramentas ativas (Fail2Ban para prevenção de intrusões e Lynis para auditoria) ficam em <em>Segurança</em> no menu principal do ProxMenux, fora da pós-instalação."
},
"rpcbind": {
"heading": "Desactivar o portmapper / rpcbind",
"intro": "<code>rpcbind</code> (anteriormente <code>portmap</code>) é um serviço que mapeia números de programas RPC para portas de rede. É uma dependência para NFS e algumas ferramentas baseadas em RPC. Em um host típico do Proxmox que não está atuando como um servidor NFS, o <strong>nada o usa</strong> — e deixando-o habilitado mantém a porta <code>111/tcp</code> ouvindo em cada interface.",
"whyTitle": "Porque vale a pena desactivar",
"whyItems": [
"Reduz a superfície do ataque do hospedeiro — um serviço de escuta a menos para se preocupar.",
"Historicamente abusado como vetor de reflexão/amplificação em ataques de DDoS. Desativar o <code>rpcbind</code> remove esse fator de amplificação para o seu host.",
"Remove o ruído que gera em logs e saída <code>netstat</code> / <code>ss</code>, tornando a atividade real mais fácil de detectar."
],
"nfsTitle": "Não desactivar isto se usar o NFS",
"nfsBody": "O servidor NFS <strong>e</strong> o cliente NFS dependem do <code>rpcbind</code> para negociar as portas usadas por <code>mountd</code>, <code>statd</code>, <code>lockd</code>, etc. Se o host Proxmox <em>exportar</em> partilhas NFS para outras máquinas ou <em>montar</em> partilhas NFS de um NAS, não aplique esta opção. As montagens falharão com <code>mount.nfs: rpc.statd is not running</code> ou semelhante.",
"runsTitle": "O que o ProxMenux executa",
"runsOutro": "O pacote permanece instalado. O ProxMenux regista os estados originais de ativação e execução de rpcbind.service e rpcbind.socket, depois desativa e para ambas as unidades para impedir a reativação do serviço pelo socket.",
"verifyTitle": "Verificação",
"verifyBody": "Após a aplicação, confirme que o <code>rpcbind</code> está desligado e nada está ouvindo na porta 111:",
"reversibleTitle": "Restaura o estado de serviço original",
"reversibleBody": "A alteração é registada em <code>installed_tools.json</code>. <link>Desinstalar otimizações</link> repõe cada unidade rpcbind nos estados de ativação e execução registados antes da alteração pelo ProxMenux; não pressupõe que o rpcbind estivesse ativado em todos os hosts."
},
"related": {
"heading": "Relacionado",
"items": [
{
"label": "Menu de segurança",
"href": "/docs/security",
"tail": " — ferramentas mais completas: Fail2Ban (prevenção de intrusões) e Lynis (auditoria)."
},
{
"label": "Lynis",
"href": "/docs/security/lynis",
"tail": "— audite o host para encontrar mais oportunidades de proteção."
},
{
"label": "Comandos úteis do sistema",
"href": "/docs/help-info/system-commands",
"tail": " — estado dos serviços e referência para journalctl e lynis audit."
},
{
"label": "Pós-instalação personalizável",
"href": "/docs/post-install/customizable",
"tail": " — voltar ao menu superior."
}
]
}
}
web/messages/pt/docs/post-install/storage.json
+167
View File
@@ -0,0 +1,167 @@
{
"meta": {
"title": "Pós-instalação: Armazenamento | Documentação ProxMenux",
"description": "Otimizações de armazenamento do script pós-instalação personalizável ProxMenux: dimensão ZFS ARC pela RAM do host, instantâneos periódicos com zfs-auto-snapshot e remoção dos limites de velocidade dos backups vzdump."
},
"header": {
"title": "Pós-instalação: Armazenamento",
"section": "Configurações pós-instalação do Proxmox"
},
"intro": {
"title": "O que esta categoria abrange",
"body": "Quatro otimizações de armazenamento: ajustar <strong>ZFS ARC</strong> a uma fração adequada da RAM, instalar e agendar <strong>instantâneos ZFS automáticos</strong>, ativar <strong>ZFS autotrim</strong> em pools SSD/NVMe e retirar limitações de <strong>vzdump</strong> para acelerar backups. Escolha cada opção independente conforme o sistema. Uma quinta, <link>Log2RAM</link>, reduz desgaste SSD/NVMe movendo <code>/var/log</code> para ramdisk. Está em Opcionais porque o menu personalizável a agrupa aí."
},
"trackedTitle": "Todos os quatro são rastreados no menu Desinstalar",
"trackedBody": "Cada uma dessas opções registra uma ferramenta em <code>installed_tools.json</code>, então eles aparecem em <link>Otimizações de Uninstall</link>. Reverter o <code>zfs_arc</code> remove o <code>/etc/modprobe.d/99-zfsarc.conf</code> e reconstrói o initramfs; o <code>zfs_auto_snapshot</code> reverte o cronograma do cron e oferece purgar o pacote; o <code>zfs_autotrim</code> configura o <code>autotrim=off</code> nos pools que ele ativou; o <code>vzdump_speed</code> restaura o <code>/etc/vzdump.conf</code> do <code>.bak</code> a instalação criada.",
"arc": {
"heading": "Otimizar o tamanho do ZFS ARC",
"intro": "A <strong>Adaptive Replacement Cache (ARC)</strong> é a cache de leitura ZFS em RAM. Instalações Proxmox VE desde 8.1 limitam a 10% da RAM, máximo 16 GiB; hosts antigos ou atualizados podem diferir. Esta opção escreve o seu próprio limite pela RAM. Verifique definições e carga: uma cache menor nem sempre é mais rápida.",
"sizingTitle": "Regras de dimensionamento",
"headerRam": "RAM do host",
"headerMax": "Limite ARC",
"rows": [
{
"ram": "Fórmula",
"max": "RAM / 10, máximo 16 GiB e mínimo 64 MiB"
},
{
"ram": "Máquina 8 GB",
"max": "≈ 819 MiB (RAM/10)"
},
{
"ram": "Máquina 16 GB",
"max": "≈ 1.6 GiB (RAM/10)"
},
{
"ram": "Máquina 64 GB",
"max": "≈ 6.4 GiB (RAM/10)"
},
{
"ram": "≥ Máquina 160 GB",
"max": "16 GiB (limite)"
}
],
"after": "O ficheiro <code>/etc/modprobe.d/99-zfsarc.conf</code> contém apenas <code>options zfs zfs_arc_max=…</code>. Os outros parâmetros ZFS (<code>zfs_arc_min</code>, pré-leitura/limite de escritas L2ARC, tempo limite TXG) não são ajustados. Antes, procura outros <code>*.conf</code> em <code>/etc/modprobe.d/</code> com <code>zfs_arc_min</code> / <code>zfs_arc_max</code>, copia-os com manifesto para <code>/usr/local/share/proxmenux/backups/zfs_arc/</code> e remove linhas em conflito, deixando ativo só o ficheiro ARC ProxMenux. Depois, <code>update-initramfs -u -k all</code> e, quando aplicável, <code>proxmox-boot-tool refresh</code> integram o limite no initramfs dos sistemas com raiz ZFS.",
"rebootTitle": "Requer uma reinicialização para fazer efeito",
"rebootBody": "As definições ARC são lidas ao carregar o módulo <code>zfs</code>. Para hosts com raiz ZFS, ProxMenux regenera initramfs com <code>update-initramfs -u -k all</code> e atualiza o carregador quando necessário com <code>proxmox-boot-tool refresh</code>. O novo parâmetro continua a exigir reinício, assinalado automaticamente.",
"safeTitle": "Seguro em hosts não-ZFS",
"safeBody": "A função só escreve a configuração quando <code>zpool list</code> relata pelo menos um pool de ZFS. No ext4 / LVM- only Proxmox hosts, ou em máquinas com as ferramentas ZFS instaladas, mas sem pool importado, assinalar esta opção é um no-op - nada é escrito.",
"verifyTitle": "Verificação e retrocesso manual"
},
"autoSnap": {
"heading": "Instale o instantâneo automático do ZFS",
"intro": "Instala o pacote <a>zfs-auto-snapshot</a> e reescreve seus agendamentos cron para que instantâneos sejam tomados automaticamente em vários intervalos. Uma grande rede de segurança sem esforço em cima de seus backups regulares vzdump.",
"cadenceTitle": "Frequência dos instantâneos configurada pelo ProxMenux",
"headerLabel": "Rótulo",
"headerRuns": "Execução",
"headerKept": "Instantâneos retidos",
"rows": [
{
"label": "frequentes",
"runs": "cada 15 min",
"kept": "4"
},
{
"label": "horário",
"runs": "a cada hora",
"kept": "1"
},
{
"label": "diariamente",
"runs": "uma vez por dia",
"kept": "1"
},
{
"label": "semanalmente",
"runs": "uma vez por semana",
"kept": "1"
},
{
"label": "mensal",
"runs": "uma vez por mês",
"kept": "1"
}
],
"conservativeTitle": "Retenção limitada",
"conservativeBody": "ProxMenux usa retenção limitada: 4 instantâneos frequentes e 1 por cada intervalo mais longo, para conter a ocupação ZFS. Para reter mais, altere os números em <code>/etc/cron.d/zfs-auto-snapshot</code>, <code>/etc/cron.hourly/zfs-auto-snapshot</code> etc. após o script.",
"onlyZfsTitle": "Útil apenas em pools ZFS",
"onlyZfsBody": "Instalar o pacote num host apenas ext4 é inofensivo mas inútil: não há datasets ZFS para criar instantâneos. Ignore a opção se não usa ZFS.",
"verifyTitle": "Verificação e retrocesso manual"
},
"autotrim": {
"heading": "Ativar ZFS autotrim (pools SSD/NVMe)",
"intro": "Ativa <code>autotrim</code> em pools ZFS só com SSD ou NVMe compatíveis com TRIM. Por precaução, ignora pools com dispositivos rotacionais. Os pools já com <code>autotrim=on</code> ficam inalterados.",
"trimTitle": "O que TRIM faz, e por que importa em ZFS",
"trimBody1": "SSD e NVMe usam blocos internos de apagamento maiores que os setores lógicos do sistema de ficheiros. Quando um ficheiro é apagado, a unidade ainda não sabe que os setores estão livres e a limpeza interna pode continuar a mover dados obsoletos para libertar blocos. <strong>TRIM</strong> indica os setores livres para permitir o seu apagamento antecipado.",
"trimBody2": "Sem TRIM, o desempenho do SSD degrada-se ao longo do tempo, pois a unidade fica sem blocos pré-apagados e tem que fazer apagar-em-escrever, e aumentar a amplificação de gravação — tanto encurtando a vida útil da unidade. Com TRIM ativado, a unidade pode manter um saudável pool de blocos vazios prontos para escrever.",
"trimBody3": "Com <code>autotrim=on</code>, ZFS aplica TRIM em segundo plano ao espaço recém-libertado, agrupando intervalos. Um <code>zpool trim &lt;pool&gt;</code> periódico é alternativa. Autotrim evita agendamento separado, mas o impacto depende dos dispositivos; TRIM manual periódico pode ser melhor em algumas unidades modestas.",
"practicalTitle": "Por que isso é prático para habilitar?",
"practicalItems": [
"<strong>Desempenho de escrita sustentado.</strong> TRIM pode ajudar a recuperar blocos sem uso. Benefícios e impacto na latência dependem do dispositivo e da carga.",
"<strong>Vida útil da unidade.</strong> Evitar cópias internas desnecessárias pode reduzir amplificação de escrita e desgaste NAND, sem garantir uma duração adicional específica.",
"<strong>Sem tarefa cron para agendar.</strong> Ao contrário de um <code>zpool trim</code> periódico, autotrim é gerido automaticamente pelo pool."
],
"whenTitle": "Quando é que isto é necessário?",
"whenIntro1": "<strong>Considere ativá-lo</strong> em pools ZFS só com SSD/NVMe compatíveis com TRIM. Verifique comportamento e latência; TRIM manual agendado pode ser preferível.",
"whenIntro2": "<strong>O programa ignora- o automaticamente</strong> em:",
"whenSkipItems": [
"Pools com vdev HDD rotacional: filtro conservador de hardware deste script.",
"Unidades sem <code>discard_granularity</code> expostas em sysfs — geralmente SSDs antigos sem TRIM, ou caminhos de passagem onde o SO não pode ver o dispositivo subjacente.",
"Pools em que ZFS ela mesma relata a propriedade não suportada (raro; muito antigo pools).",
"Pools já definidos para <code>autotrim=on</code> (no-op)."
],
"whenIntro3": "<strong>Não relevante em hosts somente ext4</strong> — não há nada para ZFS cortar. A função termina com uma mensagem amigável nesse caso.",
"recordedTitle": "Por que apenas os pools ProxMenux alterados são registrados",
"recordedBody": "A função só escreve um pool para o seu arquivo de estado interno (<code>/usr/local/share/proxmenux/zfs_autotrim_pools</code>) quando ele ativamente virou esse pool de <code>off</code> para <code>on</code>. Pools que você tinha no autotrim antes de executar o script são deixados de fora da lista, então um futuro Desinstalar não desliga as configurações que você mesmo configurou — apenas as próprias alterações do ProxMenux são revertidas.",
"manualTitle": "Equivalente manual (executado no seu servidor)",
"manualIntro": "A sequência completa que o script executa contra cada pool é replicável à mão. Isto é o que você digitaria se você quisesse fazer a mesma coisa em um único pool sem ProxMenux:",
"verifyTitle": "Verificação e retrocesso manual",
"oneShotTitle": "Prefere TRIM pontual em vez de contínuo?",
"oneShotBody": "Alguns administradores preferem TRIM manual nas horas de menor carga. Desative autotrim e agende uma tarefa cron com <code>zpool trim &lt;pool&gt;</code>: mesmo objetivo, frequência diferente."
},
"vzdump": {
"heading": "Aumentar a velocidade de backup do vzdump",
"intro": "Escreve bwlimit: 0 e ionice: 5 na configuração global vzdump. Proxmox já não limita a banda por predefinição: só remove um limite configurado. Face a ionice: 7, o valor 5 aumenta a prioridade E/S best-effort se o escalonador a respeitar. Pode afetar os convidados e não garante backups mais rápidos.",
"changedTitle": "O que é alterado em /etc/vzdump.conf",
"backupTitle": "Primeira execução cria um .bak de vzdump.conf",
"backupBody": "Na primeira execução, ProxMenux copia <code>/etc/vzdump.conf</code> para <code>/etc/vzdump.conf.bak</code> antes de alterar. As seguintes preservam essa cópia para recuperar a configuração anterior. <code>bwlimit</code> e <code>ionice</code> são alterados com <code>sed</code>; outras opções como compress, pigz, tmpdir e exclude-path são preservadas.",
"skipTitle": "Quando saltar isto",
"skipBody": "Num host com armazenamento local lento e VMs sensíveis à latência, retirar o limite de banda pode causar lentidão durante backups. Se definiu <code>bwlimit</code> por esse motivo, mantenha-o e ignore a opção.",
"verifyTitle": "Verificação e retrocesso manual"
},
"related": {
"heading": "Relacionado",
"items": [
{
"label": "Comandos de gerenciamento ZFS",
"href": "/docs/help-info/zfs-commands",
"tail": " — referência zpool / zfs para ARC, instantâneos e scrub."
},
{
"label": "Comandos de armazenamento e discos",
"href": "/docs/help-info/storage-commands",
"tail": " — referência de dispositivos de blocos e armazenamento Proxmox."
},
{
"label": "Comandos de backup e restauração",
"href": "/docs/help-info/backup-commands",
"tail": " — referência CLI vzdump para banda e prioridade E/S."
},
{
"label": "Desinstalar otimizações",
"href": "/docs/post-install/uninstall",
"tail": " — reverter as alterações ARC / vzdump."
},
{
"label": "Log2RAM",
"href": "/docs/post-install/optional#log2ram",
"tail": " — reduz o desgaste SSD/NVMe por /var/log ramdisk backing; documentado sob opcional."
},
{
"label": "Pós-instalação personalizável",
"href": "/docs/post-install/customizable",
"tail": " — voltar ao menu superior."
}
]
}
}
web/messages/pt/docs/post-install/system.json
+133
View File
@@ -0,0 +1,133 @@
{
"meta": {
"title": "Pós-instalação: Sistema | Documentação ProxMenux",
"description": "Otimizações em nível de sistema no ProxMenux Script pós-instalação personalizável: journald e limites de tamanho de rotação de log, limites mais altos de kernel e descritor de arquivo, ajuste de memória balanceado, kexec para reinicializações rápidas e recuperação de kernel panic."
},
"header": {
"title": "Após a instalação: sistema",
"section": "Configurações pós-instalação do Proxmox"
},
"intro": {
"title": "O que esta categoria abrange",
"body": "Seis otimizações de sistema independentes. Ajustam <strong>journald</strong> e <strong>logrotate</strong> para os registos não encherem o disco, aumentam <strong>os limites do kernel e dos descritores de ficheiros</strong> para aplicações com muitos ficheiros abertos, <strong>equilibram a memória</strong> num host de virtualização, acrescentam <strong>kexec</strong> para reinícios sem BIOS e configuram <strong>a recuperação automática</strong> de kernel panic. As seis ficam registadas e são reversíveis no menu Desinstalar."
},
"journald": {
"heading": "Otimizar journald",
"intro": "Reescreve <code>/etc/systemd/journald.conf</code> com valores adequados para o journal systemd não encher gradualmente a partição raiz; depois reinicia <code>systemd-journald</code> e limpa registos antigos.",
"keyTitle": "Valores-chave",
"keyItems": [
"<code>Storage=persistent</code> — manter registros no disco através de reinicialização.",
"<code>SystemMaxUse=64M</code> / <code>RuntimeMaxUse=60M</code> — limites de utilização de disco e memória do journal.",
"<code>Compress=yes</code>, <code>Seal=no</code> — comprime registos e desativa a selagem com segurança futura (poupa CPU).",
"<code>MaxLevelStore=info</code> — guarda nível info e superiores, necessários ao visualizador de registos ProxMenux Monitor e à deteção de falhas de autenticação SSH/Proxmox pelo Fail2Ban no journal.",
"Limite de frequência: <code>1000 events / 30 s</code> para evitar um excesso de registos.",
"<code>ForwardToSyslog=no</code>, <code>ForwardToWall=no</code> — não duplicar mensagens para syslog ou transmitir para consoles."
],
"tipTitle": "Por que o MaxLevelStore=info importa",
"tipBody": "Um limiar mais rigoroso como <code>warning</code> faz ProxMenux Monitor mostrar entradas quase iguais em todos os períodos, pois a maioria da atividade é de nível info, e impede Fail2Ban de ver acessos falhados. Reduza o volume com <code>SystemMaxUse</code> e <code>RateLimitBurst</code> sem restringir os níveis guardados."
},
"logrotate": {
"heading": "Otimizar logrotate",
"intro": "Reescreve <code>/etc/logrotate.conf</code> com definições globais diárias e de tamanho, 7 rotações retidas, compressão e <code>copytruncate</code>, para os serviços continuarem a escrever sem reabrir os registos. O tamanho aparece após a frequência diária e prevalece, salvo regras específicas de cada registo. O <code>logrotate.conf</code> original é copiado para <code>.bak</code> na primeira aplicação.",
"tipTitle": "Compatível com Log2RAM",
"tipBody": "A diretiva <code>size 10M</code> prevalece sobre a definição diária anterior; <em>não</em> significa o primeiro dos dois critérios. Logrotate verifica o limiar quando é executado, e regras específicas podem substituir as globais. Com <code>/var/log</code> na RAM do Log2RAM, verifique as regras e a frequência do temporizador para controlar o espaço."
},
"limits": {
"heading": "Aumentar vários limites do sistema",
"intro": "Aumenta limites do kernel, systemd e PAM cujas predefinições podem ser baixas para um host com muitas VMs, contentores e serviços de rede.",
"headerFile": "Arquivo",
"headerSets": "O que define",
"rows": [
{
"file": "/etc/sysctl.d/99-maxwatches.conf",
"sets": "<code>fs.inotify.max_user_watches / max_user_instances / max_queued_events = 1048576</code>"
},
{
"file": "/etc/sysctl.d/99-maxkeys.conf",
"sets": "<code>kernel.keys.maxkeys / root_maxkeys = 1000000</code>"
},
{
"file": "/etc/sysctl.d/99-swap.conf",
"sets": "<code>vm.swappiness = 10</code>, <code>vm.vfs_cache_pressure = 100</code>"
},
{
"file": "/etc/sysctl.d/99-fs.conf",
"sets": "<code>fs.nr_open / file-max = 2097152</code>, <code>fs.aio-max-nr = 1048576</code>"
},
{
"file": "/etc/security/limits.d/99-limits.conf",
"sets": "<code>nofile</code> e <code>nproc</code> a 1 048 576 (ilimitados para root)"
},
{
"file": "/etc/systemd/system.conf + user.conf",
"sets": "<code>DefaultLimitNOFILE=1048576</code> para serviços systemd"
},
{
"file": "/etc/pam.d/common-session + runuser-l",
"sets": "<code>session required pam_limits.so</code> então o acima se aplica às shells de login"
},
{
"file": "/root/.profile",
"sets": "<code>ulimit -n 1048576</code> para a shell root"
}
],
"tipTitle": "Por que inotify é importante",
"tipBody": "Docker, Syncthing, as monitorizações de ficheiros Node.js e análises Plex podem esgotar <code>max_user_watches</code>. A predefinição depende do kernel e da memória; nem sempre é 8192. O limite de 1M permite mais monitorizações sem as pré-alocar. As ativas consomem memória do kernel: controle a utilização nos hosts com pouca RAM."
},
"memory": {
"heading": "Otimizar as configurações de memória",
"intro": "Escreve um perfil sysctl equilibrado para <code>/etc/sysctl.d/99-memory.conf</code>. Projetado para um host de hipervisor — prefere manter conjuntos de trabalho VM em RAM e libera páginas proativamente para que as rajadas de alocação não parem.",
"warnTitle": "swappiness=10 em hosts com pouca memória",
"warnBody": "Num host com 16 GB de RAM e muitas VMs, reduzir swappiness pode levar o kernel a terminar processos por falta de memória em vez de usar swap. Se os eventos OOM forem frequentes, aumente swappiness para 30–60 em <code>/etc/sysctl.d/99-memory.conf</code> após executar o script."
},
"kexec": {
"heading": "Activar reinicialização rápida (kexec)",
"intro": "Instala o <code>kexec-tools</code> e o liga para que você possa reiniciar o host diretamente em um novo kernel <em>sem passar pelo firmware BIOS/UEFI</em>. Em grandes servidores onde POST leva 45 – 90 segundos, isso transforma uma reinicialização de uma pausa de café em alguns segundos de parada.",
"installsTitle": "O que o ProxMenux instala",
"installsItems": [
"Pacote <code>kexec-tools</code> (debconf pré-configurado com <code>kexec-tools/load_kexec boolean false</code> para o apt não pedir confirmação e manter desativado o carregamento automático ao desligar).",
"Unidade systemd <code>/etc/systemd/system/kexec-pve.service</code> — carrega o kernel Proxmox e initrd em memória no arranque, reutilizando a linha de comandos atual do kernel.",
"Um apelido em <code>/root/.bash_profile</code>: <code>reboot-quick</code> → <code>systemctl kexec</code>."
],
"usageIntro": "Uso após a próxima reinicialização (ou manual <code>systemctl start kexec-pve</code>):",
"warnTitle": "Quando não usar o kexec",
"warnBody": "O kexec ignora o nível de firmware init. Se você confiar em BIOS/UEFI para redefinir o estado de hardware — por exemplo, um GPU fazendo a passagem que só repõe de forma limpa no POST completo, ou um firmware HBA problemático — o reboots do kexec pode deixar esses dispositivos em um estado semi-inicializado. Use um <code>reboot</code> normal após atualizações do kernel ou quando você precisar de alterações BIOS/UEFI para fazer efeito. <code>reboot-quick</code> é para reinícios diários."
},
"panic": {
"heading": "Habilite a reinicialização no kernel panic",
"intro": "Faz o kernel <strong>reiniciar automaticamente</strong> em vez de ficar bloqueado no ecrã de panic. Essencial em hosts Proxmox remotos ou sem consola local: um kernel bloqueado para todas as VMs até poder desligar e voltar a ligar a alimentação.",
"tipTitle": "Emparelha isto com o acesso remoto à consola",
"tipBody": "Auto-reboot é um mecanismo de recuperação, não uma ferramenta de depuração. Se você quiser <em>investigar</em> um pânico em vez de apenas voltar, use <link>a opção kexec</link> acima com o suporte kdump do kernel (não configurado pelo ProxMenux) ou capture um console serial para outro host antes de habilitar o reinício automático."
},
"verify": {
"heading": "Verificação",
"intro": "Após a aplicação das otimizações do sistema:",
"tipTitle": "Restauro e limitações",
"tipBody": "As seis opções ficam em <code>installed_tools.json</code> e <link>Desinstalar otimizações</link>. O restauro remove configurações, unidade e alias kexec e repõe journald/logrotate. Alguns limites ativos precisam de nova sessão ou reinício. A limpeza de /root/.profile só remove o antigo ulimit -n 256000; o atual ulimit -n 1048576 pode permanecer e exigir remoção manual."
},
"related": {
"heading": "Relacionado",
"items": [
{
"label": "Comandos úteis do sistema",
"href": "/docs/help-info/system-commands",
"tail": " — verificar as alterações (free -h, journalctl, ulimit -a)."
},
{
"label": "Desempenho",
"href": "/docs/post-install/performance",
"tail": " — afinação adicional do nível do sistema (pigz)."
},
{
"label": "Desinstalar otimizações",
"href": "/docs/post-install/uninstall",
"tail": " — reverter qualquer uma destas alterações."
},
{
"label": "Pós-instalação personalizável",
"href": "/docs/post-install/customizable",
"tail": " — voltar ao menu superior."
}
]
}
}
web/messages/pt/docs/post-install/uninstall.json
+271
View File
@@ -0,0 +1,271 @@
{
"meta": {
"title": "Desinstalar otimizações | Documentação ProxMenux",
"description": "Restaurar as alterações reversíveis de configuração pós-instalação aplicadas pelo ProxMenux. Ferramentas registradas usam desinstaladores dedicados que preservam o estado de host pré-existente sempre que possível."
},
"header": {
"title": "Desinstalar otimizações",
"description": "Restaurar as alterações reversíveis feitas pelos scripts pós-instalação automatizados ou personalizáveis. ProxMenux registra cada otimização suportada com sua função de restauração dedicada; upgrades de pacotes são intencionalmente excluídos.",
"section": "Configurações pós-instalação do Proxmox"
},
"intro": {
"title": "Por que isto existe",
"body": "Cada ajuste reversível suportado fica <strong>registado</strong> em <code>/usr/local/share/proxmenux/installed_tools.json</code>. O registo lista otimizações ativas e chama a função de restauro correspondente. Ações sem reversão segura, como uma atualização completa de pacotes, não são acrescentadas."
},
"openMenu": {
"heading": "Como abri-lo",
"body": "Do menu principal do ProxMenux, <strong>Configurações pós-instalação Proxmox → Desinstalar otimizações</strong>. Você verá uma lista de verificação das otimizações <em>aplicadas atualmente</em> — itens que você não tenha aplicado não aparecem.",
"imageAlt": "Desinstalar Lista de verificação de Otimizações mostrando itens atualmente aplicados no host, com caixas de seleção para selecionar quais reverter"
},
"howWorks": {
"heading": "Como funciona a inversão",
"steps": [
{
"title": "Registro e autodetecção",
"body1": "Na primeira execução, ProxMenux procura indicadores no host: <code>/etc/sysctl.d/99-memory.conf</code>, <code>/etc/apt/apt.conf.d/99-force-ipv4</code>, pacote <code>haveged</code> instalado, serviço Log2RAM ativo, etc. Os elementos reconhecidos são registados como reversíveis mesmo se aplicados por uma versão anterior ao registo.",
"body2": "Esta migração só funciona uma vez. Depois disso, cada aplicação/reversão atualiza diretamente o registro."
},
{
"title": "Escolha o que reverter",
"body1": "A lista de verificação mostra um rótulo legível pelo homem por item (por exemplo, <em>Otimização da Configuração da Memória</em>, <em>IOMMU/VFIO PCI Passthrough</em>, <em>Log2RAM (Proteção SSD)</em>). Assinale os que quiser reverter. Nada que não tiquetes será tocado."
},
{
"title": "Execução da reversão",
"body1": "Para cada item selecionado, ProxMenux chama sua função de desinstalação correspondente. A maioria das reversões segue um dos três padrões:",
"items": [
"<strong>A partir de cópia</strong> — restaura um <code>.bak</code> criado ao aplicar a alteração (bashrc, logrotate.conf, journald.conf, linha de comandos GRUB/kernel).",
"<strong>Remoção da configuração</strong> — remove os ficheiros ProxMenux <code>/etc/sysctl.d/99-*.conf</code>, <code>/etc/apt/apt.conf.d/99-*</code> ou a unidade systemd e recarrega.",
"<strong>Reinstale o pacote</strong> — para alterações de UI como o banner de assinatura, reinstale os pacotes upstream com <code>--force-confnew</code> para restaurar a configuração enviada."
],
"body2": "Cada inversão regista o seu progresso. Itens que requerem uma reinicialização (VFIO, nomes de interface persistentes) definem uma bandeira que ativa o prompt de reinicialização no final."
},
{
"title": "Pedido de reinício no fim",
"body1": "Após a reversão terminar, o menu mostra um prompt de reinicialização. Itens que mudaram os parâmetros do kernel, módulos do kernel ou nomes de rede (VFIO, nomes de interface persistentes) precisam da reinicialização para fazer efeito; outros itens não, e o prompt é um padrão de segurança em vez de uma verificação por item."
}
]
},
"reversible": {
"heading": "O que é reversível",
"intro": "As otimizações reversíveis registradas e seus desinstaladores correspondentes são agrupados aqui por área:",
"groups": [
{
"title": "Repositórios & APT",
"items": [
{
"tool": "Remoção da Banner de Assinatura",
"restores": "Primeiro tenta restaurar os ficheiros da interface a partir das cópias ProxMenux (/usr/local/share/proxmenux/backups/proxmoxlib.js.backup.* e index.html.tpl.backup.* se a interface móvel foi modificada). Só quando a cópia falta ou está danificada reinstala pve-manager, proxmox-widget-toolkit, libjs-extjs e libpve-http-server-perl com force-confnew. Também limpa cópias .js / .gz em cache."
},
{
"tool": "Ignorar idiomas do APT",
"restores": "Remove /etc/apt/apt.conf.d/99-disable-translations, permitindo os índices de descrições traduzidas segundo as restantes definições de idioma APT."
},
{
"tool": "Forçar IPv4 no APT",
"restores": "Remove /etc/apt/apt.conf.d/99-force-ipv4."
},
{
"tool": "Utilitários de Sistema",
"restores": "Purga apenas os pacotes utilitários selecionados que o ProxMenux gravou como recém-instalado. Pacotes já presentes antes da ação nunca são adicionados a esta lista e ficam intocados."
}
]
},
{
"title": "Limites de Kernel, memória e sistema",
"items": [
{
"tool": "Configuração da Memória",
"restores": "Remove o /etc/sysctl.d/99-memory.conf e recarrega o sysctl."
},
{
"tool": "Configuração do Pânico do Kernel",
"restores": "Remove /etc/sysctl.d/99-kernelpanic.conf."
},
{
"tool": "Aumento dos limites do sistema",
"restores": "Remove /etc/sysctl.d/99-maxwatches.conf, 99-maxkeys.conf, 99-swap.conf, 99-fs.conf e /etc/security/limits.d/99-limits.conf. Repõe limites PAM e DefaultLimitNOFILE systemd. Em /root/.profile só remove o antigo ulimit -n 256000; ulimit -n 1048576 do instalador atual pode permanecer e exigir remoção manual."
},
{
"tool": "Perfil de troca ZRAM",
"restores": "Desativa o swap /dev/zram0, para dev-zram0.swap e remove /etc/systemd/zram-generator.conf.d/90-proxmenux.conf. Só purga systemd-zram-generator se instalado pelo ProxMenux e sem outra configuração ZRAM. Se não conseguir evacuar as páginas, o perfil mantém-se ativo e nada é removido."
}
]
},
{
"title": "Rede",
"items": [
{
"tool": "Otimizações de Rede",
"restores": "Remove /etc/sysctl.d/99-network.conf, 97-proxmenux-fwbr.conf e 98-proxmenux-rpf.conf, a unidade proxmenux-fwbr-tune.service, o script /usr/local/sbin/proxmenux-fwbr-tune e a regra udev /etc/udev/rules.d/99-zz-proxmenux-fwbr-tune.rules. Retira também source /etc/network/interfaces.d/* de /etc/network/interfaces. Recarrega sysctl, systemd e regras udev."
},
{
"tool": "Open vSwitch",
"restores": "Executa apt purge para openvswitch-switch e openvswitch-common. Migre antes as pontes OVS para Linux; caso contrário, as VMs nessas pontes perdem a rede no próximo arranque."
},
{
"tool": "TCP BBR + TCP Fast Open",
"restores": "Remove /etc/sysctl.d/99-kernel-bbr.conf e 99-tcp-fastopen.conf e recarrega o restante sysctl. Eliminar ficheiros não repõe valores ativos; predefinições como cubic e tcp_fastopen=1 voltam após reiniciar, salvo outra configuração."
},
{
"tool": "Nomes de Interface Persistentes",
"restores": "Remove apenas os arquivos 10-proxmenux-*.link carregando o cabeçalho ProxMenux do /etc/systemd/network/. Qualquer arquivo .link fornecido por outro pacote ou escrito pelo usuário é deixado no lugar. Os nomes da interface retornam ao comportamento padrão do systemd na próxima reinicialização."
}
]
},
{
"title": "Registo",
"items": [
{
"tool": "Otimização do journald",
"restores": "Reescreve /etc/systemd/journald.conf com predefinições originais e reinicia systemd-journald."
},
{
"tool": "Otimização do Logrotate",
"restores": "Restaura /etc/logrotate.conf do arquivo .bak capturado antes da mudança."
},
{
"tool": "Log2RAM",
"restores": "Para e desativa o serviço e o timer. Purga trabalhos de cron, unidades systemd, binários, arquivos de configuração e o diretório /var/log.hdd. Também desinstala o pacote apt se ele foi instalado dessa forma."
},
{
"tool": "TRIM automático do ZFS",
"restores": "Lê /usr/local/share/proxmenux/zfs_autotrim_pools, a lista dos pools realmente alterados, e executa zpool set autotrim=off em cada um. Preserva autotrim ativado manualmente antes do ProxMenux."
}
]
},
{
"title": "Shell & aparência",
"items": [
{
"tool": "Personalização do Bashrc",
"restores": "Restaura /root/.bashrc do backup .bak. Se não existir backup, remove o bloco PMX_CORE_BASHRC por marcadores."
},
{
"tool": "Banner MOTD personalizado",
"restores": "Restaura o conteúdo original exato /etc/motd mantido sob /usr/local/share/proxmenux, remove o arquivo quando ele não existia antes, ou remove com segurança o marcador legado ao migrar uma instalação mais antiga."
},
{
"tool": "Fastfetch",
"restores": "Remove binário, diretório de configuração, integração update-motd e bloco delimitado BEGIN FASTFETCH / END FASTFETCH de /root/.bashrc, ~/.profile, /etc/profile e /etc/profile.d/fastfetch.sh. Purga o pacote apt se instalado."
},
{
"tool": "Figurine",
"restores": "Remove o binário, a entrada profile.d e o bloco de aliases em bashrc/profile."
}
]
},
{
"title": "Hardware e virtualização",
"items": [
{
"tool": "IOMMU / VFIO",
"restores": "Remove os módulos vfio de /etc/modules, as entradas de bloqueio dos controladores nouveau / radeon / nvidia e os parâmetros intel_iommu=on / amd_iommu=on / iommu=pt / pcie_acs_override de /etc/kernel/cmdline (ZFS) ou do GRUB. Reconstrói initramfs."
},
{
"tool": "Correcções AMD CPU (Ryzen/EPYC)",
"restores": "Remove idle=nomwait da linha de comandos do kernel (ZFS) ou GRUB e as opções ignore_msrs / report_ignored_msrs de /etc/modprobe.d/kvm.conf."
},
{
"tool": "Agente convidado para host Proxmox virtualizado",
"restores": "Lê /usr/local/share/proxmenux/guest_agent.pkg e purga o pacote registado do host. O instalador escolhe qemu-guest-agent, open-vm-tools ou virtualbox-guest-utils pelo hipervisor. Sem registo, tenta esses três pacotes. Atua no host Proxmox aninhado, não em modelos de convidados."
}
]
},
{
"title": "Armazenamento",
"items": [
{
"tool": "Dimensionamento do ARC do ZFS",
"restores": "Remove /etc/modprobe.d/99-zfsarc.conf, restaura *.conf externos em conflito guardados em /usr/local/share/proxmenux/backups/zfs_arc/, reconstrói initramfs e executa proxmox-boot-tool refresh em hosts systemd-boot."
},
{
"tool": "Snapshots automáticos do ZFS",
"restores": "Remove as entradas cron escritas pelo script e oferece apt purge zfs-auto-snapshot. Os instantâneos existentes nos pools são preservados; remova-os separadamente se necessário."
},
{
"tool": "Limites de velocidade do vzdump",
"restores": "Restaura /etc/vzdump.conf do .bak a instalação criada, trazendo de volta bwlimit e ionice para seus valores pré-ProxMenux."
}
]
},
{
"title": "Serviços & extras",
"items": [
{
"tool": "Sincronização do Tempo",
"restores": "Define o fuso- horário de volta para UTC (padrão seguro) via timedatectl."
},
{
"tool": "Geração de entropia (haveged)",
"restores": "Para, desativa e purga o pacote haveged."
},
{
"tool": "kexec (reiniciações rápidas)",
"restores": "Desativa kexec-pve.service, remove o ficheiro da unidade e o alias reboot-quick de /root/.bash_profile e purga kexec-tools."
},
{
"tool": "RPC / rpcbind Desabilitar",
"restores": "Restaura rpcbind.service e rpcbind.socket independentemente para os estados ativados/desativados e ativos/inativos registrados antes de ProxMenux os alterar."
},
{
"tool": "pigz (paralelo gzip)",
"restores": "Restaura o gzip original de gzip.distrib, remove o desvio dpkg e /bin/pigzwrapper, comenta a linha pigz em /etc/vzdump.conf e executa apt purge pigz após verificar gzip."
},
{
"tool": "Serviços de alta disponibilidade",
"restores": "Para e desactiva pve-ha-lrm, pve-ha-crm e corosync. Grupos HA existentes e definições de recursos não são excluídos — remova-os da interface web se você não precisar mais deles."
},
{
"tool": "repositório Ceph",
"restores": "Purga os pacotes Ceph instalados por esta opção, remove o deb822 /etc/apt/sources.list.d/ceph.sources no PVE 9 (ou a lista de Ceph no PVE 8) e atualiza o cache APT."
},
{
"tool": "OVH RTM (monitorização)",
"restores": "Purga pacotes correspondentes a ovh-rtm*, rtm e rtm-*, remove /etc/rtm e a entrada RTM do registo. Restos Puppet em /etc/puppet/ podem exigir inspeção e limpeza manual; o diretório não é eliminado. Fora da OVH, o instalador normalmente não altera nada."
}
]
}
]
},
"edge": {
"heading": "Casos particulares e limitações",
"packageTitle": "A reinstalação afeta pacotes Proxmox em utilização",
"packageBody": "Se as cópias ProxMenux não conseguirem reverter <strong>Remoção do aviso de subscrição</strong>, a alternativa reinstala <code>pve-manager</code>, <code>proxmox-widget-toolkit</code>, <code>libjs-extjs</code> e <code>libpve-http-server-perl</code> com <code>--force-confnew</code>. Afeta a interface em uso: atualize o navegador e aguarde alguns segundos pela reconexão. Evite fazê-lo durante migrações ou clonagens.",
"rebootTitle": "Nomes persistentes e VFIO precisam de uma reinicialização",
"rebootBody": "Removendo ProxMenux's <code>10-proxmenux-*.link</code> ficheiros (<em>Nomes de Interface Persistentes</em>) e reversão <em>IOMMU/VFIO</em> não afetam o sistema de execução — eles só importam após uma reinicialização. ProxMenux define a bandeira de reinicialização automaticamente para estes.",
"perItemTitle": "Podes reverter uma coisa e ficar com o resto.",
"perItemBody": "O desinstalador opera por item. Se você só quiser remover Log2RAM, mas manter o ajuste de rede e mudanças bashrc, marque apenas <em>Log2RAM</em>. Nada mais é tocado, e o registro é atualizado em conformidade."
},
"inspect": {
"heading": "Inspecionar o registro manualmente",
"intro": "Se você quiser ver o que é rastreado sem abrir o menu:",
"outro": "Cada entrada <code>\"tool\": true</code> corresponde a algo ProxMenux aplicado e pode reverter. Remover uma entrada manualmente não é recomendado — use sempre o menu, que também executa a função reversão em vez de apenas esquecer a mudança.",
"reinstallTitle": "Reinstalar após desinstalar",
"reinstallBody": "Reverter uma otimização não impede que você a aplique mais tarde. Abra <link>o menu Post-Install</link> novamente e execute Automatizado ou Personalizável – o registro irá rastrear o novo estado."
},
"related": {
"heading": "Relacionado",
"items": [
{
"label": "Pós- instalação automatizada",
"href": "/docs/post-install/automated",
"tail": " — reaplicar a configuração de base recomendada."
},
{
"label": "Pós-instalação personalizável",
"href": "/docs/post-install/customizable",
"tail": " — escolher um subconjunto diferente."
},
{
"label": "Desinstalar ProxMenux",
"href": "/docs/settings/uninstall-proxmenux",
"tail": " — operação diferente: remove o ProxMenux em si, não as suas otimizações aplicadas."
},
{
"label": "Visão geral da pós-instalação",
"href": "/docs/post-install",
"tail": "."
}
]
}
}
web/messages/pt/docs/post-install/updates.json
+112
View File
@@ -0,0 +1,112 @@
{
"meta": {
"title": "Aplicar atualizações disponíveis — Otimizações pós-instalação | Documentação ProxMenux",
"description": "Como o ProxMenux detecta quando uma otimização pós-instalação (Log2Ram, Configurações de Memória, Limites de Sistema, Logrotate, Ajuste de Rede...) foi atualizada a montante, e como aplicar a nova versão — do menu Post-Install ou do painel Monitor."
},
"header": {
"title": "Aplicar atualizações disponíveis",
"description": "Quando uma otimização pós-instalação (Log2Ram, definições de memória, limites do sistema, Logrotate…) tem uma versão no disco mais recente que a registada no host, o ProxMenux apresenta-a como atualização disponível. Pode aplicá-la pelo menu pós-instalação dos scripts ou pelo painel Monitor. Ambos executam novamente a mesma função e atualizam o registo.",
"section": "Configurações pós-instalação do Proxmox"
},
"intro": {
"title": "O que é isto?",
"body": "As otimizações pós-instalação ProxMenux têm versões, por exemplo <code>Log2ram SSD Protection v1.2</code>. O host regista as otimizações ativas e as suas versões em <code>/usr/local/share/proxmenux/installed_tools.json</code>. Quando uma nova versão ProxMenux atualiza uma otimização, deteta a diferença e propõe reaplicar só essa, sem repetir toda a pós-instalação."
},
"why": {
"heading": "Por que isto existe",
"body": "As otimizações pós-instalação recebem melhorias: ajustes sysctl, limites Logrotate mais rigorosos, novas regras de dimensão Log2RAM ou correções de casos extremos. Sem esta via, era necessário repetir o script, que reaplica <em>todas</em> as otimizações, ou abdicar da melhoria. Aplicar atualizações disponíveis permite escolher individualmente só as que mudaram de versão."
},
"detection": {
"heading": "Como as atualizações são detectadas",
"steps": [
{
"title": "Scripts com versão no disco",
"body": "Cada função pós-instalação declara sua versão dentro do script (<code>scripts/post_install/auto_post_install.sh</code> e <code>scripts/post_install/customizable_post_install.sh</code>). Um scanner extrai estas versões da fonte no disco."
},
{
"title": "Registo versionado na máquina",
"body": "Quando o operador aplicou cada otimização, a chamada <code>register_tool</code> correspondente escreveu a versão ativa em <code>/usr/local/share/proxmenux/installed_tools.json</code>. Esse arquivo é a fonte da verdade para \"o que está ativo neste host agora\"."
},
{
"title": "Monitor compara ambos os lados",
"body": "Na inicialização e a cada 24h, o Monitor compara versões de disco com versões de registro. Qualquer incompatibilidade produz uma entrada em <code>/usr/local/share/proxmenux/updates_available.json</code>. Esse arquivo dirige tanto a entrada de menu Post-Install quanto o cartão de painel Monitor."
},
{
"title": "Uma notificação por nova versão",
"body": "Se houver pelo menos uma atualização pendente, Monitor envia uma única notificação agrupada, por exemplo <em>«4 atualizações de otimizações ProxMenux disponíveis»</em>, com uma linha por ferramenta no formato <code>name (vX → vY)</code>, como nos pacotes Proxmox. Não a repete diariamente para o mesmo conjunto: só uma nova versão ou nova ferramenta na lista volta a ativá-la."
}
]
},
"pathA": {
"heading": "Caminho A — Do menu pós- instalação",
"intro": "No menu principal ProxMenux, abra <strong>Configurações pós-instalação do Proxmox</strong>. Havendo atualizações pendentes, surge <strong>Aplicar atualizações disponíveis (N)</strong> acima de <em>Desinstalar otimizações</em>. O número indica quantas têm versão no disco mais recente que a registada. Se tudo estiver atualizado, a entrada fica oculta.",
"menuAlt": "Post-Install Scripts menu mostrando a entrada condicional 'Aplicar atualizações disponíveis (N)' posicionado logo acima 'Desinstalar otimizações', com o crachá de contagem indicando quantas otimizações têm uma versão mais recente no disco",
"menuCaption": "A entrada <em>Aplicar atualizações disponíveis (N)</em> só renderiza quando pelo menos uma otimização tem uma atualização pendente — ela esconde quando o host está atual.",
"checklistBody": "Abre uma lista com todas as atualizações pendentes no formato <code>name (vX → vY)</code>. Estão todas selecionadas por predefinição; desmarque as que não pretende aplicar agora.",
"checklistAlt": "Janela Aplicar atualizações disponíveis com uma linha por otimização pendente, nome e mudança de versão (atual → disponível). Todas as linhas estão selecionadas.",
"checklistCaption": "Escolha individualmente as otimizações a atualizar. O mesmo motor de Automatizado e Personalizável reaplica cada função em segundo plano e atualiza a versão registada."
},
"pathB": {
"heading": "Caminho B — Do painel do monitor",
"intro": "As mesmas atualizações aparecem em Monitor, em <link>Configurações → Otimizações ProxMenux</link>. A ficha mostra um <strong>contador de atualizações</strong> pendentes que abre o seletor por otimização. Cada ferramenta também tem a sua ação de atualização.",
"imageAlt": "Ficha Otimizações ProxMenux nas configurações Monitor com contador de atualizações pendentes que abre o seletor e ações de atualização por ferramenta",
"imageCaption": "A ficha Otimizações de Monitor permite aceder às atualizações pelo contador quando existe uma versão mais recente no disco, sem acesso à shell."
},
"applying": {
"heading": "O que acontece ao aplicar",
"steps": [
{
"title": "Repetir a função pós-instalação",
"body": "A função escolhida volta a ser executada no host. Como é <strong>idempotente</strong>, não duplica a configuração: substitui a versão anterior pela nova, incluindo ficheiros sysctl, configurações adicionais e unidades de serviços."
},
{
"title": "Atualiza o registro",
"body": "A chamada <code>register_tool</code> dentro da função escreve a nova versão em <code>installed_tools.json</code>. A próxima varredura não vê mais um descompasso e a entrada de atualização desaparece tanto do menu quanto do cartão Monitor."
},
{
"title": "Sem reiniciar, a menos que a função o diga",
"body": "A maioria das actualizações produz efeitos imediatamente. Atualizações que tocam módulos do kernel, nomes de interface persistentes ou VFIO mostram o mesmo prompt de reinicialização que uma nova instalação seria."
},
{
"title": "Actualizar o registo enviado para o Monitor",
"body": "No fim do lote, o menu envia um pedido POST a <code>http://127.0.0.1:8008/api/updates/post-install/scan</code> para reconstruir <code>/usr/local/share/proxmenux/updates_available.json</code>. Após aplicar todas as atualizações, desaparecem o contador da ficha Otimizações e a entrada condicional da shell, sem esperar pelo próximo scan. A ficha continua disponível."
}
],
"jqTitle": "jq é necessário",
"jqBody": "A lista de verificação Caminho A baseia-se em <code>jq</code> para processar as atualizações pendentes JSON. Se o <code>jq</code> estiver faltando, o fluxo sai silenciosamente — você verá a entrada do menu com uma contagem, mas nada aconteceria depois de escolher linhas. Em qualquer instalação moderna Proxmox <code>jq</code> está presente; se em dúvida executar <code>apt install -y jq</code>."
},
"differs": {
"heading": "Como difere dos outros caminhos",
"headerPath": "Path",
"headerScope": "Escopo",
"headerWhen": "Quando faz sentido",
"rows": [
{
"pathLabel": "Automatizado",
"pathHref": "/docs/post-install/automated",
"scope": "Reaplica <em>todas</em> as otimizações do conjunto.",
"when": "Host novo ou reaplicação completa da base de um nó totalmente gerido."
},
{
"pathLabel": "Personalizável",
"pathHref": "/docs/post-install/customizable",
"scope": "Escolha no catálogo completo.",
"when": "Escolher exatamente as otimizações ativas no host."
},
{
"pathLabel": "Aplicar atualizações disponíveis",
"pathHref": null,
"scope": "Só as otimizações com versão mais recente no disco.",
"when": "Mantenha as otimizações já instaladas atuais sem tocar no resto."
},
{
"pathLabel": "Desinstalar otimizações",
"pathHref": "/docs/post-install/uninstall",
"scope": "Inverta a otimização e remova sua entrada de registro.",
"when": "Retroceda uma mudança específica."
}
]
},
"notifTitle": "Controlo da notificação",
"notifBody": "O evento <em>Atualizações de otimizações ProxMenux disponíveis</em> anuncia as atualizações pendentes. Está ativo por predefinição em cada canal e pode ser silenciado por canal em <link>Configurações → Notificações</link>. Só dispara uma vez por conjunto diferente de atualizações, não em cada scan de 24 horas."
}
web/messages/pt/docs/post-install/virtualization.json
+116
View File
@@ -0,0 +1,116 @@
{
"meta": {
"title": "Pós-instalação: Virtualização | Documentação ProxMenux",
"description": "Opções de virtualização no script pós-instalação personalizável ProxMenux: auto-instale o agente convidado certo se o Proxmox correr dentro de um VM, e habilite o IOMMU / VFIO para que você possa passar dispositivos PCI (GPUs, NICs, HBAS) através de suas próprias VMs."
},
"header": {
"title": "Post-Install: Virtualização",
"section": "Configurações pós-instalação do Proxmox"
},
"intro": {
"title": "O que esta categoria abrange",
"body": "Duas opções independentes. <strong>Instalar o agente convidado adequado</strong> ajuda quando o próprio Proxmox corre dentro de outro hipervisor. <strong>Ativar suporte VFIO IOMMU</strong> interessa à maioria dos utilizadores: ativa as funções do kernel para atribuir diretamente uma GPU, HBA ou placa de rede a uma VM com desempenho quase nativo."
},
"guestAgent": {
"heading": "Instale o agente convidado relevante",
"intro": "Deteta o ambiente de virtualização do host Proxmox através de <code>systemd-detect-virt</code> e <code>dmidecode</code> e instala as ferramentas de convidado adequadas para comunicar com o hipervisor externo: encerramento ordenado, sincronização do relógio, informação de IP, etc.",
"headerDetected": "Máquina detectada",
"headerPackage": "Pacote instalado",
"rows": [
{
"detected": "QEMU / KVM",
"package": "qemu-guest-agent"
},
{
"detected": "VMware (ESXi, Workstation)",
"package": "open-vm-tools"
},
{
"detected": "VirtualBox",
"package": "virtualbox-guest-utils"
},
{
"detected": "Hardware físico (nenhum)",
"package": "— no-op, nada instalado"
}
],
"skipTitle": "Ignore esta opção se o Proxmox correr diretamente no hardware",
"skipBody": "Se o Proxmox for executado diretamente no hardware (o caso comum), assinalar esta opção é um no-op — o detector devolve <code>none</code> e o script sai sem alterações. A opção só importa para a minoria de configurações que executam Proxmox <em> como um guest</em> para testes ou laboratórios."
},
"vfio": {
"heading": "Habilitar suporte VFIO IOMMU",
"intro": "Ativa IOMMU no host e carrega os módulos para passthrough PCI (<code>vfio</code>, <code>vfio_iommu_type1</code>, <code>vfio_pci</code>). Pode então atribuir um dispositivo físico a uma VM, que terá acesso direto com desempenho quase nativo.",
"whoTitle": "Quem precisa disto?",
"whoItems": [
"Quer atribuir uma GPU a uma VM Windows para jogos ou a uma VM macOS.",
"Você tem um NIC de 10G dedicado para um firewall/roteador VM (OPNsense, pfSense).",
"Você quer passar um HBA diretamente para um TrueNAS / Unraid VM para ZFS em discos nus.",
"Você está planejando usar <em>Coral TPU</em>, uma placa de captura, ou um dongle SDR em um VM."
],
"whoOutro": "Se nada disso se aplicar, você pode ignorar esta opção com segurança. Para passagem para um <strong>LXC</strong> (não um VM), o IOMMU <em>não</em> é necessário.",
"doesTitle": "O que o ProxMenux faz",
"doesIntro": "A função está ciente de boot-loader: detecta se Proxmox está em ZFS (systemd-boot) ou LVM/ext4 (GRUB) e escreve para o arquivo direito. Também é idempotente — se os parâmetros já estão presentes, nada é adicionado.",
"headerBoot": "Tipo de arranque",
"headerFile": "Ficheiro alterado",
"headerPost": "Passo de pós- atualização",
"bootRows": [
{
"boot": "systemd-boot (ZFS)",
"file": "/etc/kernel/cmdline",
"post": "proxmox-boot-tool refresh"
},
{
"boot": "GRUB (LVM/ext4)",
"file": "/etc/default/grub",
"post": "update-grub"
}
],
"kernelIntro": "Parâmetros do kernel adicionados:",
"modulesIntro": "Módulos de kernel adicionados ao <code>/etc/modules</code>:",
"blacklistIntro": "Conflitantes drivers na lista negra em <code>/etc/modprobe.d/blacklist.conf</code>:",
"blacklistTitle": "A lista negra de drivers GPU entra em conflito com o uso do GPU no lado do host",
"blacklistBody": "A lista de bloqueio impede o kernel do host de associar <em>qualquer</em> controlador GPU, permitindo ao VFIO assumir a GPU. É o pretendido para passthrough a uma VM, mas é o <strong>oposto</strong> do necessário para <link>instalar controladores NVIDIA no host</link>, por exemplo para transcodificação LXC. Escolha um caminho por GPU:",
"pathItems": [
"<strong>GPU → VM:</strong> habilite VFIO/IOMMU aqui, deixe os drivers GPU na lista negra.",
"<strong>GPU → LXC (ou host):</strong> ignore esta opção, use a instalação NVIDIA no host e não bloqueie nvidia/nouveau.",
"<strong>Dois GPUs:</strong> um pode ir para um VM e o outro para um LXC, mas você precisará de uma configuração mais fina (ligar apenas um cartão para <code>vfio-pci</code> por ID PCI). A lista negra padrão é muito ampla para este caso — edite <code>blacklist.conf</code> depois."
],
"acsTitle": "Sobre o pcie_acs_override — saiba o que está habilitando",
"acsBody": "<code>pcie_acs_override=downstream,multifunction</code> relaxa a verificação dos Serviços de Controle de Acesso PCIe. Ele permite que o kernel divida grupos IOMMU que o firmware reporta como monolítico, que às vezes é a única maneira de passar através de um dispositivo de um grupo sem arrastar o resto. O trade-off é o isolamento reduzido <strong> entre dispositivos</strong>: um VM malicioso ou comprometido com passagem tem uma superfície de ataque maior via DMA. Tudo bem para um laboratório doméstico; pense duas vezes antes de habilitar um host que executa cargas de trabalho não confiáveis. Se você não precisar, remova esse token do <code>/etc/kernel/cmdline</code> ou <code>/etc/default/grub</code> após o script correr e execute novamente a etapa de atualização do carregador de inicialização.",
"rebootTitle": "Reinício necessário",
"rebootBody": "IOMMU, módulos VFIO e lista de bloqueio entram em vigor após regenerar initramfs e reiniciar. O script executa <code>update-initramfs -u -k all</code>, atualiza o carregador de arranque e indica «reinício necessário» para que Personalizável o proponha no fim.",
"verifyTitle": "Verificação após reiniciar",
"revertTitle": "Reversível do menu Desinstalar",
"revertBody": "<link>Desinstalar otimizações</link> reverte todas as alterações: remove os parâmetros IOMMU de <code>/etc/kernel/cmdline</code> ou GRUB, os módulos VFIO de <code>/etc/modules</code> e as entradas de bloqueio dos controladores, depois reconstrói initramfs. É necessário reiniciar para aplicar a reversão."
},
"related": {
"heading": "Relacionado",
"items": [
{
"label": "Adicionar GPU à VM (passthrough)",
"href": "/docs/hardware/gpu-vm-passthrough",
"tail": " — passo seguinte natural uma vez activado o IOMMU + VFIO."
},
{
"label": "Adicionar Controlador ou NVMe ao VM",
"href": "/docs/disk-manager/add-controller-nvme-vm",
"tail": " — a mesma infra-estrutura de passagem para os controladores de armazenamento."
},
{
"label": "Comandos de passagem GPU",
"href": "/docs/help-info/gpu-commands",
"tail": " — Referência da verificação IOMMU."
},
{
"label": "Desinstalar otimizações",
"href": "/docs/post-install/uninstall",
"tail": " — reverter IOMMU / VFIO de forma limpa."
},
{
"label": "Pós-instalação personalizável",
"href": "/docs/post-install/customizable",
"tail": " — voltar ao menu superior."
}
]
}
}