Configuração otimizada do Samba no Debian 13 para homelabs Linux

🌐 Também em: English · Deutsch · Français · Español · Italiano · Nederlands · Polski
O Samba é uma implementação open source do conjunto de protocolos SMB/CIFS e permite que sistemas Linux
compartilhem arquivos e diretórios pela rede de forma padronizada.
Originalmente projetado para interoperar com sistemas Windows, o Samba há muito tempo se tornou também uma
solução de servidor de arquivos confiável e eficiente para ambientes Linux-com-Linux.
Em homelabs e pequenas instalações de servidores, o Samba costuma ser usado para oferecer armazenamento centralizado,
controle de acesso simples e compartilhamento de arquivos em rede previsível, sem introduzir protocolos
ou serviços adicionais.
Este artigo documenta uma configuração do Samba que uso ativamente no meu próprio homelab.
Ela roda no Debian GNU/Linux 13 e atende clientes Linux em uma rede de 1 Gbit.
O objetivo não é a máxima compatibilidade, mas clareza, desempenho e previsibilidade.
Nada de SMB1 legado, nada de parâmetros de tuning obscuros — só uma configuração do Samba limpa e moderna.
Índice
Visão geral do ambiente
- SO do servidor: Debian GNU/Linux 13
- Clientes: só Linux
- Rede: Ethernet de 1 Gbit
- Armazenamento: RAID5
- Protocolo: SMB3
Preparando o sistema de arquivos (montagem persistente via /etc/fstab)
Antes de configurar o Samba, o sistema de arquivos subjacente precisa estar montado de forma confiável.
Nesta configuração, os dados compartilhados ficam em um volume RAID5 formatado com ext4.
O sistema de arquivos é montado de forma persistente via /etc/fstab e referenciado pelo seu UUID
para evitar problemas com nomes de dispositivo que mudam entre reboots.
Entrada no /etc/fstab
UUID=a64b3c6f-25fa-4ef2-93f6-7714b459c015 /mnt/raid5 ext4 defaults 0 2
Criando o ponto de montagem e verificando a configuração
sudo mkdir -p /mnt/raid5
sudo mount -a
df -h /mnt/raid5
Todos os compartilhamentos do Samba apontam para caminhos dentro deste ponto de montagem.
Garantir que ele seja montado corretamente no boot é essencial para um servidor de arquivos estável.
Instalando o Samba no Debian 13
sudo apt update
sudo apt install samba samba-common-bin
Verifique a instalação:
smbd -V
Gerenciamento de usuários (Linux + Samba)
O Samba se integra melhor quando reutiliza usuários Unix existentes.
Esta configuração não depende de fallbacks para convidado nem de modelos de autenticação paralelos.
Criar um usuário Linux
sudo adduser user3
Atribuir a propriedade no sistema de arquivos
sudo chown -R user3:user3 /mnt/raid5/data
Adicionar o usuário ao Samba
sudo smbpasswd -a user3
Configuração global do Samba
Abaixo está o /etc/samba/smb.conf exato que uso em produção.
[global]
server min protocol = SMB2_10
server max protocol = SMB3
workgroup = smb
security = user
map to guest = never
kernel share modes = yes
log level = 1
log file = /var/log/samba/log.%m
max log size = 1000
aio read size = 1
aio write size = 1
use sendfile = yes
server multi channel support = yes
server role = standalone server
Por que estas configurações são usadas
- Só SMB2.1+ e SMB3 – mais segurança e desempenho
- I/O assíncrono para melhor throughput com arquivos grandes
- sendfile() para reduzir o overhead de CPU
- Nível de log baixo para evitar I/O de disco desnecessário
Observação: o SMB multichannel está habilitado aqui, mas com uma única NIC de 1 Gbit não traz nenhum benefício mensurável.
É inofensivo, mas opcional.
Compartilhamento principal autenticado
[shared]
path = /mnt/raid5/data/
read only = no
valid users = user3
force user = user3
strict locking = no
oplocks = yes
kernel oplocks = yes
Este compartilhamento é usado para armazenamento geral, backups e arquivos de mídia.
As permissões do sistema de arquivos são aplicadas no nível Unix, não corrigidas pelo Samba.
Compartilhamento secundário com acesso restrito (user1)
Este compartilhamento usa o mesmo modelo de segurança e desempenho que o compartilhamento principal de dados.
O acesso de convidado foi removido por completo.
[user1]
path = /mnt/raid5/data/user1/
read only = no
valid users = user3
force user = user3
strict locking = no
oplocks = yes
kernel oplocks = yes
Agora os dois compartilhamentos se comportam de forma consistente e previsível.
Validar e reiniciar o Samba
sudo testparm
sudo systemctl restart smbd
Expectativas de desempenho
- ~105–115 MB/s de throughput sequencial em uma LAN de 1 Gbit
- Baixo uso de CPU
- Transferências estáveis de arquivos grandes
Na prática, o fator limitante é quase sempre o I/O de disco ou o layout do RAID — não o Samba em si.
Conclusão
Esta configuração não é teórica — é exatamente o setup que uso todos os dias.
Ao apostar em protocolos modernos, padrões sensatos e permissões Unix,
o Samba continua sendo um servidor de arquivos rápido e confiável para homelabs Linux.
Infraestrutura deve ser entediante.
Este setup consegue exatamente isso.
Aviso
A configuração e as recomendações descritas neste artigo se baseiam em
experimentação pessoal e uso prático em um ambiente de homelab privado.
Elas são fornecidas apenas para fins informativos e vêm sem qualquer garantia de correção,
completude ou adequação a um propósito específico.
Embora o setup funcione de forma confiável no meu ambiente, as configurações de sistema podem variar.
Aplicar estas configurações é inteiramente por sua conta e risco.
Sempre teste mudanças em um ambiente controlado antes de implantá-las em sistemas de produção.
