secure-os.org
Todos os guiasQubes OSTailsWhonixLinux reforçadoEncriptação de discoModelo de ameaça
Black FridayProton VPN Plus até 75 % de desconto: 2,49 $ por mês, 59,76 $ nos primeiros 24 meses (lido em 20 nov.). Reembolso em 30 dias.Ver a oferta do Proton VPN →(link de afiliado)
ubuntu

Unattended-upgrades no Ubuntu: o que a configuração predefinida instala e o que deixa de fora

secure-os· Atualizado 7 de outubro de 2026· 10 min de leitura #ubuntu#updates#hardening#linux#apt
Duas mãos com mangas azul-escuras a encaixar uma placa de circuito verde, com uma fila de portas de rede, num chassis de equipamento laranja e branco

«As atualizações de segurança automáticas estão ativadas» é a frase com que terminam muitas auditorias de servidores. É verdadeira na maioria das máquinas Ubuntu, e descreve menos do que parece. O pacote que faz o trabalho, unattended-upgrades, é distribuído com um ficheiro de configuração cujos comentários dizem com precisão o que está ligado, o que está desligado e o que nunca fez parte do âmbito.

Este guia lê esse ficheiro tal como o projeto original o publica, opção a opção, e mostra como verificar cada ponto na sua própria máquina.

A resposta curta

Com a configuração de origem, o unattended-upgrades:

  • instala pacotes do pocket principal da versão e do pocket -security, além dos pockets de segurança ESM quando estão disponíveis no sistema;
  • não instala nada a partir de -updates, -proposed nem -backports, que estão comentados;
  • não reinicia, porque Automatic-Reboot é false por predefinição;
  • não avisa ninguém, porque Unattended-Upgrade::Mail é uma cadeia vazia por predefinição;
  • não toca nos repositórios de terceiros, porque só as origens listadas são permitidas.

Cada um destes valores é uma escolha deliberada, e cada um muda-se com cerca de três linhas.

Dois ficheiros, duas funções

O comportamento divide-se por dois ficheiros em /etc/apt/apt.conf.d/.

20auto-upgrades é o interruptor. Tal como o projeto o fornece, contém exatamente duas linhas:

APT::Periodic::Update-Package-Lists "1";
APT::Periodic::Unattended-Upgrade "1";

O README do projeto descreve o seu significado sem rodeios: o sistema verifica se há atualizações todos os dias e instala-as, se for possível. Ponha qualquer um dos dois valores a "0" e o passo correspondente pára.

50unattended-upgrades é a política: que pacotes são elegíveis e o que acontece depois de instalados. Tudo o que se segue vem deste segundo ficheiro.

Para ver os valores que a sua máquina aplica de facto, depois de fundidos todos os fragmentos, o README remete para um comando:

apt-config dump | grep -E 'Periodic|Unattended'

O que as «origens permitidas» permitem realmente

O núcleo da política é uma lista. Na variante Ubuntu do ficheiro, lê-se assim:

Unattended-Upgrade::Allowed-Origins {
	"${distro_id}:${distro_codename}";
	"${distro_id}:${distro_codename}-security";
	"${distro_id}ESMApps:${distro_codename}-apps-security";
	"${distro_id}ESM:${distro_codename}-infra-security";
//	"${distro_id}:${distro_codename}-updates";
//	"${distro_id}:${distro_codename}-proposed";
//	"${distro_id}:${distro_codename}-backports";
};

(As duas linhas ESM com legacy-security foram omitidas aqui por brevidade.) As linhas que começam por // são comentários, pelo que -updates não é uma origem permitida. Uma correção que chega à sua versão apenas através do pocket -updates fica à espera de um apt upgrade manual.

O comentário por cima da lista explica porque é que o pocket principal lá está: no Ubuntu, as atualizações de segurança podem arrastar novas dependências de fontes que não são de segurança (o exemplo citado é o chromium), e permitir o pocket principal faz com que sejam instaladas automaticamente.

O README acrescenta uma regra com mais consequências do que aparenta: a ferramenta não instala pacotes cujas dependências não possam ser obtidas a partir de origens permitidas. Uma atualização de segurança cuja dependência vive num pocket que não permitiu fica retida, sem qualquer erro no ecrã.

Os repositórios de terceiros estão fora da lista

O repositório do Docker, um PPA, a fonte apt de um fornecedor: nenhum corresponde a ${distro_id}:${distro_codename}-security, por isso nenhum é atualizado automaticamente. O software instalado a partir dessas fontes fica na versão que instalou à mão da última vez.

O README documenta a solução. Cada repositório tem uma origem e um arquivo, visíveis nos campos o= e a= de:

apt-cache policy

Acrescente o par que lá encontrar ao seu próprio ficheiro de substituição (ver mais abaixo), em vez de o adivinhar. O README documenta também Origins-Pattern, que compara padrões de tipo glob como "site=www.example.com,component=main".

Um corredor de um centro de dados com chão de betão polido, ladeado por altos bastidores pretos com portas em rede que deixam ver cabos azuis e vermelhos, e ao fundo um carrinho com rodas que transporta um monitor.

O reinício que ninguém agendou

Esta é a lacuna com maiores consequências. O ficheiro diz:

// Automatically reboot *WITHOUT CONFIRMATION* if
//  the file /var/run/reboot-required is found after the upgrade
//Unattended-Upgrade::Automatic-Reboot "false";

O valor predefinido é false. Quando uma atualização precisa de um reinício para produzir efeito, é criado o ficheiro marcador /var/run/reboot-required e não acontece mais nada. O pacote do kernel corrigido fica instalado enquanto o kernel antigo continua a correr: a correção está no disco, não na memória. A frase da auditoria, «as atualizações de segurança são automáticas», continua verdadeira durante todo esse tempo.

Verifique qualquer máquina numa linha:

test -f /var/run/reboot-required && echo "reboot pending"

Se quiser que a máquina reinicie sozinha, o ficheiro oferece duas definições que andam juntas:

Unattended-Upgrade::Automatic-Reboot "true";
Unattended-Upgrade::Automatic-Reboot-Time "02:00";

Sem a segunda, o valor predefinido é "now", ou seja, imediatamente após a atualização. Note também que Automatic-Reboot-WithUsers é true por predefinição: utilizadores com sessão iniciada não impedem o reinício, a menos que o ponha a false.

Numa máquina que não pode reiniciar sem supervisão (um servidor primário de base de dados, um anfitrião com volume raiz cifrado que pede uma frase-passe no arranque), deixe o reinício desligado e resolva a outra metade do problema: tornar visível o reinício pendente.

O silêncio é a predefinição

Unattended-Upgrade::Mail vem vazio, e o ficheiro é explícito quanto à consequência: se o valor estiver vazio ou não definido, não é enviado qualquer e-mail. Enuncia também o pré-requisito: uma configuração de correio funcional, com um pacote que forneça mailx.

MailReport aceita três valores: "always", "only-on-error" e "on-change". Num servidor isolado, "on-change" deixa-lhe registo de cada pacote que se moveu. Numa frota, "only-on-error" mantém a caixa de entrada legível.

Se o correio não for opção, existe um segundo canal. SyslogEnable é false por predefinição. Ponha-o a true e os eventos seguem para o syslog, o que o README considera útil em ambientes onde as mensagens de syslog são enviadas para um armazenamento central.

Onde procurar quando parece que nada acontece

O README indica o local: todas as operações são registadas em /var/log/unattended-upgrades/, incluindo a saída do dpkg. O ficheiro principal é /var/log/unattended-upgrades/unattended-upgrades.log.

Para saber o que a próxima execução faria sem alterar nada, use o comando que o projeto recomenda para depuração:

sudo unattended-upgrade --debug --dry-run

A saída lista as origens permitidas tal como a ferramenta as entendeu, e depois cada pacote candidato com o motivo por que foi aceite ou ignorado. É a forma mais rápida de confirmar que um repositório que acrescentou é realmente reconhecido.

Três causas de um pacote que ficou por atualizar estão escritas na própria documentação do projeto:

  1. A origem não é permitida. Ver a lista acima.
  2. Uma dependência vem de uma origem não permitida. O pacote fica retido.
  3. O pacote faria uma pergunta sobre um ficheiro de configuração. O README precisa que a ferramenta verifica os pedidos relativos a ficheiros de configuração antes da instalação e retém qualquer pacote que os exija.

Quando é executado

O agendamento não está nos ficheiros do unattended-upgrades. Vem de dois temporizadores systemd fornecidos pelo apt. Na árvore de código-fonte do apt, consultada no dia em que este artigo foi escrito, apt-daily.timer dispara às 6,18:00 com RandomizedDelaySec=12h e trata das transferências, enquanto apt-daily-upgrade.timer dispara às 6:00 com RandomizedDelaySec=60m e trata da instalação.

Ambos têm Persistent=true. A documentação do systemd define esta opção: o serviço é acionado de imediato se devesse ter sido acionado pelo menos uma vez enquanto o temporizador esteve inativo, o que apresenta como útil para recuperar execuções falhadas quando o sistema esteve desligado. Um portátil que esteve suspenso durante a sua janela atualiza-se, portanto, pouco depois de acordar.

A sua distribuição pode fornecer outros valores. Leia os seus:

systemctl cat apt-daily-upgrade.timer
systemctl list-timers 'apt-daily*'

Porque é que o encerramento por vezes espera

Se um encerramento ficar parado por um momento enquanto decorre uma atualização, é o comportamento previsto. O comentário de MinimalSteps explica que a atualização é dividida nos passos mais pequenos possíveis para poder ser interrompida com SIGTERM, e que isso torna possível encerrar durante uma atualização com um pequeno atraso. O ficheiro nota ainda que o unattended-upgrades aumenta o InhibitDelayMaxSec do logind para 30 segundos com esse fim.

Cortar a energia nesse momento é a pior resposta. Se acontecer mesmo assim, AutoFixInterruptedDpkg, true por predefinição, corre dpkg --force-confold --configure -a na execução seguinte para concluir o trabalho interrompido.

Alterar sem editar o ficheiro distribuído

O README é direto neste ponto: a substituição deve ser feita num fragmento de configuração do APT separado, porque as atualizações do ficheiro distribuído podem entrar em conflito com as alterações locais e bloquear a atualização do próprio unattended-upgrades. O novo ficheiro tem de ficar ordenado depois de 50unattended-upgrades, e o README sugere o nome 52unattended-upgrades-local.

Um ponto de partida razoável para um servidor isolado, construído apenas com opções documentadas:

// /etc/apt/apt.conf.d/52unattended-upgrades-local
Unattended-Upgrade::Mail "you@example.com";
Unattended-Upgrade::MailReport "on-change";
Unattended-Upgrade::Automatic-Reboot "true";
Unattended-Upgrade::Automatic-Reboot-Time "02:00";
Unattended-Upgrade::Remove-Unused-Kernel-Packages "true";

Há uma armadilha que diz respeito às listas. O README avisa que, para substituir uma lista como Origins-Pattern, é preciso primeiro limpar a lista de origem com uma diretiva #clear antes de inserir a sua. Caso contrário, as suas entradas são permitidas além das de origem, e não no lugar delas.

Para manter um pacote fora das atualizações automáticas, Package-Blacklist aceita expressões regulares Python. O exemplo do ficheiro mostra o erro clássico: sem o $ final, "libc6" corresponde a todos os pacotes cujo nome começa por esses caracteres. O README acrescenta um efeito secundário que convém conhecer: se o pacote A depender do pacote B que está na lista negra, nem A nem B são atualizados.

Desligá-lo, e porque raramente é a decisão certa

A via suportada é a que o README indica:

sudo dpkg-reconfigure -plow unattended-upgrades

O comando define os dois valores periódicos por si. Há razões legítimas para o fazer: um sistema de produção sujeito a controlo de alterações, onde cada movimento de pacotes é planeado, ou um anfitrião gerido por uma ferramenta de configuração que aplica ela própria as atualizações.

Em qualquer outra máquina, desligar o mecanismo troca um risco pequeno e limitado (uma atualização que se porta mal) por um risco sem limite (uma vulnerabilidade conhecida que fica aberta até alguém se lembrar). As ferramentas mais finas costumam bastar: pôr na lista negra o único pacote que o preocupa, ou limitar as execuções a certos dias com Update-Days, que aceita valores como {"Mon";"Fri"}.

Uma auditoria de cinco minutos

Execute estes comandos num servidor que julga que «se atualiza sozinho»:

  1. apt-config dump | grep -E 'Periodic|Unattended': os dois valores periódicos estão a "1", e que origens são permitidas?
  2. apt-cache policy: que repositórios existem nesta máquina sem estarem cobertos pela lista permitida?
  3. test -f /var/run/reboot-required && echo pending: há um reinício pendente?
  4. tail -n 50 /var/log/unattended-upgrades/unattended-upgrades.log: quando foi a última execução e o que fez?
  5. sudo unattended-upgrade --debug --dry-run: o que faria a próxima execução e o que reteria?

Se as respostas forem «sim, nenhum, não, esta noite, nada retido», a frase da auditoria está finalmente exata.

Os nomes das opções, os valores predefinidos e os comentários referidos vêm dos ficheiros 50unattended-upgrades.Ubuntu e 20auto-upgrades e do README do repositório original do unattended-upgrades. Os valores dos temporizadores vêm da árvore de código-fonte do apt, e a definição de Persistent= do manual systemd.timer. Todos foram lidos a 7 de outubro de 2026. As versões empacotadas diferem entre versões do Ubuntu, pelo que o ficheiro na sua própria máquina é a referência final.

A aplicação automática de correções é uma camada entre várias: a visão de conjunto está no guia de hardening de Linux, e os controlos ao nível do serviço são tratados em hardening de serviços systemd.