Montando um NAS de homelab com OpenZFS, Samba, Jenkins e GitLab — totalmente automatizado com Ansible

Ilustração de um NAS de homelab com OpenZFS, Samba, Jenkins e GitLab

🌐 Também em: English · Deutsch · Français · Español · Italiano · Nederlands · Polski

📦 O que era para ser um rápido “vou montar um NAS neste fim de semana” virou uma semana de tocas de coelho, yak shaving e um número absurdo de commits no git. Mas tudo bem — o homelab saiu ganhando, e agora está tudo automatizado e documentado. Como sempre, o código Ansible completo está aqui:

👉 github.com/aptupgrademe/www_k3s

Antes de chegar ao NAS e ao OpenZFS — que são a atração principal — deixa eu despejar rapidinho as missões paralelas que aconteceram pelo caminho. Pule para a seção do ZFS se estiver impaciente. Não vou julgar.


Índice

🐿️ Missões paralelas: tudo o que não era o NAS

Você sabe como é. Começa a configurar um NAS e três dias depois está consertando regras de alerta do Grafana e escrevendo um guia de operações em francês. Foi isto que aconteceu:

🔒 Correções de segurança (a edição “peraí, isso estava aberto?!”)

  • O rpcbind estava escutando na porta 111 — publicamente. NFS não é usado em lugar nenhum. Corrigido. 😬
  • O rkhunter mandava e-mails de “infected!” toda manhã — porque o SourceForge passou a usar redirecionamentos HTTPS e o curl não os seguia. Adicionei curl -L. Também automatizei rkhunter --propupd depois do dnf-automatic, para que as atualizações de segurança noturnas não pareçam rootkits.
  • As regras de alerta do Grafana tinham os limites embutidos no PromQL, o que causava erros “condition must not be empty” quando as métricas estavam abaixo do limite. Movi os limites para o evaluator. Agora funciona de verdade.
  • Drop-ins de hardening do systemd implantados: o sshd foi de exposure score 9.6 → 7.8, node_exporter e prometheus de 9.2 → 4.4 cada.
  • Serviços desnecessários cortados: rpcbind, gssproxy, sssd — nenhum deles necessário, todos rodando.

⚡ Desempenho

  • Autoptimize instalado no WordPress: o número de tags JS/CSS caiu de 40 para 6. Tamanho da página ~18% menor.
  • O robots.txt devolvia 404. O Yoast SEO o gera dinamicamente via PHP, mas o nginx o tratava como arquivo estático. Uma diretiva try_files depois — corrigido.
  • tcp_max_syn_backlog aumentado de 512 para 4096 para combinar com o somaxconn.
  • Transparent Huge Pages mudado de always para madvise — o padrão causa picos de latência em pods do K3s, no MariaDB e no Redis.

🎨 Design & SEO

  • O cabeçalho do blog ganhou um redesign: o logo do admin voador agora fica à direita (espelhado, para olhar para dentro em vez de voar para fora da página), o título do site à esquerda, fundo escuro combinando com as barras de navegação. Coisas pequenas, grande diferença.
  • 165 imagens não tinham texto alternativo. Corrigido com um script WP-CLI que deriva as descrições automaticamente dos nomes dos arquivos. Isso levou mais tempo que a montagem do NAS.
  • O robots.txt agora expõe direito aos buscadores o sitemap gerado pelo Yoast.
  • Adicionei “Home” como primeiro item do menu de navegação. Pelo visto não era óbvio como voltar para a página inicial. Ops.

📚 Documentação

Porque aparentemente eu gosto de escrever documentação mais do que é saudável: os guias de operações agora estão disponíveis em alemão, inglês e francês para WordPress, Nextcloud e o novo NAS. Sim, francês. A pasta docs/ do repositório tem os seis arquivos HTML.


🗄️ A atração principal: NAS com OpenZFS no Debian 13

Certo. A coisa que eu realmente queria fazer.

Por que ZFS? Um pouco de história

O ZFS foi desenvolvido originalmente pela Sun Microsystems e lançado pela primeira vez com o Solaris 10 em 2005. O nome significava “Zettabyte File System” — a Sun não estava sendo modesta. Ele foi projetado do zero para resolver problemas que os sistemas de arquivos UNIX tradicionais vinham empurrando com a barriga havia décadas: corrupção silenciosa, estado inconsistente depois de crashes, o horror geral do fsck em volumes grandes.

Quando a Oracle comprou a Sun em 2010, o desenvolvimento do ZFS no lado open source virou um fork, o OpenZFS — hoje o projeto comunitário mantido ativamente que roda em Linux, FreeBSD, macOS e outros. É ele que estamos usando.

Uma coisa que eu achei por muito tempo: ZFS é coisa de FreeBSD. Acontece que não é bem assim. O OpenZFS vem nos repositórios do Debian 13 e instala sem problemas. Estou rodando pela primeira vez, então ainda não tenho números do mundo real. Meu palpite é que o throughput bruto pode ser um pouco menor que um setup ext4/mdadm afinado — mas a troca por checksums, detecção de corrupção silenciosa e snapshots deixa os dados bem mais seguros. Vamos ver como ele se sai. 🧪

✅ O que torna o ZFS ótimo

  • Checksums de ponta a ponta — cada bloco recebe um checksum na escrita, verificado na leitura. Corrupção silenciosa (“bit rot”) é detectada e, num pool redundante, reparada automaticamente.
  • Copy-on-Write (CoW) — dados nunca são sobrescritos no lugar. Isso torna os snapshots praticamente gratuitos e elimina o problema do write hole do RAID-5.
  • Snapshots — cópias pontuais de um dataset, criadas instantaneamente e armazenadas de forma eficiente. Rollback em segundos.
  • RAID embutido (RAIDZ) — sem controladora RAID separada, sem corrupção silenciosa de metadados. RAIDZ1/2/3 são nativos do ZFS.
  • Compressão — transparente, por dataset. zstd dá 30–50% de economia de espaço em documentos e backups com custo de CPU desprezível.
  • Cache ARC — o ZFS gerencia seu próprio cache de leitura adaptativo na RAM. Mais RAM = leituras mais rápidas.
  • Armazenamento em pool — todos os datasets compartilham o espaço do pool dinamicamente. Chega de recortar partições fixas.

⚠️ As desvantagens

  • Come muita RAM — o ARC é guloso. Um NAS de verdade quer 16–32 GB.
  • Sem redimensionamento fácil do RAIDZ — não dá para simplesmente adicionar um disco a um vdev RAIDZ existente. O ZFS 2.2+ adicionou expansão, mas ainda não é instantânea.
  • RAM ECC fortemente recomendada — o ZFS confia na RAM. Se a RAM corromper um bit silenciosamente antes da escrita, o ZFS calcula o checksum da corrupção como válida. ECC evita isso.
  • Curva de aprendizado — pools, vdevs, datasets, propriedades. Um modelo mental diferente dos sistemas de arquivos tradicionais. Vale a pena, mas vai um fim de semana nisso.

🏗️ O setup de verdade

Antes, os mesmos três SSDs rodavam um RAID5 clássico por software no Linux (md) com ext4 por cima. Funcionava, mas não oferecia nenhuma das garantias de integridade, snapshots ou compressão do ZFS. Hora de fazer upgrade.

O hardware é um HP MicroServer Gen10 Plus V2 — Intel Xeon E-2314, 31 GB de RAM. Layout de armazenamento:

  • sdb (SSD de 465 GB) → SO Debian 13
  • sda + sdc + sdd (3× SSD WD Red SA500 de 1,8 TB) → ZFS RAIDZ1
  • sde (HDD Toshiba de 1,8 TB) → /mnt/usb backup externo

A role do Ansible cria o pool assim:

zpool create -f
  -o ashift=12          # 4K sector alignment for modern SSDs
  -o autotrim=on        # TRIM commands for SSD health
  -O compression=zstd   # transparent compression
  -O atime=off          # no access-time writes on reads
  -O xattr=sa           # Samba xattrs in inodes (faster)
  -O recordsize=128k    # overridden to 1M per dataset
  -O mountpoint=/raid5
  data raidz /dev/disk/by-id/ata-WD_Red_SA500_...

📁 Samba — fonte única da verdade

A decisão de design central: as definições dos shares Samba em vars.yml comandam tudo. A role do Ansible percorre essas definições para criar os datasets ZFS, definir o dono e escrever o smb.conf. Adicione um share em um só lugar — o resto vem automaticamente:

nas_samba_shares:
  - name: shared
    path: "{{ nas_zfs_mountpoint }}/shared"
    valid_users: user3
      force_user:  user3
  - name: user1
    path: "{{ nas_zfs_mountpoint }}/user1"
    valid_users: user3
      force_user:  user3

O Samba roda SMB3 com suporte a multi-channel e I/O assíncrono. A propriedade ZFS xattr=sa guarda os atributos estendidos do Windows diretamente no inode, em vez de em arquivos ocultos com ponto, o que deixa os metadados visivelmente mais rápidos. 🎛️


🤖 Jenkins, GitLab & Pi-hole

O MicroServer faz um pouco mais do que só servir arquivos:

O Jenkins (porta 8090) roda dois jobs de backup noturnos — backups baseados em rsync de duas instâncias Nextcloud remotas (instance-a e instance-b). A chave SSH usada nessas conexões fica criptografada no Ansible Vault e é restaurada em /home/user3/.ssh/ a cada instalação nova. Uma reinstalação completa do SO não quebra a conectividade do backup.

O GitLab CE 19.1 (porta 80) serve como servidor Git local. Ter um GitLab on-prem para os projetos do homelab significa não depender de serviços externos. A role do Ansible cuida de toda a configuração pós-instalação pela API do GitLab: define a senha de root, cria um usuário padrão, cria um grupo homelab e um projeto www_k3s vazio — tudo idempotente.

O Pi-hole v6 (porta 8000 para a interface web, porta 53 para DNS) bloqueia anúncios no nível da rede. Ele está na porta 8000 em vez da padrão 80 porque o GitLab já mora lá. O DNS upstream é 8.8.8.8/8.8.4.4.

E como é um servidor HP: o HPE AMSD (Agentless Management Service) é instalado primeiro — antes de todo o resto. Sem ele, o BMC iLO não recebe dados de temperatura do SO e as ventoinhas giram a toda velocidade. Barulhento. Muito barulhento.


Tudo isso — NAS e servidores na internet — está a um comando ansible-playbook de ser reconstruído do zero:

👉 github.com/aptupgrademe/www_k3s

Próximo passo: reinstalar de fato o hp1 e rodar o playbook pela primeira vez num Debian 13 limpo. Volto para contar se o ZFS no Linux faz jus ao hype. 🤞

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