Boas Práticas de Limpeza do /tmp - tmpfiles.d e systemd-tmpfiles

2026-06-01 Tempo de leitura: Cerca de 10 min Dificuldade: Intermediário+

O Que Você Vai Aprender

• Como /tmp, /var/tmp e /run são gerenciados pelo systemd
• Como escrever regras tmpfiles.d para limpeza personalizada
• Como executar systemd-tmpfiles manualmente e de forma agendada

Por Que o /tmp Precisa de Limpeza?

/tmp é onde as aplicações gravam arquivos temporários. Dependendo da versão, ele é um tmpfs em RAM (limpo na reinicialização) ou um diretório em disco. Servidores de longa duração, porém, acumulam arquivos temporários entre reinicializações, o que pode esgotar o espaço em disco e causar referências obsoletas de arquivos PID ou socket.

• Usos típicos: arquivos intermediários de compressão, dados de sessão, arquivos socket
• O que está por trás do /tmp depende da versão: um tmpfs em RAM ou um diretório no sistema de arquivos raiz (disco) - veja a tabela abaixo
• /var/tmp: persiste entre reinicializações por design - requer gerenciamento explícito

Verifique o que está por trás do /tmp no seu sistema

$ findmnt /tmp
TARGET SOURCE FSTYPE OPTIONS
/tmp   tmpfs  tmpfs  rw,nosuid,nodev,size=4011076k,nr_inodes=1048576,inode64

Se FSTYPE for tmpfs, o /tmp fica em RAM. Se o comando não exibir nada (código de saída 1), o /tmp não é uma montagem separada - é um diretório comum no sistema de arquivos raiz. O df -h /tmp também mostra em qual sistema de arquivos o /tmp está e quanto espaço está livre.

$ df -h /tmp
Filesystem      Size  Used Avail Use% Mounted on
tmpfs           3.9G   12K  3.9G   1% /tmp

Se Mounted on mostrar /, o /tmp está no sistema de arquivos raiz (disco).

Padrão do Ubuntu por versão

A partir do Ubuntu 24.10, o tmp.mount padrão do systemd passou a vir habilitado, o que torna o /tmp um tmpfs. As notas de versão do 26.04 LTS listam essa mudança entre as alterações desde o 24.04 LTS. (Fonte: Ubuntu 24.10 release notes, Ubuntu 26.04 LTS summary for LTS users, consultado em 2026-09-25)

Um /tmp em disco, como no 22.04 LTS e no 24.04 LTS, também não mantém o conteúdo entre reinicializações. O /usr/lib/tmpfiles.d/tmp.conf do Ubuntu declara o /tmp com o tipo D (D /tmp 1777 root root - no 22.04, D /tmp 1777 root root 30d no 24.04), e na inicialização o systemd-tmpfiles-setup.service é executado com --remove --boot, o que esvazia o /tmp. Coloque em /var/tmp os arquivos que precisam sobreviver a uma reinicialização. (Fonte: patch do tmp.conf no pacote systemd do Ubuntu para o 22.04 / 24.04, systemd-tmpfiles-setup.service (24.04), consultado em 2026-09-25)

O Que É o systemd-tmpfiles?

systemd-tmpfiles é a ferramenta declarativa para gerenciar diretórios temporários - criando-os no boot, definindo permissões e excluindo arquivos obsoletos de forma agendada.

Três modos de operação:

$ sudo systemd-tmpfiles --create
$ sudo systemd-tmpfiles --clean
$ sudo systemd-tmpfiles --remove

Duas unidades systemd executam isso automaticamente:

• systemd-tmpfiles-setup.service - executa --create no boot
• systemd-tmpfiles-clean.timer - executa --clean periodicamente (padrão: 15 min após o boot, depois diariamente)

Como Escrever Regras tmpfiles.d

Coloque arquivos de configuração em /etc/tmpfiles.d/. Os padrões do sistema ficam em /usr/lib/tmpfiles.d/ - nunca edite esses diretamente, pois atualizações de pacotes os sobrescrevem.

Formato

tipo caminho modo uid gid idade argumento

Tipos Comuns

Como Executar a Limpeza Periódica

Verifique o timer de limpeza:

$ systemctl status systemd-tmpfiles-clean.timer

● systemd-tmpfiles-clean.timer - Daily Cleanup of Temporary Directories
     Loaded: loaded (/lib/systemd/system/systemd-tmpfiles-clean.timer; static)
     Active: active (waiting) since Mon 2024-01-01 00:00:00 UTC; 3h ago
    Trigger: Tue 2024-01-02 00:15:30 UTC; 20h left

Acionar uma limpeza imediata:

$ sudo systemctl start systemd-tmpfiles-clean

Exemplos Práticos

Exemplo 1: Diretório temporário por aplicação com limpeza automática

# /etc/tmpfiles.d/myapp.conf
d /tmp/myapp 0750 myapp myapp 1d

Cria /tmp/myapp de propriedade de myapp:myapp com modo 0750, e exclui arquivos internos mais antigos que 1 dia.

Exemplo 2: Limpar logs da aplicação em /var/tmp após 7 dias

# /etc/tmpfiles.d/clean-var-tmp.conf
d /var/tmp/app-logs 0755 root root 7d

Exemplo 3: Criar diretório /run no boot sem exclusão automática

# /etc/tmpfiles.d/myapp-run.conf
d /run/myapp 0755 myapp myapp -

Idade - significa: criar no boot, nunca excluir automaticamente.

Exemplo 4: Excluir um caminho da limpeza

# /etc/tmpfiles.d/exclude.conf
x /tmp/persistent-cache

--clean ignora /tmp/persistent-cache independentemente da idade.

Aplicar e verificar regras imediatamente

# Aplicar regras de criacao agora
$ sudo systemd-tmpfiles --create /etc/tmpfiles.d/myapp.conf

# Dry run: visualizar o que --clean excluiria
$ sudo systemd-tmpfiles --clean --dry-run /etc/tmpfiles.d/myapp.conf

Problemas Comuns

Arquivos não estão sendo excluídos

Verifique se o campo de idade não é -. Note também que --clean usa o atime (último tempo de acesso) como limite, não o mtime.

$ stat /tmp/myfile | grep Access

Regras não estão tendo efeito

Valide a configuração diretamente:

$ sudo systemd-tmpfiles --create /etc/tmpfiles.d/myapp.conf

Verifique o journal em busca de erros:

$ journalctl -u systemd-tmpfiles-setup

Sobrescrever uma regra do sistema em /usr/lib/tmpfiles.d/

Coloque um arquivo com o mesmo nome em /etc/tmpfiles.d/ - ele tem prioridade. Ordem de carregamento: /etc > /run > /usr/lib.

# Visualizar a regra do sistema
$ cat /usr/lib/tmpfiles.d/tmp.conf

# Criar sua sobreposicao e edita-la
$ sudo cp /usr/lib/tmpfiles.d/tmp.conf /etc/tmpfiles.d/tmp.conf