让我们用 Node.js 写自己的 DDNS 动态域名程序

原文链接:http://xcoder.in/2014/09/20/lets-build-ourselves-ddns/

起因

一开始我在移动的宽带中。那个时候虽然还不是完全的局域网,但是电信网络访问不了我的外网 IP。又因为我需要一个 DDNS 服务来维持我的 kacaka.ca(目前暂失效)。

为了解决让电信网络也能访问我的 Web,于是我想到了免费 CDN 当中比较有名的 CloudFlare。而且它也有提供 API 让开发者自己开发通过他的服务解析域名的服务。

再然后,去年的九月份,我的早期 Node.js 作品 dloucflare 发布了。所以就有了这个帖子

现在,我已经搬到电信了,然后旧版的貌似不能用了,因为 CloudFlare 貌似 API 都迁移到了 https 上面。然后我为了我的小伙伴们能访问我出租屋里的旧电脑,又重构了一遍这个项目

使用 dlouc-flare 构建

首先安装最新的 dlouc-flare 包:

$ npm install dlouc-flare

然后去创建一个 DF 对象:

var DloucFlare = require("dlouc-flare");
var df = DloucFlare.create("你的邮箱", "API KEY", "域名(不需要 www)");

CloudFlare 如何使用的话这里就不多做解释了,至于 API KEY 的话,可以在这里获取到。

然后调用 df.dynamicDomains 函数去把你这个域名下面的一些子域名加入你这个脚本的动态域名范畴当中:

df.dynamicDomains([ "@", "www", "子域名3", "子域名4", ... ], 检测时间间隔);

其中 "@" 代表的是域名没有 www 前缀的本身。检测时间间隔以毫秒为单位。

事实上,你也可以自定义一个检测你当前主机的 IP 地址的函数(如果你不喜欢用包内的默认检测 IP 函数)。

只要你写一个函数:

function checkIp(callback) {
    // blahblah...
    callback(undefined, IP地址);
}

然后覆盖掉默认的 IP 检测函数即可:

df.getIpFunction = checkIp;

最后保存退出并用 node 执行你的程序就好了,程序就会开始欢快地跑了。

Preview
Preview

如何自己写?

其实要完全自己写也是很简单的——无非就是调用一下 CloudFlare 的 API 而已。

我们定位明确就是要做 DDNS,所以没必要关系其它很多不相关的 API,只需要最基础的几个就够了。

API 解析

所有 API 的基础 URI 都为:https://www.cloudflare.com/api_json.html

验证信息

根据 CloudFlare 文档所说,所有的提交都要黏上验证信息给 POST 过去。而验证的字段如下:

  • tkn: 从你的个人页面当中复制出来的 API KEY。
  • email: 你的登录邮箱。
  • a: 操作名,每种操作都有其特有的操作名。

获取域名下的子域名记录

其操作名为 rec_load_all,我们不关心其它不重要的参数,只需要再传一个 z 字段代表其域名就好了,举个例子:

var self = this;
var param = {
    a       : "rec_load_all",
    tkn     : this.apiKey,
    email   : this.email,
    z       : this.domain
};

var url = "https://www.cloudflare.com/api_json.html";
spidex.post(url, function(html, status) {
    if(status !== 200) {
        return callback(new Error("Error status while fetching DNS records."));
    }

    var json;
    try {
        json = JSON.parse(html);
    } catch(e) {
        return callback(new Error("Error while parsing DNS records: " + e.message));
    }

    if(json.result === "error") {
        var msg = json.msg;
        if(undefined === msg) msg = "Unknown error.";
        return callback(new Error(msg));
    } else if(json.result === "success") {
        var count = json.response.recs.count;
        var objects = json.response.recs.objs;
        for(var i = 0; i < count; i++) {
            self.records.push(new DNSRecordObject(self, objects[i]));
        }

        callback(undefined, self.records);
    } else {
        callback(new Error("Unknown error."));
    }
}, param, "utf8").on("error", callback);

上述代码就是把 param 数据给 POST 到 API 的 RESTful 里面去。然后根据返回值进行解析。

关于 DNSRecordObject 的代码可以自行翻阅这里

以及 spidex 的文档在这里

修改某记录

其操作名为 rec_edit,如文档所说,除了固有的几个参数之外,我们还需要有如下参数:

  • z: 域名。
  • id: 域名记录编号,从 rec_load_all 中获取。
  • type: 记录类型。如 A / CNAME 等等。
  • name: 子域名名,如果无前缀子域名则与域名相同。
  • content: 值。如果我们只是做动态域名的话,这里的值就是 IP。
  • service_mode: 服务类型,填原值即可。
  • ttl: TTL,填原值即可。

上面参数的解说只是对于我们要做 DDNS 脚本而言的解释。

所以说在 dnsrecordobject.js 中我是这么做的:

var param = {
    a       : "rec_edit",
    tkn     : this.dloucflare.apiKey,
    email   : this.dloucflare.email,
    id      : this.recordId(),

    z       : this.domain,
    type    : this.recordType(),
    name    : this.name,
    content : ip,

    service_mode    : this.object.service_mode,
    ttl     : this.object.ttl
};

var self = this;
spidex.post(config.baseUrl, function(html, status, respHeader) {
    if(status !== 200) {
        return callback(new Error("Error status while editing " + self.name + "."));
    }

    var json;
    try {
        json = JSON.parse(html);
    } catch(e) {
        return callback(new Error("Error whileparsing editing result: " + e.message));
    }

    if(json.result === "success") {
        self.object.content = ip;
        return callback();
    } else {
        var msg = json.msg || "Unknown error.";
        return callback(new Error(msg));
    }
}, param, "utf8").on("error", callback);

上面的代码就能将你某个域名(this.domain)下的子域名 this.name 的 IP 给修改成 ip 了。

探测 IP

这种 API 网上就多了去了。

举个简单的例子,我的 dlouc-flare 的获取 IP 的 API 就是从

http://www.telize.com/ip

来的。

请求上面的地址之后,输出的内容(注意有换行符)就是你当前机子所在的网络的公网 IP 了。

类似的 API 还有很多:

流程

有了上面的仨 API,一切都好说了,流程很简单:

  • 获取自己某个使用 CloudFlare 解析的域名下的子域名
  • 自己设置几个子域名名拿来做 DDNS。
  • 设置一个定时器,每次定时器到时的时候都进行如下操作:
    1. 通过 IP 的 API 获取当前 IP。
    2. 循环遍历每个自己设置的子域名名。
    3. 对于每个子域名,都判断其当前记录 IP 是否等于当前刚探测的 IP。

有了上面的几个步骤,加上之前我们讲的几个 API,大家就能轻松加愉快地完成自己的 DDNS 脚本了。

当然,如果自己懒的话也可以用本文一开始的方法,使用 dlouc-flare 这个包,通过简单的编码就能实现自己的 DDNS 动态域名脚本了。

这里的定时器时间自己按需而定,就我自己而言,我是给设置了 1000 * 60 毫秒的间隔。

小结

最早与动态域名结缘的时候是初中的时候,大概七八年前了吧,那个时候花生壳什么的,但是最终用的是 3322.org

其实基本的动态域名的原理很简单,无非就是本地开一个脚本,不停去探测本机 IP,一旦有变化就去解析服务器修改。

本人在这里抛砖引玉。如果哪里有别的解析商的 API,大家自己也可以举一反三,写什么 DNSPod 的动态域名,写什么 jiasule 的动态域名等等等等。

喵~ଘ(੭ˊᵕˋ)੭* ੈ✩‧₊˚

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,098评论 5 476
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,213评论 2 380
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 149,960评论 0 336
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,519评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,512评论 5 364
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,533评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,914评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,574评论 0 256
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,804评论 1 296
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,563评论 2 319
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,644评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,350评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,933评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,908评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,146评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,847评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,361评论 2 342

推荐阅读更多精彩内容

  • 从三月份找实习到现在,面了一些公司,挂了不少,但最终还是拿到小米、百度、阿里、京东、新浪、CVTE、乐视家的研发岗...
    时芥蓝阅读 42,169评论 11 349
  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 171,382评论 25 707
  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,580评论 18 139
  • Nmap扫描原理与用法 1Nmap介绍 Nmap扫描原理与用法PDF:下载地址 Nmap是一款开源免费的网络发现(...
    y0ungta1a阅读 5,364评论 0 50
  • 已记不得究竟是在怎样的机缘巧合下,去年年底的某一天,30岁的我懵懵懂懂的加入到了一个21天的理财群里,而后捶胸顿足...
    A张爽阅读 250评论 0 0