qdm12/ddns-updater

O que é?

Recursos principais

• 01Atualiza registros A e AAAA em dezenas de provedores DNS.
• 02Interface web para consultar o status dos registros, com layouts para desktop e dispositivos móveis.
• 03Roda como um binário sem dependências ou uma imagem Docker pequena para amd64, arm64 e outras arquiteturas.
• 04Evita chamadas à API quando a resolução DNS já mostra o IP atual, prevenindo limites de requisições.
• 05Envia notificações pelo Shoutrrr e oferece suporte a um ping do healthchecks.io.

Casos de uso

• Manter um servidor doméstico ou serviço auto-hospedado acessível quando o provedor de internet altera seu endereço IP.
• Executar um cliente DDNS em um cluster Docker ou Kubernetes que gerencie registros em um provedor compatível.
• Atualizar registros em uma rede sem roteador usando um Raspberry Pi ou outro dispositivo ARM compacto.

Início rápido

1. 1

   Instale o programa com Go

   go install github.com/qdm12/ddns-updater/cmd/ddns-updater@latest
2. 2

   Crie um diretório de dados e um arquivo config.json dentro dele

3. 3

   Execute o programa

   ./ddns-updater

Antes de usar

• !Antes que possa atualizar qualquer coisa, é necessário criar uma configuração JSON com as credenciais do seu provedor de DNS.

Em coleções

Tópicos

Perguntas frequentes

O que é ddns-updater?

Programa leve e auto-hospedado que atualiza periodicamente registros DNS A/AAAA em vários provedores, com interface web. O DDNS Updater mantém os registros DNS A e AAAA apontados para seu endereço IP público atual, o que é útil quando sua conexão de casa ou do escritório usa um IP dinâmico. Ele roda como um único binário ou como um contêiner Docker/Kubernetes, verifica seu IP público em um intervalo configurável (5 minutos por padrão) e chama a API do provedor DNS apenas quando o registro não aponta mais para esse endereço.

ddns-updater é gratuito? Qual é a licença?

ddns-updater é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.

ddns-updater ainda é mantido?

Atualizado nos últimos 6 meses. O último commit de ddns-updater foi em 16 de set. de 2026.

Para que posso usar ddns-updater?

Manter um servidor doméstico ou serviço auto-hospedado acessível quando o provedor de internet altera seu endereço IP. Executar um cliente DDNS em um cluster Docker ou Kubernetes que gerencie registros em um provedor compatível. Atualizar registros em uma rede sem roteador usando um Raspberry Pi ou outro dispositivo ARM compacto.

Como instalar ddns-updater?

Instale o programa com Go: go install github.com/qdm12/ddns-updater/cmd/ddns-updater@latest Crie um diretório de dados e um arquivo config.json dentro dele Execute o programa: ./ddns-updater

Onde consigo ddns-updater?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/qdm12/ddns-updater