"title":"Adicionar um disco USB a LXC e partilhá-lo com Samba | ProxMenux",
"description":"Disponibilize um disco ou uma pen USB num contentor LXC privilegiado no Proxmox VE, instale Samba no contentor e partilhe o conteúdo na rede.",
"ogTitle":"Adicionar um disco USB a LXC e partilhá-lo com Samba",
"ogDescription":"Disponibilize um disco USB num contentor LXC privilegiado no Proxmox VE, instale Samba e partilhe o conteúdo na rede local."
},
"header":{
"title":"Adicionar um disco ou uma pen USB a LXC e partilhá-los na rede com Samba",
"description":"Disponibilize um disco ou uma pen USB num contentor LXC privilegiado no Proxmox VE, instale Samba no contentor e partilhe o conteúdo na rede.",
"section":"Guias"
},
"recommended":{
"calloutTitle":"Recomendado",
"calloutIntro":"O ProxMenux disponibiliza ambas as partes deste procedimento através de menus guiados:",
"items":[
"<strong>Gestão de discos → Formatar/apagar disco físico</strong> para a formatação.",
"<strong>Armazenamento e partilha → Partilha de rede LXC → Servidor Samba em LXC</strong> para a instalação no contentor privilegiado e a configuração do Samba."
],
"calloutOutro":"Os procedimentos guiados tratam das permissões dos contentores sem privilégios, dos perfis de partilha com leitura e escrita, só leitura ou personalizados e do grupo sharedfiles. Este guia descreve os passos manuais para os compreender ou configurar diretamente."
},
"intro":{
"body":"Um disco ou uma pen USB pode ser útil num anfitrião Proxmox, sobretudo num mini PC com poucas opções de expansão interna. Este guia explica:",
"stepsTitle":"O que vai fazer",
"steps":[
"Anexando o disco USB a um LXC privilegiado.",
"A instalar o Samba dentro do contentor.",
"Partilhar o conteúdo do disco pela LAN."
],
"useCasesTitle":"Casos de uso",
"useCases":[
"Guardar ficheiros torrent e disponibilizá-los na rede.",
"Fornecer armazenamento a um servidor multimédia como Plex, Jellyfin ou Emby.",
"Guardar documentos processados automaticamente pelo Paperless.",
"Armazenamento genérico estilo NAS para a rede doméstica."
],
"privilegedCalloutTitle":"Contentor privilegiado para este procedimento",
"privilegedCalloutBody":"Este procedimento utiliza um contentor LXC privilegiado com um dispositivo de blocos como <code>mp0</code>. Para contentores sem privilégios, pode montar o sistema de ficheiros no anfitrião e disponibilizar o diretório por bind mount, com permissões e mapeamento de identificadores adequados. Consulte <strong>Armazenamento e partilha → Pontos de montagem LXC</strong> no ProxMenux."
},
"attach":{
"heading":"1. Disponibilizar o disco USB em LXC",
"identifyHeading":"1.1 Identificar o dispositivo",
"identifyBody":"Compare a lista de discos <strong>antes</strong> e <strong>depois</strong> da ligação USB. O novo dispositivo é o disco pretendido.",
"beforeLabel":"Antes:",
"afterLabel":"Após:",
"imageBeforeAlt":"Lista de disco antes de adicionar unidade USB",
"imageAfterAlt":"Lista de disco depois de adicionar unidade USB",
"lsblkBody":"Pode também utilizar <code>lsblk -o NAME,SIZE,MODEL,SERIAL</code> para listar dispositivos de blocos com modelo e número de série.",
"stableCalloutTitle":"Importante — utilizar um identificador estável",
"stableCalloutBody":"O nome <code>/dev/sdb1</code> pode mudar após um reinício, sobretudo com vários discos USB. Procure o identificador persistente:",
"stableCalloutCode":"ls -l /dev/disk/by-id/",
"stableCalloutAfter":"Utilize a entrada <code>/dev/disk/by-id/usb-...</code> da partição pretendida na configuração LXC, em vez de <code>/dev/sdb1</code>. Escolha a partição, não o disco completo: continuará identificável se a ordem dos dispositivos mudar.",
"formatHeading":"1.2 Formatar o disco",
"formatBody":"ext4 é adequado para partilhas Linux: distingue maiúsculas e suporta ACL POSIX e ficheiros grandes. A formatação destrói o conteúdo do sistema de ficheiros existente. Confirme a partição e execute o comando no <strong>anfitrião Proxmox</strong>:",
"formatCode":"mkfs.ext4 /dev/sdb1",
"formatAfter":"Substitua <code>/dev/sdb1</code> pela partição real ou pelo respetivo caminho persistente <code>/dev/disk/by-id/usb-...-part1</code>.",
"mkdirHeading":"1.3 Criar o ponto de montagem no contentor LXC",
"mkdirBody":"Dentro do LXC, crie o diretório onde o disco irá aparecer (qualquer nome funciona):",
"mkdirCode":"mkdir /mnt/lxc_USB",
"wireHeading":"1.4 Configurar o dispositivo em LXC",
"wireBody":"No <strong>anfitrião Proxmox</strong>, edite a configuração do contentor. Substitua <code>'<'CTID'>'</code> pelo respetivo ID:",
"wireShortForm":"Pode também utilizar a entrada curta <code>mp0: /dev/sdb1,mp=/mnt/lxc_USB,backup=0</code> se aceitar o risco de alteração do caminho do dispositivo.",
"wireBackupNote":"O exemplo utiliza <code>backup=0</code>. O conteúdo dos pontos de montagem de dispositivos e dos bind mounts não é incluído nas cópias <code>vzdump</code> do contentor. Prepare uma cópia separada dos dados do disco externo.",
"restartHeading":"1.5 Reinicie o LXC e defina permissões",
"restartBody":"Reinicie o CT para aplicar o ponto de montagem:",
"restartCode":"pct reboot CTID",
"permsBody":"No contentor LXC, crie a conta da partilha antes de lhe atribuir a propriedade e defina as permissões do diretório:",
"permsNote":"Substitua <code>proxmenux</code> pelo nome escolhido. O modo <code>770</code> permite o acesso ao proprietário e ao grupo, sem acesso para outros; é mais restritivo do que <code>chmod -R 777</code>. A conta é criada aqui e registada no Samba no passo 2.2."
},
"samba":{
"heading":"2. Instalar o Samba",
"installHeading":"2.1 Instale o pacote dentro do LXC",
"confirmBody":"Confirme que o serviço está em execução:",
"confirmCode":"systemctl status smbd.service",
"userHeading":"2.2 Verificar a conta da partilha",
"userBody":"A conta de sistema <code>proxmenux</code> foi criada sem shell de início de sessão no passo 1.5. Verifique-a antes de definir a palavra-passe Samba e utilize sempre o nome escolhido:",
"userCode":"id proxmenux",
"passwordBody":"Defina a palavra-passe Samba, separada da palavra-passe do sistema, pois o Samba mantém o seu próprio armazenamento de credenciais:",
"passwordCode":"smbpasswd -a proxmenux",
"aclHeading":"2.3 Definir propriedade e ACL",
"aclBody":"Se o <code>chown</code> do passo 1.5 for suficiente, as permissões estão prontas. Para vários utilizadores com direitos diferentes no mesmo caminho, utilize ACL:",
"validUsersNote":"A linha <code>valid users = proxmenux</code> restringe o acesso ao único usuário do Samba. Para acesso baseado em grupo, use <code>valid users = @samba_users</code> após adicionar o(s) usuário(s) a um grupo chamado <code>samba_users</code>.",
"reloadHeading":"3.2 Recarregar Samba",
"reloadCode":"systemctl restart smbd"
},
"verify":{
"heading":"4. Verificar o acesso",
"body":"De qualquer cliente da LAN, navegue até <code>\\\\'<'CT_IP'>'</code> (Windows) ou <code>smb://'<'CT_IP'>'</code> (macOS / gerenciadores de arquivos Linux). Autentique com o usuário Samba (<code>proxmenux</code>) e a senha que você definiu com <code>smbpasswd</code>.",
"image1Alt":"Acesso ao servidor Samba de um cliente",
"image2Alt":"Pedido de autenticação Samba",
"usageBody":"Pode utilizar a partilha no contentor e através da rede:",
"image3Alt":"Utilização do disco USB através da partilha"
},
"troubleshoot":{
"heading":"Resolução de Problemas",
"items":[
"<strong><code>pct reboot</code> falha com “device not found”:</strong> confirme que o caminho em <code>mp0</code> existe no anfitrião. Verifique <code>ls -l /dev/disk/by-id/</code> e corrija o caminho.",
"<strong>O contentor arranca, mas <code>/mnt/lxc_USB</code> está vazio:</strong> o disco pode não estar montado ou o sistema de ficheiros pode estar vazio. Verifique no anfitrião com <code>pct exec '<'CTID'>' -- mount | grep lxc_USB</code>. Se a montagem faltar, examine a configuração, o caminho do dispositivo e os erros de arranque.",
"<strong>A autenticação Samba funciona, mas a escrita falha com “Permission denied”:</strong> verifique as permissões Linux do diretório e as definições de escrita da partilha. Reveja <code>chown</code> e <code>setfacl</code> nas secções 1.5 e 2.3.",
"<strong>A partilha não aparece, mas <code>smb://'<'ip'>'/lxc_usb</code> funciona:</strong> a descoberta NetBIOS antiga utiliza <code>nmbd</code>. O Windows moderno utiliza WS-Discovery; em Debian 12 instale <code>apt-get install -y wsdd</code>; em Debian 13, onde <code>wsdd</code> não está no arquivo estável, use <code>apt-get install -y wsdd2</code>. Verifique o serviço e a firewall. Ativar apenas <code>nmbd</code> não fornece WS-Discovery.",
"<strong>Para adicionar outro utilizador à partilha:</strong> crie a conta com <code>adduser</code>, registe-a com <code>smbpasswd -a</code> e adicione-a à lista <code>valid users =</code>, separada por vírgulas. Atribua também as permissões ou ACL necessárias no sistema de ficheiros."
