{ "meta": { "title": "Máquina: Adicionar o disco local como armazenamento Proxmox ProxMenux Documentação", "description": "Formate um disco SATA, SAS ou NVMe local num host Proxmox e registe-o como armazenamento de tipo diretório ou pool ZFS. Inclui seleção segura do disco, confirmação das operações destrutivas, fstab por UUID, criação do pool ZFS e utilização de pvesm add dir / zfspool.", "ogTitle": "Máquina: Adicionar o disco local como armazenamento Proxmox ProxMenux Documentação", "ogDescription": "Formate um disco local e registre-o como armazenamento de diretório ou pool ZFS no Proxmox com um fluxo guiado e filtros de segurança." }, "header": { "title": "Máquina: Adicionar disco local como armazenamento Proxmox", "description": "Pegue um disco físico na máquina Proxmox, opcionalmente formate-o (ext4 / xfs / btrfs / zfs) e registre-o como armazenamento Proxmox — quer como diretório (pvesm add dir) quer como um pool ZFS (pvesm add zfspool). ProxMenux filtra a lista de discos para que você não possa escolher o disco raiz ou qualquer coisa em uso, e torna cada passo destrutivo explícito antes de executá-lo.", "section": "Armazenamento e Compartilhamento · Máquina" }, "intro": { "title": "O que isto faz", "body": "Outras ferramentas Host nesta seção lidam com armazenamento de rede (NFS / Samba / iSCSI). Este lida com discos locais — unidades de reposição fisicamente conectadas ao seu host Proxmox que você deseja usar para discos VM, backups, ISOs ou modelos. ProxMenux prepara o disco (partição + formato + montagem) e registra-o em Proxmox para que a UI possa colocar conteúdo lá." }, "destructive": { "title": "Ferramenta destrutiva para o caminho do 'formato'", "body": "A opção Formatar destrói as partições e os dados existentes no disco selecionado. O ProxMenux mostra um aviso, filtra discos em uso e exige confirmação antes de executar wipefs / sgdisk / mkfs. Isso não é uma sobrescrita segura de cada byte. Confira duas vezes o caminho do dispositivo antes de confirmar." }, "compare": { "heading": "Directório vs ZFS pool — qual escolher", "headerDir": "Pasta (ext4 / xfs / btrfs)", "headerZfs": "Conjunto ZFS", "rows": [ { "label": "Tipo de armazenamento Proxmox", "dirRich": "dir", "zfsRich": "zfspool" }, { "label": "Formato de disco VM", "dir": "Arquivo qcow2 / raw em um sistema de arquivos", "zfs": "Conjunto de dados nativo ZFS (zvol) por disco" }, { "label": "Instantâneos", "dir": "qcow2 instantâneos; btrfs instantâneos se fs=btrfs", "zfs": "Nativo, instantâneo, copy-on-write" }, { "label": "Aprovisionamento dinâmico", "dir": "Sim (qcow2 por omissão)", "zfs": "Sim (ZFS por omissão)" }, { "label": "Necessidades de RAM", "dir": "Baixo", "zfs": "Altas — o ZFS usa a RAM livre como cache ARC" }, { "label": "Suporta tipos de conteúdo", "dir": "images, backup, iso, vztmpl, snippets, rootdir", "zfs": "apenas images e rootdir (armazenamento em blocos)" }, { "label": "Melhor para", "dir": "Disco de uso geral: mistura de discos VM, backups, ISOs", "zfs": "Puro disco de dados VM / LXC com instantâneo + necessidades de integridade" } ] }, "opening": { "heading": "Abrir a ferramenta", "body": "Do menu principal do ProxMenux, abra o Storage & Share Manager → Adicione disco local como armazenamento Proxmox. Você verá este sub-menu com quatro opções:", "imageAlt": "Menu de gerenciamento de disco local — Adicionar / Ver / Remover / Listar discos disponíveis" }, "howRuns": { "heading": "Como o script é executado (Adicionar fluxo)", "body": "O fluxo tem duas fases com um filtro de segurança com três verificações. Fase 1 descobre discos seguros, decide o que fazer com o escolhido e coleta parâmetros de armazenamento; Fase 2 faz o trabalho destrutivo. Até a confirmação final o disco está intocado." }, "format": { "heading": "Formatar um disco em branco", "intro": "O caminho para um disco fresco ou um cujo conteúdo você não se importa.", "items": [ "Escolha o disco (sistema / discos em uso estão escondidos).", "Escolha \"Format disk (ERASE todos os dados)\".", "Escolha o sistema de arquivos — veja a tabela acima para trade-offs.", "ID de armazenamento (padrão disk-<device>), caminho de montagem, tipo de conteúdo predefinido.", "Confirme no diálogo CONFIRMAÇÃO FINAL — OS DADOS SERÃO APAGADOS.", "O ProxMenux limpa a tabela de partições e cria uma partição que ocupa o disco. Executa mkfs.<fs> ou zpool create e monta o resultado. Sistemas de arquivos comuns recebem uma entrada UUID em /etc/fstab com defaults,nofail; o ZFS usa a configuração de montagem do pool. Se Como armazenamento Proxmox estiver marcado (sempre no caso do ZFS), ele é registrado com pvesm add dir ou pvesm add zfspool; caso contrário, fica apenas como montagem do host." ], "tipTitle": "Porquê UUID + nofail em /etc/fstab", "tipBody": "O script escreve UUID=… /mnt/<id> <fs> defaults,nofail 0 2. O UUID sobrevive à reordenação do dispositivo através de reinicialização (então o /dev/sdc tornando-se o /dev/sdd não quebra a inicialização). nofail significa que se o disco desaparecer (falha de Hardware, desconectado), o Proxmox ainda inicia — o armazenamento só será mostrado como inativo até que o disco volte." }, "reuse": { "heading": "Reutilizar um sistema de ficheiros existente", "intro": "O caminho para um disco que você deseja manter os dados em — talvez você tenha movido de outro host Proxmox, ou o disco já tem backups / ISOs que você deseja manter acessível.", "items": [ "Escolhe o disco.", "Escolha \"Usar o sistema de arquivos existente\".", "ID de armazenamento, local de montagem, predefinição do tipo de conteúdo.", "ProxMenux não toca nos dados: ele cria o ponto de montagem, monta o disco, adiciona uma entrada UUID a /etc/fstab e a registra como um armazenamento Proxmox dir." ], "warnTitle": "O caminho de reutilização não lida com ZFS pools", "warnBody": "Se o disco já contém um pool ZFS, o caminho reuse aqui apenas tenta montá-lo como um sistema de arquivos regular – que falha. Para importar um pool ZFS existente use zpool import <name> na linha de comando e registre-o manualmente com pvesm add zfspool." }, "presets": { "heading": "Predefinições do tipo de conteúdo", "intro": "O ProxMenux oferece três predefinições e uma opção personalizada. A lista de conteúdo escolhida é passada para pvesm add … --content <csv>:", "headerPreset": "Predefinição", "headerContent": "Texto do conteúdo", "headerUse": "Caso de uso", "rows": [ { "preset": "Armazenamento VM", "content": "images,backup", "use": "Um armazenamento dedicado aos discos de VMs que também mantém os backups dessas VMs por perto." }, { "preset": "NAS padrão", "content": "backup,iso,vztmpl", "use": "Um arquivo / disco de mídia — backups, ISOs e modelos LXC. Nenhum disco VM vivo aqui." }, { "preset": "Todos os tipos", "content": "images,backup,iso,vztmpl,snippets", "use": "Esta predefinição ampla habilita imagens, backups, ISOs, modelos LXC e snippets. Adicione outros tipos compatíveis, como rootdir, pela opção Personalizado se necessário." }, { "preset": "Personalizado", "content": "(input livre)", "useRich": "Digite o CSV exato, por exemplo. images sozinho, ou rootdir,images." } ], "zfsTitle": "ZFS pool conteúdo é mais estreito", "zfsBody": "Com zfs, um zfspool aceita apenas images e rootdir, não arquivos ISO ou backups. Informe uma lista compatível em Personalizado. O script a encaminha sem alterações; tipos incompatíveis podem fazer o registro falhar. Verifique pvesm status depois." }, "manual": { "heading": "Equivalente manual", "extIntro": "Formato + registrar um disco como armazenamento de diretório ext4:", "zfsIntro": "Ou como um ZFS pool:" }, "view": { "heading": "Ver os armazenamentos de discos", "body": "Lista cada armazenamento Proxmox apoiado em disco (ambos dir e zfspool que são criados pelo usuário – pools de sistema como rpool estão escondidos). Mostra o caminho de montagem / nome do pool, tipos de conteúdo e estado ao vivo." }, "remove": { "heading": "Remover o armazenamento do disco", "body": "Remove o registro do armazenamento no Proxmox (pvesm remove) e oferece limpar a entrada correspondente em /etc/fstab. O script não destrói pools ZFS automaticamente; isso exige executar separadamente zpool destroy <name> quando tiver certeza.", "warnTitle": "Dados e dependências VM existentes", "warnBody": "A remoção do armazenamento não toca no sistema de arquivos nem no pool — os dados permanecem no disco. Mas VMs / CTs que referenciam este armazenamento por ID não vai começar após a remoção. Mova esses discos VM para outro armazenamento (ou faça um backup) antes de remover." }, "list": { "heading": "Listar os discos disponíveis", "body": "Uma visão diagnóstica somente de leitura: imprime a saída de lsblk -o NAME,SIZE,TYPE,FSTYPE,MOUNTPOINT,MODEL seguida pelo dir / zfspool armazenamentos já conhecidos pelo Proxmox. Boa primeira parada quando você abrir a ferramenta e quiser ver \"o que está neste host?\" antes de adicionar qualquer coisa." }, "troubleshoot": { "heading": "Resolução de Problemas", "noDisksTitle": "\"Nenhum disco disponível encontrado\"", "noDisksIntro": "O filtro de segurança escondeu todos os discos. Razões comuns:", "noDisksItems": [ "Apenas o disco raiz está presente.", "Cada outro disco é parte de uma matriz ativa ZFS / LVM / RAID.", "Cada outro disco é referenciado por uma configuração VM ou LXC (passthrough).", "O disco está em modo somente leitura (falha de hardware ou bloqueio de gravação)." ], "noDisksOutro": "Use Lista de discos disponíveis do menu para ver a saída lsblk bruta e entender o que está acontecendo.", "mountedTitle": "O formato falha com \"o dispositivo está montado\"", "mountedBody": "Algo montou automaticamente o disco (udisksd, um gerenciador de desktop, uma unidade de systemd). Desmontá-lo: umount /dev/sdX?* ou systemctl stop <whatever-mounts-it>, então tente novamente. O filtro de segurança do script deve ter discos montados ocultos, então se você alcançou este erro a montagem aconteceu entre o menu mostrando e você confirmando.", "zpoolTitle": "zpool create falha com «invalid vdev specification»", "zpoolBody": "Normalmente significa que o disco ainda tem GPT / LVM / ZFS assinaturas que zpool se recusa a substituir sem força. O script executa wipefs e sgdisk --zap-all antes do formato, mas um disco muito teimoso ainda pode ter uma etiqueta antiga. Forçar uma limpeza limpa manualmente: zpool labelclear -f /dev/sdX ou dd if=/dev/zero of=/dev/sdX bs=1M count=10 e tentar novamente.", "inactiveTitle": "O armazenamento mostra como inativo após reiniciar", "inactiveBody": "Verifique findmnt <mount-path> — se a montagem está faltando, algo em /etc/fstab falhou. dmesg | tail geralmente aponta para a razão (incompatibilidade UUID, corrupção do sistema de arquivos, nofail deixou cair a repetição). Um mount -a geralmente reativa o armazenamento uma vez que a causa é fixa." }, "related": { "heading": "Relacionado", "items": [ { "href": "/docs/disk-manager/format-disk", "label": "Gerenciador de disco: Formato / Limpar disco físico", "tail": " — alternativa de baixo nível quando você só quer preparar um disco sem registá-lo como armazenamento Proxmox." }, { "href": "/docs/storage-share/host-iscsi", "label": "Adicionar o alvo iSCSI como armazenamento Proxmox", "tail": " — equivalente de rede quando o dispositivo de blocos está em outra máquina." }, { "href": "/docs/storage-share/host-local-shared", "label": "Adicionar a Pasta Partilhada na Máquina", "tail": " — preparar um directório na máquina para as montagens de ligação LXC (não regista um armazenamento Proxmox)." } ] } }