Tutorial do Debian 13 / Configurar hostname, localidade, fuso horário e sincronização da hora

Defina o nome do host do Debian 13 com hostnamectl, configure o fuso horário e verifique a sincronização do relógio com timedatectl, depois gere e selecione as localidades UTF-8 com locale-gen e update-locale. Fusos horários controlam como o tempo é exibido; localidades controlam o idioma e as convenções de formatação. Verifique os valores aplicados, bem como o status de saída de cada comando.

Salve as configurações atuais para recuperação

Faça login como um usuário comum em uma VM Debian minimamente instalada. Privilégios de sudo são necessários, e o procedimento deve ser realizado mantendo a sessão SSH e podendo abrir o console do VirtualBox. Os comandos são executados dentro do Debian, não no computador host.

hostnamectl --static
timedatectl
localectl status
locale
ls -l /etc/default/locale /etc/locale.conf
cat /etc/hosts

O ambiente verificado no curso original foi uma VM dedicada Debian 13.7 com systemd 257.13 e locales 2.41. Os valores iniciais eram o hostname debian13-lab, fuso horário Asia/Seoul e locale padrão en_US.UTF-8. O resultado pode variar se o idioma e a região selecionados durante a instalação forem diferentes.

O diretório de backup abaixo não deve existir previamente. Se existir, inspecione os arquivos do laboratório anterior e escolha um nome de diretório novo, então use esse mesmo nome em todos os comandos de backup e restauração. Execute a primeira linha separadamente e continue apenas se ela tiver sucesso.

sudo test ! -e /var/backups/lf-debian13-05 && sudo install -d -m 700 /var/backups/lf-debian13-05
sudo cp -a /etc/hostname /etc/hosts /etc/localtime /etc/locale.gen /etc/locale.conf /var/backups/lf-debian13-05/
hostnamectl --static | sudo tee /var/backups/lf-debian13-05/hostname-before
timedatectl show -p Timezone --value | sudo tee /var/backups/lf-debian13-05/timezone-before

Se a primeira linha falhar, pare e não execute as linhas restantes. Se /etc/locale.conf não existir no seu sistema, identifique o arquivo real da configuração de localidade antes de prosseguir. Ajuste os caminhos de cópia e restauração ao mesmo arquivo e confirme o backup antes de alterar a configuração. O /etc/default/locale desta VM era um link simbólico apontando para ../locale.conf. Como copiar apenas o link não preserva separadamente o conteúdo da configuração, o conteúdo do arquivo real também precisa ser preservado.

Defina o hostname e a resolução local de nomes

O nome do host é o nome que identifica o próprio servidor. Neste exercício, é utilizado o nome debian13-web01, uma combinação de letras minúsculas, números e hífens sem espaços. manual oficial do hostnamectl distingue entre o nome estático definido pelo usuário e o nome temporário recebido da rede. Aqui, é definido um nome estático que será usado mesmo após a reinicialização.

sudo hostnamectl set-hostname debian13-web01
hostnamectl --static
cat /etc/hostname
sudo nano /etc/hosts

Verifique se ambos os resultados da consulta são debian13-web01. No nano, apenas a linha 127.0.1.1 com o nome existente é modificada. Se a linha existente era 127.0.1.1 debian13-lab.test debian13-lab, ela é substituída da seguinte forma. Mantenha as linhas localhost e IPv6. Salve com Ctrl+O e Enter, e saia com Ctrl+X. Se o nano não estiver disponível, use o editor instalado.

127.0.1.1 debian13-web01.test debian13-web01
getent hosts "$(hostname)"

O resultado da prática foi 127.0.1.1 debian13-web01.test debian13-web01. O sufixo .test é usado apenas para aliases de laboratório local, não como um domínio público. Se houver um domínio interno real, ele deve estar em conformidade com as políticas de gerenciamento. Alterar /etc/hosts afeta a resolução de nomes dentro deste servidor e não cria registros DNS externos. Para se conectar de outro computador usando o novo nome, a resolução de nomes também deve ser configurada separadamente nesse computador.

Mesmo que o nome antigo permaneça no prompt do shell existente, isso não é uma indicação definitiva de uma configuração falha. Verifique o prompt em um novo login e use o resultado de hostnamectl para avaliação. Se aparecer um aviso sudo unable to resolve host, primeiro confirme se o nome do host e o alias em /etc/hosts correspondem.

Compare UTC com o fuso horário local

UTC (Tempo Universal Coordenado) é o padrão comum para comparação de tempo. O horário coreano está 9 horas à frente do UTC. Servidores operados na Coreia podem escolher Asia/Seoul, e servidores que alinham logs de várias regiões com um padrão comum podem escolher Etc/UTC. Escolha um fuso coerente com a política operacional e conhecido por quem analisa os logs. Para um servidor cuja região corresponda a São Paulo, você pode usar America/Sao_Paulo: nesse caso, substitua as duas ocorrências de Asia/Seoul no bloco de comparação abaixo. O Brasil tem vários fusos; não aplique essa escolha a todas as regiões. Confira o resultado real de date; a saída histórica KST abaixo corresponde à Coreia, não ao Brasil.

timedatectl list-timezones | grep -E '^(Asia/Seoul|Etc/UTC)$'
sudo timedatectl set-timezone Etc/UTC
date '+%F %T %Z %z'
sudo timedatectl set-timezone Asia/Seoul
date '+%F %T %Z %z'
timedatectl

No registro original da comparação, a primeira saída foi 2026-11-16 08:31:48 UTC +0000 e a segunda foi 2026-11-16 17:31:48 KST +0900. Os segundos podem variar dependendo do intervalo de execução. Embora a exibição tenha mudado em 9 horas, o tempo real não foi adiantado em 9 horas. Sem perceber essa diferença, se o relógio for ajustado novamente com set-time, pode desalinhar a referência de certificados, logs e tarefas agendadas.

O manual do timedatectl explica que definir o fuso horário altera o link /etc/localtime. Mantenha o relógio de tempo real (RTC) em UTC sempre que possível; exibir a hora local não requer alterar o RTC para o modo de hora local.

Verifique a sincronização do relógio

O NTP (Network Time Protocol) é usado para sincronizar relógios com um servidor de tempo. Esta VM de instalação mínima tinha o systemd-timesyncd instalado. Se outro serviço de tempo estiver em uso no servidor existente, verifique-o primeiro e não instale arbitrariamente vários clientes juntos.

systemctl is-active systemd-timesyncd
systemctl is-active chrony
sudo timedatectl set-ntp true
timedatectl show -p Timezone -p NTP -p NTPSynchronized
timedatectl timesync-status

Se o chrony não estiver presente, você pode obter resultados indicando inativo ou unidade não encontrada, e isso sozinho não significa que a sincronização falhou. A verificação de um ambiente de prática usando timesyncd foi a seguinte.

Timezone=Asia/Seoul
NTP=yes
NTPSynchronized=yes

NTP=yes significa que a sincronização de horário está habilitada, e NTPSynchronized=yes indica se a sincronização realmente ocorreu. Se a rede estiver bloqueada ou logo após a inicialização, a sincronização pode não estar concluída mesmo que o serviço esteja em execução. timesync-status é exclusivo para timesyncd, então em uma configuração com chrony, são usadas ferramentas do respectivo serviço, como chronyc tracking.

Se a sincronização continuar a falhar, verifique o endereço do servidor, falha na resolução de nomes e tempo limite no próximo log. Confirme com o administrador se a consulta DNS e a comunicação NTP externa (normalmente UDP 123) são possíveis. Se houver um servidor de tempo designado pela organização, siga essa política. Não tente resolver o problema de não conseguir se conectar a um servidor de tempo público em uma rede separada da Internet apenas reinstalando o pacote.

journalctl -u systemd-timesyncd -b --no-pager -n 30
timedatectl timesync-status

O manual systemd-timesyncd descreve um cliente simples de sincronização de tempo. Ele não cobre todos os requisitos avançados do NTP. Fornecer tempo para outros dispositivos requer um design de serviço separado.

Gere localidades UTF-8 e escolha o padrão

Uma localidade (locale) define o idioma, a classificação de caracteres, convenções de data, número e ordenação usadas pelos programas. UTF-8 codifica caracteres de muitos sistemas de escrita, incluindo o coreano. Mantenha en_US.UTF-8 se você quiser mensagens em inglês e buscas por erros. Este laboratório também gera ko_KR.UTF-8 para demonstrar uma diferença visível de idioma; você não precisa do coreano como padrão do servidor para trabalhar com arquivos UTF-8.

Configurações Funções Pontos a Observar
LANG Local padrão para cada item Usado para selecionar o idioma padrão geral.
LC_TIME Exibição de Data e Dia Altere a formatação de data/hora enquanto mantém as outras categorias de localidade inalteradas.
LC_ALL Substitua todas as categorias de localidade É útil para execução temporária, mas não deve ser definido como padrão global incondicionalmente.

Primeiro, verifique as localidades instaladas. Nomes exibidos como ko_KR.utf8 também são localidades coreanas UTF-8. Se não existirem, ative os itens a serem usados em /etc/locale.gen e, em seguida, gere-os. Se o pacote de localidades estiver ausente, execute primeiro sudo apt update seguido por sudo apt install locales.

locale -a
sudo nano /etc/locale.gen

Remova os marcadores de comentário na frente das duas linhas abaixo. Deixe quaisquer outras localidades já em uso habilitadas.

en_US.UTF-8 UTF-8
ko_KR.UTF-8 UTF-8
sudo locale-gen
locale -a
env -u LC_ALL LC_TIME=ko_KR.UTF-8 date '+%A'
env -u LC_ALL LC_TIME=en_US.UTF-8 date '+%A'

Apenas o LC_TIME muda entre esses comandos. Na segunda-feira do registro original, o comando em coreano imprimiu 월요일 e o comando em inglês imprimiu Monday, ambos significando segunda-feira. Em outro dia, o nome exibido será diferente. Essas atribuições de ambiente afetam apenas o comando individual. O prefixo env -u LC_ALL impede que um valor existente de LC_ALL substitua a comparação.

O manual do locale-gen diferencia a seleção de locais da compilação de seus dados. Alterar o LANG antes de gerar o local selecionado pode produzir avisos como Não é possível definir LC_*.

Para comparar em português do Brasil, habilite pt_BR.UTF-8 UTF-8 em /etc/locale.gen no lugar da linha coreana do exemplo, mantendo as outras localidades usadas. Após executar locale-gen, substitua ko_KR.UTF-8 por pt_BR.UTF-8 no comando LC_TIME e, se quiser alterar também o padrão global, no comando LANG abaixo. Assim, você compara a saída portuguesa com a inglesa; o texto coreano é apenas o resultado histórico do curso original. Para repetir exatamente essa comparação histórica com padrão coreano, use o bloco sem substituir a localidade. O argumento final LC_ALL não possui sinal de igual nem valor: ele remove uma definição existente de LC_ALL da configuração do local, em vez de limpar todas as configurações.

sudo update-locale LANG=ko_KR.UTF-8 LC_ALL
cat /etc/locale.conf
localectl status

Para manter ou restaurar o inglês, execute sudo update-locale LANG=en_US.UTF-8 LC_ALL. O manual Debian 13 update-locale especifica /etc/locale.conf como o arquivo de configuração padrão. Na VM do laboratório, tanto o arquivo real quanto o localectl exibiram alterações quando o padrão foi alterado para coreano e depois restaurado para inglês.

Verifique um novo login e restaure as configurações originais

Mesmo que você mude o padrão global, as variáveis de ambiente de shells já abertos não mudam automaticamente. Antes de fechar uma sessão SSH existente, abra uma nova sessão e verifique o locale e a data. LANG e LC_* do cliente podem ser passados de acordo com o SendEnv do cliente SSH e AcceptEnv do servidor. Se o arquivo global e os resultados da nova sessão diferirem, verifique tanto as configurações de conexão quanto a configuração do shell do usuário. Não interrompa o serviço SSH à força apenas para verificação.

Se o coreano aparecer como quadrados ou formas quebradas, verifique a codificação UTF-8 do terminal e as fontes coreanas, assim como a localidade. Gerar uma localidade coreana não significa instalar fontes coreanas em todos os consoles. Também é possível configurar para que você manipule arquivos coreanos em UTF-8 enquanto mantém as mensagens em inglês.

Para retornar ao estado antes da prática, use os materiais salvos inicialmente. Se houve outras alterações válidas após a prática, primeiro verifique as diferenças entre o conteúdo atual e o backup.

sudo hostnamectl set-hostname "$(sudo cat /var/backups/lf-debian13-05/hostname-before)"
sudo cp -a /var/backups/lf-debian13-05/hosts /etc/hosts
sudo timedatectl set-timezone "$(sudo cat /var/backups/lf-debian13-05/timezone-before)"
sudo cp -a /var/backups/lf-debian13-05/locale.gen /etc/locale.gen
sudo cp -a /var/backups/lf-debian13-05/locale.conf /etc/locale.conf
sudo locale-gen
hostnamectl --static
getent hosts "$(hostname)"
timedatectl show -p Timezone -p NTP -p NTPSynchronized
localectl status

Essa restauração recupera o hostname, /etc/hosts, o fuso horário e a configuração de localidade. Se a sincronização de tempo estava desligada antes da prática, você deve verificar a política de serviço e restaurar esse estado separadamente também. Como o estado inicial no exemplo tinha a sincronização habilitada, ela foi mantida. A configuração é considerada completa quando o nome desejado é exibido, o fuso horário selecionado e o local UTF-8 são mostrados, e você pode verificar se o relógio realmente está sincronizado.