Tutorial do Debian 13 / Configurar repositórios deb822 e verificar assinaturas com Signed-By
O Debian 13 armazena definições de repositório do Advanced Package Tool (APT) em /etc/apt/sources.list e em arquivos sob /etc/apt/sources.list.d. Um arquivo .sources deb822 agrupa cada definição de repositório em campos nomeados. Ao converter uma configuração existente, preserve seus endereços, ramos da distribuição, componentes e chaves autorizadas a verificar as assinaturas, desative as entradas duplicadas antigas, depois atualize as listas e compare as versões candidatas dos pacotes.
Inspecione o formato atual dos repositórios
Use a VM do Debian 13 do laboratório de instalação e remoção de pacotes APT. Definições de repositório controlam tanto as fontes de pacotes quanto a confiança. Não cole repositórios do Ubuntu ou a configuração de outra versão do Debian.
cat /etc/os-release
ls -l /etc/apt/sources.list
find /etc/apt/sources.list.d -maxdepth 1 -type f -print
cat /etc/apt/sources.list
apt-cache policy bash
Se um arquivo .sources já existir, leia o arquivo para verificar repositórios válidos. Em ambientes onde endereços de repositório privados incluem informações de autenticação, não compartilhe o arquivo completo externamente. É possível ter uma configuração sem /etc/apt/sources.list, então não presuma que não existem repositórios apenas porque o arquivo está ausente.
O registro do curso original corresponde a Debian 13.7 com APT 3.0.3. O instalador criou entradas de uma linha deb e deb-src em sources.list, e sources.list.d estava vazio. O procedimento de conversão descrito aqui tem como alvo esse estado. Se uma configuração deb822 adequada já existir, não crie um novo arquivo duplicado e, em vez disso, revise os campos do arquivo atual.
Leia os campos deb822 e os componentes do repositório
deb822 é um formato que escreve um repositório como um conjunto de nomes de campos e valores. Um conjunto é separado por uma linha em branco. Como não é YAML nem um script shell, você não executa um arquivo .sources com bash. manual do sources.list explica tanto o formato de linha única do .list quanto o formato deb822 do .sources.
| Campos | Funções | Exemplo de Seleção |
|---|---|---|
| Types | Tipos de Listas de Pacotes Binários e de Código-Fonte | deb solicita índices de pacotes binários; deb-src solicita índices de pacotes de código-fonte. |
| URIs | Endereço Base do Repositório | Distingue entre arquivos gerais e repositórios de segurança. |
| Suites | Ramo de Lançamento/Atualização | Usa trixie, trixie-updates, trixie-security. |
| Components | Área de arquivo para consulta | Mantém o main existente e o non-free-firmware. |
| Signed-By | Conjunto de chaves (keyring) a usar para verificar este repositório | Caminho absoluto do conjunto instalado de chaves do arquivo Debian. |
Separe múltiplos valores de campo com espaços, não com vírgulas. Por exemplo, os dois valores de Suites compartilham um campo separado por espaço. Adicionar Enabled: no desativa toda a seção em um arquivo .sources, incluindo todas as suítes que ela define. Remova esse campo ou altere para yes para reativar a seção. Revise todas as definições ativas para que o repositório de segurança não seja acidentalmente deixado desativado.
Para manter o Debian 13, uma configuração que especifica o codinome trixie deixa a intenção clara, em vez de usar um nome em movimento como stable. Mesmo após um novo Debian se tornar estável, trixie ainda se refere à mesma versão. trixie-updates é o ramo de atualizações da versão estável, e trixie-security é o ramo de atualizações de segurança. A mudança do codinome está ligada ao plano de atualização da distribuição, portanto, não o altere arbitrariamente para evitar erros nos repositórios.
| Área | Critérios de Classificação | Confirmar quando selecionado |
|---|---|---|
| main | A área desta distribuição que cumpre as diretrizes de software livre do Debian (Debian Free Software Guidelines, DFSG) | O núcleo da configuração padrão do pacote. |
| contrib | Uma área onde o próprio software cumpre as diretrizes de software livre, mas pode depender de componentes fora de main | Verifique os programas e dependências necessárias. |
| non-free | Software que não cumpre as diretrizes de software livre | Verifique a licença e as políticas da organização. |
| non-free-firmware | Área separadamente isolada de firmware não-livre | Verifique o firmware necessário para o dispositivo e as condições de distribuição. |
A base para distinguir a área pode ser encontrada na descrição das áreas do repositório na política Debian. Só porque o firmware é necessário, não significa que todas as áreas não-livres devem ser adicionadas automaticamente. Este exemplo mantém a seleção existente do instalador como está.
Salve as definições e registre uma versão candidata
O diretório de backup não deve já existir. Se existir, escolha um nome novo e ajuste todos os caminhos de recuperação de forma consistente. Execute a primeira linha separadamente e continue somente se ela tiver sucesso; também interrompa se a cópia ou qualquer verificação do arquivo de destino falhar. Não prossiga para a edição sem um backup utilizável.
sudo test ! -e /var/backups/lf-debian13-10 && sudo install -d -m 700 /var/backups/lf-debian13-10
sudo cp -a /etc/apt/sources.list /etc/apt/sources.list.d /var/backups/lf-debian13-10/
apt-cache policy bash | sudo tee /var/backups/lf-debian13-10/bash-policy-before.txt
sudo test ! -e /etc/apt/sources.list.d/debian.sources
ls -l /usr/share/keyrings/debian-archive-keyring.gpg
sudo -u _apt test -r /usr/share/keyrings/debian-archive-keyring.gpg && printf 'APT account can read the keyring\n'
Se o arquivo debian.sources já existir, não o sobrescreva. O keyring é fornecido pelo pacote debian-archive-keyring, e nesta VM o caminho .gpg era um link apontando para um arquivo .pgp. O importante é se o keyring público especificado pode realmente ser lido pela conta _apt. Se o arquivo de chave estiver ausente ou corrompido, não contorne o problema importando uma chave não verificada; em vez disso, verifique os pacotes apropriados e os materiais de recuperação.
O registro da versão candidata do pacote bash permite identificar uma mudança involuntária na seleção causada pela conversão. Mesmo que um pacote seja o mesmo, isso não prova que todas as políticas de pacotes são idênticas, então compare também o endereço do repositório, o ramo e os componentes.
Escreva o arquivo deb822 completo e desative as entradas antigas
Abra um novo arquivo com o seguinte comando. Prossiga somente após confirmar que o arquivo de destino não existe e que o backup foi concluído com sucesso.
sudo nano /etc/apt/sources.list.d/debian.sources
Digite todo o conteúdo abaixo, salve com Ctrl+O e Enter, depois saia com Ctrl+X. Agrupe entradas regulares e atualizadas sob o mesmo endereço e coloque os repositórios de segurança em um grupo separado. Mantenha uma linha vazia entre os dois grupos.
Types: deb deb-src
URIs: http://deb.debian.org/debian
Suites: trixie trixie-updates
Components: main non-free-firmware
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg
Types: deb deb-src
URIs: http://security.debian.org/debian-security
Suites: trixie-security
Components: main non-free-firmware
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg
O motivo para incluir deb-src em Types é preservar a funcionalidade existente da lista de fontes. Servidores que não baixam e compilam fontes podem usar apenas deb conforme necessário, mas essa escolha é separada da conversão de formato. Coloque os endereços dos repositórios em URIs e o caminho apropriado do keyring em Signed-By; não substitua um keyring de outra distribuição.
sudo chmod 644 /etc/apt/sources.list.d/debian.sources
sudo nano /etc/apt/sources.list
Comente as linhas deb e deb-src do Debian movidas do sources.list existente para o novo arquivo para desativá-las. Não exclua entradas para outros fins sem revisão separada. Por exemplo, altere o existente deb http://deb.debian.org/debian trixie main non-free-firmware para um comentário. Se a entrada de cdrom existente já estiver comentada, deixe-a como está.
Se o mesmo repositório for ativado simultaneamente nos arquivos .list e .sources, podem ocorrer avisos de duplicidade ou conflitos de valor Signed-By. Se você salvar o nome do arquivo como .sources.txt, o APT não o lerá no formato esperado, então também verifique a extensão.
Atualize os índices e compare a seleção de pacotes
A próxima operação não atualiza os pacotes instalados. Primeiro, verifica se as definições do repositório e a verificação de assinatura foram processadas corretamente.
sudo apt update
apt-cache policy bash | sudo tee /var/backups/lf-debian13-10/bash-policy-after.txt
sudo diff -u /var/backups/lf-debian13-10/bash-policy-before.txt /var/backups/lf-debian13-10/bash-policy-after.txt
sudo apt-get -s install tree
No teste original, o processamento do InRelease para trixie, trixie-updates e trixie-security passou. A comparação de candidato e prioridade para bash passou sem diferenças, e uma instalação simulada do tree também criou um plano normalmente. Se novas versões forem publicadas durante a operação, os valores podem diferir. Examine as fontes e as versões envolvidas para distinguir uma mudança no repositório de um efeito da conversão.
Uma atualização pode falhar parcialmente enquanto comandos posteriores continuam a usar listas de pacotes antigas. Não olhe apenas para a última linha; verifique erros de assinatura, falhas de download e avisos de duplicidade. Se um repositório que falhou for um repositório de segurança, a operação não é marcada como concluída apenas porque pacotes existentes podem ser encontrados.
Entenda Signed-By e a confiança no repositório
Signed-By limita o alcance das chaves públicas usadas para verificar os metadados do repositório. O fato de que um arquivo de chave exista e que a assinatura do repositório seja verificada corretamente são coisas diferentes. O manual do apt-secure explica o sistema de verificação usando informações de Release assinadas e hashes de pacotes. A confiança no repositório também é distinta de uma garantia de que todas as operações de pacotes sejam inofensivas.
Este exemplo mantém o endereço HTTP oficial do instalador e usa a verificação de assinatura. O HTTPS fornece proteção separada para o segmento de transmissão, mas não substitui a verificação de assinatura. Organizações que usam HTTPS devem aplicá-lo de forma consistente, verificando a confiança do certificado e as políticas de proxy.
Ao adicionar repositórios de provedores externos, verifique se o Debian 13 é suportado, a URL oficial de publicação dos pacotes, a impressão digital da chave e o caminho da distribuição. Chaves armazenadas pelo administrador podem ser separadas em /etc/apt/keyrings, e chaves gerenciadas por pacotes podem estar em /usr/share/keyrings. Não conceda confiança global a chaves externas arbitrárias nem desative a verificação de assinaturas, por exemplo com Trusted: yes, para contornar um problema. Também não há necessidade de copiar o procedimento antigo apt-key add para obter as chaves do repositório padrão do Debian 13.
Para erros de chave de assinatura, verifique o caminho do Signed-By, as permissões de leitura, a chave exata e o repositório; para erros de período de validade do Release, verifique o relógio do servidor e o status do repositório. O método para verificar o horário pode seguir os critérios explicados em Distinguindo fusos horários e sincronização real. Não desabilite as verificações de data ou validade sem determinar a causa.
Restaure as definições originais dos repositórios
A restauração abaixo se aplica somente ao estado inicial deste exemplo: os repositórios estavam definidos em sources.list e o arquivo debian.sources foi adicionado durante o exercício. Antes de restaurar, compare com um backup para verificar se não houve outras alterações legítimas. Se um arquivo .sources que já estava em operação foi modificado, você precisa restaurar individualmente o backup desse arquivo.
sudo cp -a /var/backups/lf-debian13-10/sources.list /etc/apt/sources.list
sudo rm -- /etc/apt/sources.list.d/debian.sources
sudo apt update
apt-cache policy bash
Remova apenas o novo arquivo debian.sources; mantenha o resto do sources.list.d. No teste original, o sources.list restaurado correspondia ao seu original byte por byte e a atualização subsequente da lista foi bem-sucedida. A conversão do formato do repositório não faz com que os pacotes instalados revertam para versões anteriores. Quaisquer atualizações de pacotes realizadas posteriormente exigem seu próprio plano de recuperação.




