Giter Site home page Giter Site logo

dnspod-ddns-with-bashshell's Introduction

Dnspod-DDNS-with-BashShell

利用Dnspod的API和shell脚本搭建自己的动态域名服务。如果你使用这个脚本,建议点watch以获取更新通知。
应friends要求写的,dnspod的限制比较多,对调用次数比较小气,频次高了(API文档说的是一小时5次)就会冻结API一小时,返回API usage is limited的报错,所以本脚本进行多次对比确保减少API调用(按照本脚本的逻辑理论上和实测正常使用不可能超过限制,请放心使用!)

用于CloudXNS的DDNS脚本另见:
https://github.com/lixuy/CloudXNS-DDNS-with-BashShell
https://github.com/lixuy/CloudXNS-DDNS-with-PowerShell

使用方法

本脚本分为两个版本,一个是获取自己外网ip的版本dnspod_ddns.sh,一个是直接获取自己网卡设备上的ip的版本dnspod_ddns_line.sh(对于多拨或者路由器网关用户适用)。

获取API的ID和Token

API的ID和Token可以在后台获取:

创建一个 Token,依次点击 用户中心 -> 安全设置 -> API Token: 创建一个 Token 点击创建一个 Token,输入 Token 名称即可,名称仅用来标记 Token,方便用户管理 Token ,不参与鉴权。 输入 Token 名称
点击 “确定” 之后,Token 创建成功,会弹出如下提示框: Token 创建成功

dnspod_ddns.sh

参数说明

在脚本开头#CONF START到#CONF END之间为用户所需填写的参数:

参数 填写说明
API_ID 在个人中心后台的安全设置里面获取ID
API_Token 在个人中心后台的安全设置里面获取Token
domain 你所注册的主域名,例如baidu.comqq.comchina.edu.cnexample.com
host 主机记录名,例如www.baidu.com的主机记录名是wwwimage.www.weibo.com的主机记录是image.wwwhome.example.com的主机记录名是home
Email 填写你的邮箱。(根据API规范要求)
CHECKURL 用于检查自己的外网IP是什么的网址,注释掉该参数会跳过本地DNS检查比对,直接执行(验证域名记录是否存在以及记录是否重复后)更新;建议的备选CHECKURL:http://ip.qq.com http://ip.3322.org http://myip.ipip.net http://checkip.dns.he.net/
OUT 指定使用某个网卡设备进行联网通信(默认被注释掉)。注意,一些系统的负载均衡功能可能会导致该参数无效。推荐使用ip a命令或者ifconfig命令查看网卡设备名称。

推荐的部署方法

把如上所述的参数填好即可。
本脚本没有自带循环,因为linux平台几乎都有Crontab(计划任务),利用计划任务可以实现开机启动、循环执行脚本、并设定循环频率而无需常驻后台。  

命令参考
假设脚本已经填写好参数并加了可执行权限(chmod +x ./dnspod_ddns.sh),并位于/root/dnspod_ddns.sh:
新建计划任务输入crontab -e   按a进入编辑模式,输入
*/1 * * * * /root/dnspod_ddns.sh &> /dev/null
意思是每隔一分钟执行/root/dnspod_ddns.sh并屏蔽输出日志。当然,如果你需要记录日志可以直接重定向至保存路径。 然后按Esc,输入:wq回车保存退出即可。
更多关于Crontab的使用方法此处不再详述。
另外对于一些带有Web管理界面嵌入式系统(比如openwrt),有图形化的计划任务菜单管理,可以直接把脚本粘贴进去。

工作过程

1、用CHECKURL检查自己的外网ip和本地解析记录是否相同,相同则退出;
2、使用API获取域名在Dnspod平台的ip记录,如果ip记录和本地解析记录或者外网解析记录相同则退出;获取记录异常也会退出并返回错误信息(例如域名不存在No Record);
3、执行DNS更新,并返回执行结果。

注意事项

本脚本不会自动创建子域名,请务必先到后台添加一个随意的子域名A记录,否则会提示No Record 如果你看到API usage is limited的报错,是由于调用API频率过高账号被冻结(一小时后解封)

dnspod_ddns_line.sh

仅说明与上面脚本参数不同的地方。
因该脚本是用于获取网卡设备ip,所以没有CHECKURL参数。

参数说明

参数 填写说明
DEV 从网卡设备(例如eht0)上获取ip,并与DNS记录比对更新。推荐使用ip a命令ifconfig命令查看网卡设备名称。

日志参考

现象 说明
[DNS IP]为Get Domain Failed 本地DNS解析出现问题(断网、DNS服务器不工作、域名记录错误)
[URL IP]为空 访问CHECKURL失败,检查网络访问CHECKURL是否正常
No Record 不存在该域名或者该主机记录(本脚本不会自动创建子域名,请务必先到后台添加一个随意的子域名A记录)
API usage is limited 调用API频率过高账号被冻结(一小时后解封),正常使用一般不会出现
[URL IP]或者[DEV IP] 和[DNS IP]不一样但和[API IP]一样 DNS有缓存,DNS记录是已经更新,属正常现象,会提示IP SAME IN API,SKIP UPDATE.自动忽略

关于

https://03k.org/dnspod-ddns-with-bashshell.html

dnspod-ddns-with-bashshell's People

Contributors

kkkgo avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.