mirror of
https://github.com/opnsense/docs
synced 2024-10-30 21:20:20 +00:00
61 lines
3.6 KiB
ReStructuredText
61 lines
3.6 KiB
ReStructuredText
====================================================
|
|
Dynamic DNS
|
|
====================================================
|
|
|
|
In order to update dns registations when the local IP address changes, a Dynamic DNS service provider can be used.
|
|
Our `os-ddclient` plugin offers support for various services using the `ddclient <https://ddclient.net/>`__
|
|
software.
|
|
|
|
Prerequisites
|
|
---------------------------
|
|
|
|
Before installing and using this plugin, make sure to register an account with one of the supported services.
|
|
|
|
|
|
Installation
|
|
---------------------------
|
|
|
|
Installation of this plugin is rather easy, go to :menuselection:`System --> Firmware --> Plugins` and search for **os-ddclient**,
|
|
use the [+] button to install it.
|
|
|
|
Next go to :menuselection:`Services --> Dynamic DNS --> Settings` to configure one or more Dynamic DNS services.
|
|
|
|
|
|
General settings
|
|
---------------------------
|
|
The general settings tab offers access to general options used by all configured dynamic dns services on this firewall.
|
|
By default the service is enabled after installation,
|
|
|
|
======================= =======================================================================================================================================================================
|
|
Option Description
|
|
======================= =======================================================================================================================================================================
|
|
Enable Enable the client
|
|
Interval The number of seconds address changes will be queried
|
|
======================= =======================================================================================================================================================================
|
|
|
|
|
|
Accounts
|
|
---------------------------
|
|
|
|
In the primary tab you can register one or more dynamic dns providers which will be used to update dns registrations
|
|
using an api call over http(s) to the selected service.
|
|
|
|
.. Note::
|
|
|
|
The local IP address used for this firewall will be obtained by querying one of the selected providers. Since ddclient
|
|
currently doesn't support dual stack (IPv4+IPv6) opertion, make sure to either select an IPv4 or IPV6 address
|
|
provider in the settings tab.
|
|
|
|
======================= =======================================================================================================================================================================
|
|
Option Description
|
|
======================= =======================================================================================================================================================================
|
|
Enable Enable this rule (allows turning entries off without removing them).
|
|
Service The provider of your Dynamic DNS Service.
|
|
Username Login or user name to use, could be empty for token based authentication
|
|
Password Password or security token to use
|
|
Hostname Enter the fully qualified domain names to update via the selected service. For example: *myhost.dyndns.org*
|
|
Check ip method Service to query the current IP address
|
|
Interface to monitor Interface to collect an address from when choosing "Interface" as check ip method, or source interface used to connect to the check ip service
|
|
Description A description to easily identify this rule in the overview.
|
|
======================= =======================================================================================================================================================================
|