This translation is older than the original page and might be outdated. See what has changed.

Cliente DDNS DuckDNS

Este artigo descreve uma configuração personalizada que utiliza uma URL de atualização definida pelo usuário.

:!: Na maioria dos casos, você pode seguir um processo de configuração muito mais simples selecionando “duckdns.org” como seu provedor de serviços no DDNS client.

O uso das instruções abaixo pressupõe que você tenha o pacote ddns-scripts instalado.

  • Seguir o link na seção “Dicas” pode revelar alterações úteis, incluindo recursos que nem sempre estão presentes no busybox.
  • A instalação do pacote ca-certificates adicionará automaticamente uma coleção geral de certificados ao diretório /etc/ssl/certs/ e habilitará a verificação de certificados SSL por qualquer programa que utilize esse diretório como padrão, incluindo o ddns-scripts.

IPv4

Em /etc/config/ddns, substitua <subdomain> e <duckdns-token> pelos valores apropriados. 

config service 'DuckDNS_ipv4'
	option enabled		'1'
	option interface	'wan'
	option username		'<subdomain>'
	option domain		'<subdomain>.duckdns.org'
	option password		'<duckdns-token>'
	option ip_source	'network'
	option ip_network	'wan'
	option check_interval	'1'
	option check_unit	'hours'
	option update_url	'https://www.duckdns.org/update?domains=[USERNAME]&token=[PASSWORD]&ip=[IP]'
	option use_https	'1'

Notas

  • Isso será atualizado sempre que a rede wan ficar ativa ou quando a verificação (realizada a cada hora) detectar uma inconsistência, forçando o IP para o valor identificado na rede wan (remova o &ip=[IP] e o DuckDNS fará a detecção automática).
  • A opção de interface instrui o DDNS a realizar a atualização quando essa rede mudar de estado — especificamente, quando ela ficar ativa.
  • A opção domain refere-se ao domínio pertencente ao cliente, e o comando 'nslookup $DOMAIN' deve ser bem-sucedido e apontar para o cliente (ou o roteador ao qual ele está conectado) quando tudo estiver atualizado; isso é usado para verificar se $DOMAIN aponta para o IP público do cliente.
  • A opção username é utilizada onde anteriormente se usava a opção domain isso também se reflete na alteração para update_url
  • Ativar HTTPS para maior segurança /etc/ssl/certs/ (populado pelo pacote “ca-certificates”), ou a opção “option cacert”
  • A opção force_interval e force_unit são desnecessárias, pois o DuckDNS não expira registros caso não sejam atualizados periodicamente.

Se você quiser visualizar ou editar o serviço no LuCI (via luci-app-ddns), também é necessário adicionar essas opções à configuração: 

    option lookup_host	'<subdomain>.duckdns.org'
    option use_ipv6		'0'
    option cacert		'/etc/ssl/certs'

IPv6

O ddns-scripts oferece suporte à atualização do seu subdomínio duckdns.org com o seu endereço IPv6, o que ainda é necessário para usuários domésticos com endereços IPv6 dinâmicos. Embora o seu endereço IPv6 seja globalmente endereçável, em 2024, alguns provedores de internet residencial ainda atribuem endereços IPv6 dinâmicos que podem mudar periodicamente.

Em /etc/config/ddns, substitua <subdomain> e <duckdns-token> abaixo pelos valores apropriados. 

config service 'DuckDNS_ipv6'
	option enabled		'1'
	option lookup_host	'<subdomain>.duckdns.org'
	option username		'<subdomain>'
	option domain		'<subdomain>.duckdns.org'
	option password		'<duckdns-token>'
	option use_ipv6		'1'
	option ip_source	'network'
	option ip_network	'wan6'
	option interface	'wan6'
	option check_interval	'1'
	option check_unit	'hours'
	option update_url	'https://www.duckdns.org/update?domains=[USERNAME]&token=[PASSWORD]&ipv6=[IP]'
	option use_https	'1'
  • Ative o “Use cURL” nas Configurações Globais de DDNS para evitar o GNU Wget Error: 4 error
config ddns 'global'
    option use_curl '1'

Leitura Complementar

  • Last modified: 2026/07/28 21:23
  • by marcomangini