Atualização do Dovecot: Novidades na versão CE 2.4 e o ponto da situação do Dovecot 3

Dovecot 3: Compreender o estado das versões e o plano de desenvolvimento

Quem estiver a planear uma atualização do Dovecot não deve interpretar as designações das versões como uma garantia de uma futura versão principal. À data da pesquisa, 21 de outubro de 2026, o Dovecot CE 2.4.5 é a versão estável publicada no repositório oficial do Core. No entanto, não há qualquer indicação de uma versão 3.0 do Dovecot CE publicada nem de um roteiro oficial para a CE 3.0 nesse repositório.

Em particular, um título como „v2.4.5 para v2.4.6“ na documentação não indica que tenha sido lançada uma versão 2.4.6. Este tipo de conteúdo pode ajudar a identificar precocemente alterações no ramo de desenvolvimento. No entanto, não permite determinar quando, se ou de que forma essas alterações serão incorporadas num pacote estável. Isto aplica-se ainda mais às versões derivadas do Dovecot 3.

Para decisões no Alojamento de correio eletrónico Além disso, as vertentes do produto devem permanecer separadas. «Dovecot CE» refere-se à edição comunitária, enquanto o «Dovecot Pro» é uma oferta comercial distinta. Por conseguinte, uma funcionalidade, um modelo de funcionamento ou uma indicação na documentação não pode ser automaticamente transferida entre ambas. Os conteúdos do repositório «main» também devem ser distinguidos das versões CE publicadas; o fator determinante para uma atualização é a versão e a documentação que serão efetivamente utilizadas.

O que muda no modelo de versão do Dovecot 2.4

O Dovecot 2.4 distingue três níveis que, numa atualização, são frequentemente confundidos: a versão do programa instalada, dovecot_config_version e dovecot_storage_version. O pacote instalado determina qual o código que o servidor IMAP pode executar. Por outro lado, estas duas definições controlam deliberadamente a partir de que versão são utilizados valores predefinidos alterados ou novos formatos de armazenamento.

O Versão de configuração Impede assim que uma atualização do pacote ative automaticamente todas as novas predefinições. Os administradores podem, em primeiro lugar, atualizar o Dovecot para a versão 2.4 e, posteriormente, ajustar a semântica de configuração de forma seletiva, após terem verificado o início de sessão, o TLS, os plug-ins e as definições existentes. Isto reduz as surpresas decorrentes de alterações nos valores predefinidos, mas não substitui a migração necessária de uma configuração da versão 2.3.

O Versão em memória Por outro lado, diz respeito aos formatos de dados que o Dovecot cria nos seus índices ou noutras áreas de armazenamento. Um valor mais elevado pode ativar formatos que as versões mais antigas do Dovecot não reconhecem. Por isso, só deve ser definido quando já não fizer parte do plano de recuperação o regresso a uma versão anterior do programa. A reversão de um pacote, por si só, não restaura automaticamente os formatos de índice utilizados anteriormente.

Para uma migração da versão 2.3 para a 2.4, ambas as definições têm de estar presentes na configuração principal; dovecot_config_version nesse caso, a primeira configuração em dovecot.conf . Defina a versão de configuração para o nível pretendido apenas após a adaptação e verificação da sintaxe 2.4. A versão de memória permanece, inicialmente, no nível compatível até agora necessário e não é atualizada automaticamente para o nível do pacote.

O segundo passo, explicitamente indicado, é o Aprovação crítica para reversão novos formatos de armazenamento. Só quando todas as instâncias estiverem a utilizar a nova versão, já não estiver prevista a regressão a versões mais antigas do Dovecot e estiver disponível uma janela de manutenção agendada, é que se poderá dovecot_storage_version ser aumentado para o valor-alvo selecionado, por exemplo, para 2.4.5 para o formato de índice de threads aí documentado. As versões mais antigas podem recriar este índice no seu próprio formato; no entanto, isso implica trabalho adicional e uma transição entre formatos de índice que não são mutuamente compatíveis. Por conseguinte, esta indicação não constitui uma configuração padrão pronta a ser copiada: os valores inicial e final dependem da versão utilizada e do plano de contingência.

Esta abordagem por etapas assemelha-se ao princípio de avaliar separadamente o estado do programa e as mudanças de comportamento implementadas. Também no caso de outros componentes do servidor, um número de versão elevado não é suficiente para comprovar a compatibilidade; o artigo sobre Decisões relativas à atualização para o Redis 8 explica esta distinção no contexto de outro serviço. No caso do Dovecot, são também relevantes os formatos das caixas de correio, os dados de índice e a estratégia de recurso.

Novas funcionalidades e o seu grau de maturidade

Uma novidade relevante no Dovecot 2.4 é fts-flatcurve como backend local de pesquisa de texto completo baseado no Xapian. O controlador armazena os dados de pesquisa por caixa de correio no caminho do índice do Dovecot e requer o Xapian a partir da versão 1.4. Suporta a avaliação de relevância e também permite pesquisas por subcadeias de caracteres, mas não oferece pesquisa difusa. Sem um índice de texto completo, o Dovecot tem de pesquisar sequencialmente os dados das mensagens para efetuar as pesquisas correspondentes.

A pesquisa de subcadeias não está ativada automaticamente no Flatcurve: a predefinição documentada de fts_flatcurve_substring_search é no. Se for ativada deliberadamente para consultas de pesquisa IMAP adequadas, é necessário prever espaço de armazenamento adicional para o índice. O Flatcurve continua, assim, a ser uma opção para servidores IMAP em que a pesquisa de mensagens é utilizada regularmente, mas não constitui uma atualização obrigatória sem condições. O crescimento do índice, a monitorização e a reindexação fazem parte do planeamento operacional.

O SMTPUTF8 e o IMAP devem ser classificados de forma diferente UTF8=ACCEPT e IMAP4rev2. As informações sobre a versão indicam que estas funcionalidades são experimentais. SMTPUTF8 e UTF8=ACCEPT criar uma compilação com --enable-experimental-mail-utf8 e, em seguida, mail_utf8_extensions = yes na configuração. O IMAP4rev2 utiliza opções separadas: durante a compilação, --enable-experimental-imap4rev2 é necessário; depois, é preciso imap4rev2_enabled = yes ser configurado.

«Experimental» não significa, neste contexto, que a função seja, de um modo geral, inadequada. Significa, antes, que não se trata de um padrão geral aplicável a todas as ofertas de alojamento. Antes de a ativarem, os operadores devem verificar se os clientes de e-mail utilizados, toda a cadeia de entrega e os sistemas associados necessitam efetivamente do processamento UTF-8 ou IMAP4rev2 pretendido e se são capazes de o processar. Os testes devem ser realizados num ambiente que reproduza adequadamente a autenticação real, os nomes das caixas de correio e os perfis dos clientes.

Os mecanismos SCRAM, o TLS Channel Binding, bem como o processamento avançado de TLS-SNI e ALPN, merecem também uma avaliação separada. Estes não dizem respeito apenas ao processo do Dovecot, mas também à interação com clientes, certificados, proxies e fontes de autenticação. O critério relevante é uma necessidade clara com compatibilidade verificável, e não a mera disponibilidade de uma nova opção numa versão do Dovecot.

Preparar sistematicamente a atualização para a versão 2.4

A atualização do Dovecot 2.3 para a versão 2.4 começa com um levantamento da situação atual, e não com o gestor de pacotes. Registe a versão do programa instalada, a configuração em vigor e o formato da caixa de correio, como Maildir ou mdbox. Documente também as fontes de autenticação, as regras Sieve, as quotas, a pesquisa de texto completo, a replicação e os proxies a montante. Só assim será possível identificar quais os serviços e percursos de dados que são efetivamente afetados pela migração.

Os seguintes comandos são adequados para uma inventariação de leitura. Não alteram nem a configuração nem os dados de e-mail; no entanto, os seus resultados devem ser apresentados numa área de trabalho protegida, uma vez que podem permitir deduzir informações sobre o ambiente do servidor.

dovecot --version
doveconf -n

dovecot --version mostra o estado do programa. Com doveconf -n verifica a configuração ativa que difere dos valores padrão. A opção -v de doveadm por outro lado, não é uma consulta de versão, mas ativa uma saída mais detalhada, incluindo uma barra de progresso, e só se aplica a um subcomando correspondente. Trate a saída da configuração de forma confidencial: pode conter nomes de anfitriões, estruturas de diretórios, endereços de back-end ou outros detalhes da infraestrutura. Para a análise de erros, a documentação do Dovecot recomenda uma configuração reduzida em vez de um dump público completo.

Verifica também se a versão atual já é a última versão 2.3 disponível. O processo de migração documentado conduz, em primeiro lugar, a esta versão e só posteriormente à 2.4. Não transfira a configuração diretamente para um sistema de produção, mas sim para um sistema de teste com contas, autorizações e tamanhos de caixas de correio representativos. Tal como no caso de um Atualização do kernel para servidores de alojamento Também neste caso, o número da versão por si só não é suficiente: a configuração do pacote, os módulos ativados e a arquitetura determinam o efeito prático.

Planear a migração da versão 2.3 para a 2.4

A migração para a versão 2.4 constitui um passo de configuração específico. O Dovecot 2.4 requer uma sintaxe adaptada, bem como dovecot_config_version e dovecot_storage_version; a versão de configuração deve corresponder à primeira definição em dovecot.conf . Por isso, não transfira ficheiros antigos sem os alterar. Compare cada configuração utilizada com a documentação de migração específica da versão e valide-a no sistema de teste antes de planear uma janela de manutenção.

A tabela não apresenta alternativas. O Lua Director e o Replicator referem-se a tarefas diferentes: segundo a documentação, o Lua Director é apenas uma solução não suportada para pequenas implementações, enquanto que, no caso do Replicator, é mencionado um sistema de ficheiros partilhado como abordagem. doveadm sync é, por outro lado, o sucessor do que foi removido dsync-Links simbólicos e pode ser utilizado em processos de sincronização ou migração planeados de forma deliberada; no entanto, não constitui um substituto imediato e documentado para o Director ou o Replicator.

Também no que diz respeito à quota e à pesquisa, o conjunto de dados disponível é determinante. Compatibilidade Isto não significa apenas que o Dovecot seja iniciado: os alertas de quota, as ações Sieve, as pesquisas IMAP e os acessos de vários clientes têm de funcionar com contas de teste realistas. Para cada componente removido, registe onde está configurado, que dados utiliza e qual é o procedimento de reversão. Só depois disso é que se pode agendar de forma sensata a transição entre pacotes.

Avaliar de forma criteriosa os formatos de pesquisa e de armazenamento

No Dovecot 2.4, é possível desenvolver separadamente o estado do programa, o estado da configuração e o estado da memória. Aumentar dovecot_storage_version só quando já não estiver previsto o regresso a uma versão anterior do Dovecot. Com o Storage-Level 2.4.5, o índice de threads para o comando IMAP THREAD um novo formato v2. Os índices de threads existentes serão reconstruídos na próxima operação de threading; especialmente no caso de caixas de correio de grande dimensão, a primeira consulta pode, por isso, implicar um esforço adicional.

Uma versão mais antiga do Dovecot não reconhece este formato de índice de threads e volta a gerar o índice no formato antigo. O Nível de armazenamento Trata-se, portanto, de uma decisão operacional e não de uma mera alteração cosmética da versão. Planeie eventuais reestruturações do índice num intervalo de tempo monitorizado e não o aumente em simultâneo com outras alterações difíceis de reverter na pesquisa, na memória ou na topologia do proxy.

No que diz respeito aos índices de pesquisa locais, fts-flatcurve uma opção, caso o ambiente disponha do Xapian 1.4 ou mais recente. O controlador armazena os dados de índice por caixa de correio no caminho de índice do Dovecot e suporta a classificação por relevância. As pesquisas por subcadeias podem ser ativadas e são realizadas com fts_flatcurve_substring_search = no No entanto, estão desativadas por predefinição e, quando ativadas, requerem uma quantidade significativa de memória de índice adicional. O Flatcurve não suporta a pesquisa difusa.

Por isso, avalia a Arquitetura de pesquisa com base no tamanho das caixas de correio, no tipo de armazenamento e no modelo de funcionamento, em vez de uma classificação genérica. doveadm fts flatcurve stats fornece dados de estado armazenados relativos aos índices Flatcurve. É importante distinguir isto de doveadm fts flatcurve check: Este comando verifica as bases de dados Xapian e tenta corrigir erros básicos, pelo que pode alterar o seu estado. A rotação e a remoção de índices são também medidas de manutenção específicas. Antes de realizar estas intervenções, planeia o âmbito, as caixas de correio afetadas e a eventual reconstrução dos índices.

Verificar filtros, proxies e limites de segurança

Os filtros Sieve constituem um ponto de verificação específico na atualização do Dovecot, uma vez que esta extensão não está integrada no núcleo do Dovecot: o Sieve e o ManageSieve são fornecidos pelo projeto independente Pigeonhole. Em instalações compiladas pelo próprio utilizador, o Pigeonhole tem de ser recompilado juntamente com a nova versão do Dovecot. Caso contrário, o plugin do interpretador não poderá ser carregado devido a um conflito de versões.

Nas instalações baseadas em distribuições, é, em vez disso, fundamental que os pacotes do Dovecot e do Pigeonhole provenham de fontes de pacotes compatíveis entre si. Verifique, antes do período de manutenção, quais os scripts de utilizador ativos, os scripts globais e os acessos ao ManageSieve existentes. Após a atualização, a entrega, o redirecionamento, as respostas de férias e uma alteração através do ManageSieve devem ser verificados utilizando uma conta de teste destinada a esse fim; os filtros em produção não substituem este teste.

Nas arquiteturas de proxy, a Compressão IMAP atenção especial. Quando a versão de configuração for atualizada para a 2.4.5, o padrão para imap_compress_on_proxy yes. O processamento da compressão passa, assim, a ser feito pelo proxy; de acordo com a documentação, esta configuração deve ser definida no backend. É necessário que estejam corretamente definidos login_trusted_networks bem como limites de confiança claramente definidos entre o proxy e o backend.

Por isso, antes de adotar a nova configuração padrão, esclareça o seguinte: quais as ligações que terminam no proxy, quais as moradas IP que o backend pode considerar fiáveis e em que sistema é que a carga da CPU e o tráfego de dados resultantes da compressão devem ocorrer? Uma alteração só pode ser avaliada de forma sensata se estas questões se coadunarem com a arquitetura de rede efetiva. Não substitui nem uma verificação TLS nem um controlo de acesso robusto entre os sistemas envolvidos.

Também as novas funcionalidades de autenticação e os protocolos experimentais não devem ser ativados de forma generalizada. As informações sobre a versão mencionam mecanismos SCRAM, incluindo o TLS Channel Binding, bem como SMTPUTF8, IMAP UTF8=ACCEPT e IMAP4rev2. SMTPUTF8 e UTF8=ACCEPT são necessários durante a compilação --enable-experimental-mail-utf8 e na configuração mail_utf8_extensions = yes. Independentemente disso, o IMAP4rev2 define o parâmetro de compilação --enable-experimental-imap4rev2 e imap4rev2_enabled = yes antes. Verifica a compatibilidade com os clientes, a cadeia de entrega e o comportamento em caso de falha para cada função individualmente, antes de a implementares no Alojamento de correio eletrónico ofereces.

Utilizar em segurança após a atualização

Uma atualização só está concluída após verificações técnicas, e não logo após a execução bem-sucedida do pacote. Durante a janela de manutenção, verifica primeiro se o serviço arranca e se os registos apresentam erros de configuração, de plug-ins ou de autorizações. Em seguida, efetua o início de sessão e acede à caixa de correio com uma conta de teste. Verifique, pelo menos, a lista de pastas, a seleção de mensagens, a leitura e uma entrega controlada, para garantir que o servidor IMAP não só está acessível, como também está operacional.

Valide os filtros e as quotas como funções separadas. Uma ligação IMAP bem-sucedida não comprova que o Pigeonhole tenha sido carregado, nem que os limites de quota sejam determinados corretamente. Por isso, teste uma regra de filtragem inofensiva e uma entrega próxima de um limite de quota previsto numa caixa de correio de teste isolada. Desta forma, é possível detetar erros em plug-ins, autorizações e na ligação ao respetivo backend de quotas, sem sobrecarregar intencionalmente as caixas de correio dos clientes.

Quando a pesquisa de texto completo está ativada, a monitorização do estado do índice e das consultas de pesquisa deve ser realizada na fase de acompanhamento. Para obter uma visão geral dos dados existentes no índice Flatcurve, serve doveadm fts flatcurve stats. O subcomando check Deve ser claramente distinguido: verifica as bases de dados Xapian e tenta corrigir erros básicos, não sendo, portanto, um diagnóstico garantidamente apenas de leitura. Utilize-o, tal como a rotação ou a remoção de índices, apenas como medida de manutenção planeada para caixas de correio específicas e tenha em conta possíveis alterações de estado, bem como uma nova criação de índices.

No caso de proxies a montante, controlas também todo o Via de tráfego: Quando o pedido de início de sessão chega ao backend esperado, o IP do cliente e a rede de confiança são tratados corretamente e não surgem problemas inesperados de compressão ou TLS? Para verificar isso, compare cronologicamente os registos dos componentes envolvidos. Logins individuais bem-sucedidos não são suficientes quando estão envolvidos vários back-ends, redes de clientes diferentes ou terminação TLS separada.

Para a resolução de problemas, a documentação do Dovecot recomenda uma configuração reduzida. Para tal, num ambiente seguro, reduza gradualmente os componentes até identificar aqueles que reproduzem o erro, em vez de publicar toda a configuração de produção. Aviso: Informações como a configuração efetiva podem conter detalhes da infraestrutura ou dados sensíveis. Por isso, não as partilhe na íntegra em tickets, fóruns ou documentos públicos; em vez disso, edite-as de forma seletiva.

Quando vale a pena atualizar o Dovecot

A atualização do Dovecot para a versão CE 2.4.5 não é apenas uma decisão relacionada com funcionalidades e arquitetura. As notas de lançamento enumeram inúmeras correções de segurança críticas que dizem respeito, entre outros aspetos, a comandos IMAP, Submission, verificações OAuth, dsync, autenticação e compressão. Os administradores devem, por isso, verificar atempadamente se a sua instalação está afetada e através de que versão de pacote ou backport a distribuição utilizada disponibiliza as correções. A partir da versão upstream, por si só, não se pode concluir que um pacote da distribuição não esteja corrigido, nem que uma atualização imediata genérica, sem verificação de migração, seja segura.

Para além desta avaliação de segurança, uma atualização justifica-se quando está motivada por uma necessidade de compatibilidade, um requisito operacional concreto ou uma modernização que possa ser testada de forma compreensível. Isso pode incluir os controladores de versão verificáveis para a configuração e a memória. No entanto, o estado do pacote, por si só, não é um critério suficiente para a decisão: o formato da caixa de correio, a autenticação, a quota, o Sieve, a pesquisa e a topologia do proxy determinam qual é, de facto, o volume de trabalho envolvido na migração.

A priorização da instalação da versão 2.3 justifica-se especialmente quando a situação de segurança e a versão disponível da distribuição sugerem uma atualização e a migração pode ser testada num sistema de teste. No entanto, no que diz respeito ao armazenamento, mantém-se deliberadamente uma abordagem cautelosa: os novos formatos de armazenamento só devem ser ativados quando já não for possível regressar a versões mais antigas do Dovecot. Isto diz respeito, entre outros aspetos, ao índice de threads alterado na versão 2.4.5, cuja reconstrução ocorre na próxima consulta de threading.

As funcionalidades adicionais são decisões arquitetónicas distintas. Flatcurve É aconselhável avaliar esta opção se a pesquisa de notícias for utilizada regularmente e se o armazenamento local do índice, a dependência do Xapian, a monitorização e a reindexação se enquadrarem no modelo operacional. A documentação classifica o controlador como um índice de pesquisa de texto completo local baseado no Xapian; daí não decorre qualquer recomendação generalizada em detrimento do Solr ou da renúncia à pesquisa de texto completo (FTS).

As opções experimentais UTF8 e IMAP4rev2 só se justificam se houver uma necessidade comprovada ao longo de toda a cadeia, desde o cliente de e-mail, passando pela submissão ou entrega, até ao acesso IMAP. Sem esta condição prévia, a sua ativação aumenta sobretudo o esforço de verificação. O mesmo se aplica aos novos mecanismos de autenticação: uma funcionalidade já existente na versão não substitui a verificação dos clientes utilizados, da configuração TLS e da fonte de autenticação.

No que diz respeito ao Dovecot 3, com base nas informações publicadas sobre a CE, não é possível confirmar nem uma data, nem um conjunto de funcionalidades, nem um plano de migração. A versão estável confirmada é a CE 2.4.5; as referências na documentação de desenvolvimento ou no ramo main não constituem uma versão publicada do produto nem um roteiro de desenvolvimento. Por isso, planeia com base na versão 2.4 que está efetivamente disponível, separa-a do Dovecot Pro e só avalia os anúncios posteriores quando forem publicados oficialmente.