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.
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
Em resumo
/srv/compartilhado, ou usa uma que já existe, com os arquivos dela.wsdd2.Passo a passo
As mesmas quatro etapas de toda receita, com o que esta confere em cada uma.
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.
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.
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.
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
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
É 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.
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.
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.
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 é 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
wsdd2 só com aparecer_na_rede.smb.conf.Parâmetros
| Parâmetro | Padrão | O que é |
|---|---|---|
pasta | /srv/compartilhado | Qual pasta você quer compartilhar? Se ela não existir, o bora cria. |
usuarios | None | Quem 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. |
nome | Compartilhado | O nome que aparece nos outros aparelhos, como \\computador\Compartilhado. Letras sem acento, números, - e _. |
aparecer_na_rede | sim | Aparecer sozinho em "Rede" no Windows e no Linux (WS-Discovery, com o wsdd2). Sem isso, a pasta abre pelo endereço. |
usuario | auto | A 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_local | auto | A 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
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
| Distro | Onde | Data | Resultado |
|---|---|---|---|
| Debian 13 | Contêiner (teste automático) | 10/11/2026 | Passou |
| Ubuntu 24.04 | Contêiner (teste automático) | 10/11/2026 | Passou |
| Ubuntu 26.04 | Contêiner (teste automático) | 10/11/2026 | Passou |
| Debian 13 | Máquina virtual | 15/11/2026 | Passou |
| Ubuntu 24.04 | Máquina virtual | 15/11/2026 | Passou |
| Ubuntu 26.04 | Máquina virtual | 15/11/2026 | Passou |
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
Fontes
Bora melhorar
Os pedidos viram issues no GitHub, onde qualquer pessoa pode comentar, votar com um 👍 ou se oferecer para fazer.
Uma opção nova, um comportamento diferente ou algo que esta receita ainda não faz.
Fazer um pedidoUsa Fedora, Arch ou outra família? Diga qual, e conte se puder testar.
Pedir outra distroUma mudança que o bora ainda não sabe fazer, dentro deste rolê ou fora dele.
Pedir uma receitaAlgo não funcionou como esta página diz? O formulário já vem com o roteiro.
RelatarFicou confuso? Sugira um jeito melhor de dizer, direto no arquivo.
Ver no GitHub