Cloudflare DDNS Sync

Overview

Cloudflare-DDNS-Sync is a simple module that updates Cloudflare DNS records.

For a more detailed overview, have a look at the Documentation

You may also have a look at the official CLI version of Cloudflare-DDNS-Sync.

How do I set this project up?

Prerequisites

• Node
• Cloudflare Account

Installation

To install Cloudflare-DDNS-Sync simply run:

npm install cloudflare-ddns-sync

in your project folder.

Usage

> Hint: If a record is not existing, CDS will automatically create it when > syncing.

Javascript Example

const Cddnss = require('cloudflare-ddns-sync').default;

// either email and key or token
const cddnss = new Cddnss({
  email: 'your@email.com',
  key: '',
  token: '',
});

const records = [
  {
    name: 'test-1.domain.com',
    type: 'A', // optional
    proxied: true, // optional
    ttl: 1, // optional
    priority: 0, // optional
    content: '1.2.3.4', // optional
  },
  {
    name: 'test-2.domain.com',
  },
];

cddnss.syncRecords(records).then((result) => {
  console.log(result);
});

Typescript Example

import Cddnss, {Record, RecordData} from 'cloudflare-ddns-sync';

// either email and key or token
const cddnss = new Cddnss({
  email: 'your@email.com',
  key: '',
  token: '',
});

const records: Array = [
  {
    name: 'test-1.yourdomain.com',
    type: 'A', // optional
    proxied: true, // optional
    ttl: 1, // optional
    priority: 0, // optional
    content: '1.2.3.4', // optional
  },
  {
    name: 'test-2.yourdomain.com',
  },
];

cddnss.syncRecords(records).then((result: Array) => {
  console.log(result);
});

Cron Expression Syntax

Cron expressions have the following syntax:

* * * * * *
┬ ┬ ┬ ┬ ┬ ┬
│ │ │ │ │ │
│ │ │ │ │ └──── weekday (0-7, sunday is 0 or 7)
│ │ │ │ └────── month (1-12)
│ │ │ └──────── day (1-31)
│ │ └────────── hour (0-23)
│ └──────────── minute (0-59)
└────────────── second (0-59) [optional]

Methods

• getIp(): Promise\
• getIpv6(): Promise\
• getRecordDataForDomain(domain: string): Promise\>
• getRecordDataForDomains(domains: Array): Promise<DomainRecordList>
• getRecordDataForRecord(record: Record): Promise<RecordData>
• getRecordDataForRecords(records: Array<Record>): Promise\>
• removeRecord(recordName: string, recordType?: string): Promise\
• stopSyncOnIpChange(changeListenerId: string): void
• syncByCronTime(cronExpression: string, records: Array<Record>, callback: MultiSyncCallback, ip?: string): ScheduledTask
• syncOnIpChange(records: Array<Record>, callback: multisynccallback): Promise\
• syncRecord(record: Record, ip?: string): Promise<RecordData>
• syncRecords(records: Array<Record>, ip?: string): Promise\>

For a more detailed view, have a look at the Documentation

Get Your Cloudflare API Key

• Go to Cloudflare
• Log In
• In the upper right corner: click on the user icon
• Go to "My Profile"
• In the "API Tokens"-Section: click on the "View"-Button of the Global Key
• Enter your password and fill the captcha
• Copy the API Key

Tests

In order to run the tests there are two ways to do so

Use test-data.json

• Open the test-data.json which can be found under src/tests/test-service/
• Configure the email, cloudflare api key and the domain
• Run npm test

Use npm test Only

• Run npm test -- --email="your@email.com" --key="your_cloudflare_api_key" --domain="yourdomain.com"