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

Ilustração: um homem dançando com a palavra samba em letras coloridas

🌐 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.

Alguns textos e imagens deste site foram criados com a ajuda de IA ou gerados por IA. Detalhes