Synchronet v3.19b-Win32 (install) has been released (Jan-2022).

You can donate to the Synchronet project using PayPal.

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
module:dyndns [2010/03/17 11:09] – digitalmanmodule:dyndns [2024/08/04 17:39] (current) – [modopts.ini] add 'password' key (optional) digital man
Line 1: Line 1:
-====== DynDNS ======+====== Dynamic DNS ======
  
-This module is used in combination with the Synchronet Dynamic Domain Name System (DynDNS) Service hosted on [[bbs:Vertrauen]] to provide free ''.synchro.net'' hostnames to Synchronet sysops.+The Synchronet Dynamic DNS module is used in combination with the Synchronet Dynamic Domain Name System (DynDNS) Service hosted on [[bbs:Vertrauen]] to provide free ''.synchro.net'' hostnames to Synchronet sysops.
  
 ===== yourbbs.synchro.net ===== ===== yourbbs.synchro.net =====
Line 11: Line 11:
 ===== Directions ===== ===== Directions =====
  
-1. If you don't already have the ''[[dir:exec]]/dyndns.js'' file, download [[http://cvs.synchro.net/cgi-bin/cvsweb.cgi/~checkout~/exec/dyndns.js|the file]] into your Synchronet ''[[dir:exec]]'' directory.+1. If you don't already have the ''[[dir:exec]]/dyndns.js'' file, download [[https://gitlab.synchro.net/sbbs/sbbs/-/raw/master/exec/dyndns.js|the file]] into your Synchronet ''[[dir:exec]]'' directory.
        
 2. If you haven't already, create a QWK networking account on [[bbs:Vertrauen]] 2. If you haven't already, create a QWK networking account on [[bbs:Vertrauen]]
 using your BBS's QWK-ID for the username (see [[howto:dove-net|this howto]] for more details). using your BBS's QWK-ID for the username (see [[howto:dove-net|this howto]] for more details).
  
-Note: You do not have to actually join [[network:usenet]] to get a ''synchro.net'' hostname, if you do not wish.+Note: You do not have to actually join [[network:DOVE-Net]] to get a ''synchro.net'' hostname, if you do not wish.
  
 3. If you don't already have one, setup a timed event (in [[util:SCFG]]->External Programs->Timed Events) to run the  3. If you don't already have one, setup a timed event (in [[util:SCFG]]->External Programs->Timed Events) to run the 
Line 38: Line 38:
 (creating or modifying) the file ''[[dir:data]]/dyndns.now''. (creating or modifying) the file ''[[dir:data]]/dyndns.now''.
  
-5. Attempt to ping or connect to services at your-id.synchro.net, where +5. Attempt to ping or connect to services at ''//your-id//.synchro.net'', where 
-your-id is your BBS's QWK-ID. It may take a few minutes for a new hostname+//your-id// is your BBS's QWK-ID. It may take a few minutes for a new hostname
 to become active or for an existing hostname to resolve to a newly changed to become active or for an existing hostname to resolve to a newly changed
 IP address.  IP address. 
Line 46: Line 46:
  
 ===== Options ===== ===== Options =====
 +
 +If you choose to include any ''dyndns.js'' command-line options, they must follow your password (and a space) on the configured command-line.
  
 ''-mx //[hostname]//'' ''-mx //[hostname]//''
Line 55: Line 57:
 that the *sending* SMTP server correspond to the MX record of the "from" that the *sending* SMTP server correspond to the MX record of the "from"
 hostname. If you want to specify an MX record for your hostname, you can do hostname. If you want to specify an MX record for your hostname, you can do
-so by adding "-mx" (optionally followed by a hostname) to your "?dyndns"+so by adding ''-mx'' (optionally followed by a hostname) to your ''?dyndns''
 command-line (after the password). If no hostname is specified, then an MX command-line (after the password). If no hostname is specified, then an MX
 record pointing back to your hostname will be created. Example: ''?dyndns password -mx mail.someother.org'' record pointing back to your hostname will be created. Example: ''?dyndns password -mx mail.someother.org''
Line 62: Line 64:
  
 If you want to update a hostname that is **different** than your BBS's QWK-ID, If you want to update a hostname that is **different** than your BBS's QWK-ID,
-then you can specify that hostname (QWK-ID) on the "?dyndns" command-line +ou can specify that hostname (QWK-ID) on the ''?dyndns'' command-line 
-(after the password) by using the "-hn" option followed by the hostname+(after the password) by using the ''-hn'' option followed by the hostname
 to use (not including ".synchro.net"). There must be a corresponding QWKnet to use (not including ".synchro.net"). There must be a corresponding QWKnet
 account on Vertrauen for the specified hostname and password. account on Vertrauen for the specified hostname and password.
 +
 +''-ip6 //[ipv6_address]//''
 +
 +If you have a public IPv6 address, you may create/update a ''AAAA'' record along with your IPv4
 +''A'' record by including the ''-ip6'' option followed by a space and your current public IPv6 address.
 +Vertrauen cannot at this time automatically detect your public IPv6 address, so if your
 +IPv6 address changes, you will need to change the command-line accordingly.
  
 ''//[ip_address]//'' ''//[ip_address]//''
  
-If for some reason you want to specify a **different** IP address than the one+If for some reason you want to specify a **different** IPv4 address than the one
 that your BBS will be using to connect with [[bbs:Vertrauen]], you can include that IP that your BBS will be using to connect with [[bbs:Vertrauen]], you can include that IP
 address on the "?dyndns" command-line (after the password). This is an address on the "?dyndns" command-line (after the password). This is an
Line 77: Line 86:
 address by default. address by default.
  
 +==== modopts.ini ====
 +
 +Due to command-line length limits (63 characters), you may want to move one or more of the longer command-line options to the ''[dyndns]'' section of your ''[[dir:ctrl]]/[[config:modopts.ini]]'' file.
 +
 +The following options/keys are supported:
 +
 +^   Key       ^ Record ^ Description ^
 +| ''mx''      | MX     | Mail Exchange record (hostname)   |
 +| ''ip''      | A      | IP version 4 address (e.g. 172.217.4.174) |
 +| ''ip6''     | AAAA   | IP version 6 address (e.g. 2607:f8b0:4007:801::200e) |
 +| ''txt''     | TXT    | Text (default: BBS name) |
 +| ''loc''     | LOC    | Location coordinates (see [[http://dnsloc.net/]] for details) |
 +| ''wildcard'' | CNAME  | When set to ''true'', will create a wildcard record for "*.yourbbs.synchro.net" |
 +| ''password'' | N/A    | Over-ride the password (first argument) specified on command-line |
 ===== See Also ===== ===== See Also =====
   * [[:module:|Modules]]   * [[:module:|Modules]]
  

Trace: