Pular para o conteúdo
Linux para todos os rolês
  1. Rolês e receitas
  2. Receitas
  3. Pasta compartilhada com Samba

Pasta compartilhada com Samba

Compartilha uma pasta com os outros computadores e celulares da casa, só pela rede local, com um nome e uma senha para cada pessoa, separada da senha do computador.

servicos/samba Risco médio Pede a senha de administrador Testada em máquina virtual no Ubuntu e no Debian
Um notebook com Windows e um celular da casa abrem a pasta compartilhada pela rede local, cada um com o nome e a senha da pasta. Uma conexão vinda da internet fica de fora. Computador da casa /srv/compartilhado dono: ana Notebook (Windows) beto + senha da pasta Celular ana + senha da pasta só a rede de casa · sem visitante · sem SMB1 a senha da pasta não abre o computador
Ilustração. Cada pessoa abre a pasta pela rede de casa com o próprio nome e uma senha que só serve para a pasta.

Em resumo

O que faz e o que não faz

O que faz

  • Cria a pasta que você escolher, por padrão /srv/compartilhado, ou usa uma que já existe, com os arquivos dela.
  • Compartilha pela rede com o Samba, que Windows, Mac, Linux, Android e iPhone já sabem abrir, sem instalar nada neles.
  • Cria um acesso para cada pessoa, com uma senha que só serve para a pasta. Quem não tem conta no computador ganha uma conta sem login.
  • Faz a pasta aparecer em “Rede” no Windows e no Linux, com o wsdd2.
  • Aceita só a rede de casa, no próprio Samba e no firewall.

O que não faz

  • Não deixa a pasta acessível pela internet. Para abrir de fora, há o rolê “Acessar de fora sem abrir portas”.
  • Não aceita visitante sem senha nem o protocolo antigo SMB1.
  • Não usa nem troca a senha de ninguém no computador.
  • Não compartilha a pasta pessoal inteira nem as pastas do sistema.
  • Não mostra as senhas na tela nem no log: elas ficam num arquivo que só o root lê.
  • Não apaga os arquivos da pasta quando a receita é desfeita.

Passo a passo

Como o bora aplica esta receita

As mesmas quatro etapas de toda receita, com o que esta confere em cada uma.

  1. Verificar já está aplicada?

    Confere se o Samba está instalado, se a configuração do bora está no lugar, se cada pessoa tem acesso e, com o firewall ligado, se a rede local está liberada.

  2. Aplicar faz a mudança

    Cria a pasta, instala o samba, o smbclient e o wsdd2, escreve /etc/samba/bora-pasta-compartilhada.conf, confere com testparm, cria as contas que faltam, gera e cadastra uma senha para cada pessoa e libera as portas só para a rede local.

  3. Testar funcionou?

    Confere os valores que valem de verdade com testparm, o Samba ligado no boot e, com o smbclient, entra com o nome e a senha de uma pessoa, cria um arquivo e apaga. Uma senha errada e um visitante não entram.

  4. Desfazer quando você pedir

    Remove as regras do firewall, os acessos, as contas que criou, as senhas e a configuração, e os pacotes que instalou. A pasta e os arquivos ficam.

No terminal

Uma aplicação de verdade

A saída de um teste em contêiner no Ubuntu 24.04, encurtada nas linhas do apt e com o endereço trocado por um de casa. Numa máquina de verdade, o teste também entra na pasta pelo smbclient.

Os porquês

Por que assim

Por que Samba?

É o jeito que todo sistema já entende de abrir pastas pela rede. O Windows, o Mac, o Linux e os celulares falam SMB sem instalar nada.

Por que uma senha só para a pasta?

Se a senha do compartilhamento vazar, ela não abre o computador. Cada pessoa tem a sua, e dá para tirar o acesso de uma sem mexer nas outras. Por isso a receita também impede que trocar a senha da pasta pelo Windows troque a senha do computador, que é o padrão do Ubuntu e do Debian.

Por que o bora gera as senhas?

O plano é um arquivo que pode ir para o Git ou para uma IA, então não pode levar senha, e a receita não para no meio para perguntar. As senhas geradas são fáceis de ditar e ficam num arquivo que só o root lê. Para trocar a de alguém: sudo smbpasswd nome.

Por que sem SMB1 e sem visitante?

O SMB1 é a versão antiga do protocolo, com as falhas mais graves, e o Windows 10 e 11 já não usam. Visitante sem senha deixaria qualquer aparelho que entra na rede da casa, como o celular de uma visita, ver a pasta.

De quem ficam os arquivos?

De quem é dono da pasta neste computador, quem quer que tenha criado o arquivo pela rede. Assim ninguém fica sem conseguir abrir ou apagar o que outra pessoa criou.

Como

O que muda no sistema

Parâmetros

O que dá para escolher

ParâmetroPadrãoO que é
pasta/srv/compartilhadoQual pasta você quer compartilhar? Se ela não existir, o bora cria.
usuariosNoneQuem vai abrir a pasta pelos outros aparelhos? Escreva os nomes separados por vírgula, como ana,beto. Cada nome ganha uma senha só para a pasta.
nomeCompartilhadoO nome que aparece nos outros aparelhos, como \\computador\Compartilhado. Letras sem acento, números, - e _.
aparecer_na_redesimAparecer sozinho em "Rede" no Windows e no Linux (WS-Discovery, com o wsdd2). Sem isso, a pasta abre pelo endereço.
usuarioautoA conta dona dos arquivos, quando o bora cria a pasta. Com auto, é quem rodou o bora com sudo. Numa pasta que já existe, o dono continua o mesmo.
rede_localautoA rede da casa, como 192.168.0.0/24, a única que o Samba e o firewall aceitam.

No menu, o bora pergunta o que precisa. Num script ou num agente, passe os parâmetros na linha de comando:
bora plano --receitas servicos/samba -p servicos/samba.aparecer_na_rede=nao

Confira você mesmo

Os comandos para conferir

sudo cat /var/lib/bora/pasta-compartilhada/senhasMostra a senha de cada pessoa.
sudo smbpasswd betoTroca a senha da pasta de uma pessoa.
\\192.168.0.20\CompartilhadoNo Explorador de Arquivos do Windows, com o endereço que o bora mostrou.
smbclient //127.0.0.1/Compartilhado -U betoEntra na pasta pelo terminal, neste computador.

Onde funciona

Distros e testes

UbuntuTestada em VMUbuntu, Mint, Pop!_OS, Zorin
DebianTestada em VMDebian 13
FedoraPlanejadaFedora, Nobara
ArchPlanejadaArch, CachyOS, EndeavourOS, Manjaro
Fedora imutávelPlanejadaBazzite, Silverblue, Kinoite
openSUSEPlanejadaTumbleweed, Leap

Registro de testes

DistroOndeDataResultado
Debian 13Contêiner (teste automático)10/11/2026Passou
Ubuntu 24.04Contêiner (teste automático)10/11/2026Passou
Ubuntu 26.04Contêiner (teste automático)10/11/2026Passou
Debian 13Máquina virtual15/11/2026Passou
Ubuntu 24.04Máquina virtual15/11/2026Passou
Ubuntu 26.04Máquina virtual15/11/2026Passou

Testada em contêiner: passou nos testes automáticos dessa família, que rodam num contêiner a cada pull request, sem kernel, disco nem tela de login de verdade. Testada em VM: além disso, foi aplicada, conferida e desfeita numa máquina virtual (VM) de verdade, o que o CI faz toda semana. O registro acima mostra a última vez de cada distro. Enquanto uma receita só tem o teste em contêiner, o bora avisa quando monta o plano. Testar numa máquina sua é uma das ajudas mais valiosas.

Onde ela entra

Rolês que usam esta receita

Fontes

Para ler mais

Bora melhorar

Falta alguma coisa?

Os pedidos viram issues no GitHub, onde qualquer pessoa pode comentar, votar com um 👍 ou se oferecer para fazer.