DNSMasq

DNSMasq#

Il modulo DNSMasq è un server DNS e DHCP leggero progettato per fornire i propri servizi all’interno di una rete privata. Non è raccomandato per l’uso come server DNS pubblico.

Nota

Do not configure Dnsmasq as the NS8 node name resolver in /etc/resolv.conf. For more information, see Name resolution.

Prerequisiti#

L’unico prerequisito è una interfaccia di rete configurata. Ciò significa che la rete dovrebbe avere un indirizzo IPv4 valido e una maschera subnet valida. Si prega di fare riferimento alla documentazione distro su come configurare correttamente un’interfaccia di rete.

Configurazione#

Dopo aver installato il modulo, è possibile configurare sia il server DNS che il server DHCP attraverso l’interfaccia web.

Selezionare nel campo Interface` l’interfaccia che si desidera utilizzare per il server DNS e DHCP, quindi premere Save.

Una volta salvata la configurazione, ci saranno due switch per attivare/disattivare il server DNS e DHCP.

DHCP#

Il server DHCP può essere configurato con le seguenti opzioni:

  • IP range start`: Il primo indirizzo IP che verrà assegnato ai client.

  • IP range end: L’ultimo indirizzo IP che verrà assegnato ai client.

  • `` Tempo di rilascio`: Il tempo che l’indirizzo IP verrà assegnato al client, espresso in ore.

  • Gateway: The gateway IP address for client configuration (DHCP router option 3). If left empty, the gateway address configured for the local node is assigned to clients.

I campi vengono automaticamente riempiti con valori predefiniti alla prima configurazione, ma puoi cambiarli in base alle tue esigenze. Ulteriori opzioni possono essere configurate manualmente, fare riferimento alla sezione Advanced Configuration .

DNS#

The DNS server can be configured with the following options:

  • Primary forwarding server: Il server DNS primario che verrà utilizzato per risolvere le query.

  • Secondary forwarding server: Il server DNS secondario che verrà utilizzato per risolvere le query.

Quando il server DNS è abilitato, tutti i nomi di dominio pienamente qualificati (FQDN) configurati all’interno del nodo saranno risolti utilizzando un record “CNAME” che indica il nome host del nodo.

Nota

The DNS server will not automatically resolve the entries in the /etc/hosts file. To resolve the entries in the /etc/hosts file, you need to add them manually in the DNS Records section.

DNS Records#

Ulteriori voci DNS possono essere aggiunte nella sezione DNS Records`. Basta premere il tasto Add DNS Record e riempire i campi con i valori desiderati:

  • Hostname: The hostname that will be resolved.

  • IP Indirizzo: L’indirizzo IP che verrà risolto al nome host.

Gli indirizzi IP possono essere IPv4 o IPv6.

Advanced Configuration#

Il modulo fornisce ulteriori opzioni di configurazione che possono essere accessibili manualmente tramite i file di configurazione.

Le directory che accettano i file personalizzati si trovano nella directory root del modulo, sotto la directory state.

Le seguenti directory possono essere utilizzate per aggiungere file di configurazione personalizzati:

  • dnsmasq.d`: Questa directory viene utilizzata per aggiungere file di configurazione personalizzati per il servizio DNSMasq. I file devono avere l’estensione .conf. Per ulteriori informazioni su come configurare il servizio, fare riferimento alla documentazione DNSMasq.

  • dnsmasq_hosts.d: Questa directory viene utilizzata per aggiungere file host personalizzati che verranno utilizzati dal servizio DNSMasq. Il formato del file è lo stesso del file /etc/hosts. Fare riferimento al manual per ulteriori informazioni su come scrivere il file.

Dopo aver aggiunto i file personalizzati, è necessario riavviare il servizio per applicare le modifiche.

The custom files enrich the existing configuration. You can customize the provided DHCP instance without creating a custom one using the tag default, more info can be found in the DNSMasq documentation.

I file personalizzati sono inclusi nel backup del modulo.