這里主要說的是linux shell下的使用。
先看接口說明:
- 接口地址:
- HTTP請求方式:
-
- POST
- 請求參數:
-
- 公共參數
- domain_id 或 domain, 分別對應域名ID和域名, 提交其中一個即可
- record_id 記錄ID,必選
- sub_domain 主機記錄,如 www
- record_line 記錄線路,通過API記錄線路獲得,中文,比如:默認,必選
- record_line_id 線路的ID,通過API記錄線路獲得,英文字符串,比如:‘10=1’ 【record_line 和 record_line_id 二者傳其一即可,系統優先取 record_line_id】
- value IP地址,例如:6.6.6.6,可選
- 響應代碼:
-
- 共通返回
- -15 域名已被封禁
- -7 企業賬號的域名需要升級才能設置
- -8 代理名下用戶的域名需要升級才能設置
- 6 域名ID錯誤
- 7 不是域名所有者或沒有權限
- 8 記錄ID錯誤
- 21 域名被鎖定
- 22 子域名不合法
- 23 子域名級數超出限制,比如免費套餐域名不支持三級域名
- 24 泛解析子域名錯誤,比如免費套餐載名不支持 a*
- 25 輪循記錄數量超出限制,比如免費套餐域名只能存在兩條輪循記錄
- 26 記錄線路錯誤,比如免費套餐域名不支持移動、國外
- 注意事項:
-
- 如果1小時之內,提交了超過5次沒有任何變動的記錄修改請求,該記錄會被系統鎖定1小時,不允許再次修改,所以在開發和測試的過程中,請自行處理IP變動,僅在本地IP發生變動的情況下才調用本接口。
- 如何理解沒有任何變動的記錄修改請求?比如原記錄值已經是 1.1.1.1,新的請求還要求修改為 1.1.1.1。
示例:
curl -X POST https://dnsapi.cn/Record.Ddns -d 'login_token=LOGIN_TOKEN&format=json&domain_id=2317346&record_id=16894439&record_line_id=10%3D3&sub_domain=www'
首先你要去注冊域名,freenom有免費的頂級域名。隨便注冊一個,改DNS服務器為dnspod的。
把ns服務器改為dnspod的免費服務器,土豪盡管去dnspoe注冊.com,使用收費服務器。
等待大概24小時生效。
到DNSPOD登記注冊,你已經注冊的域名。
在DNSPOD開啟token
API Token 生成方法詳見:https://support.dnspod.cn/Kb/showarticle/tsid/227/,完整的 API Token 是由 ID,Token 組合而成的,用英文的逗號分割
記下ID TOKEN,token以后是不會顯示的,一定記清楚,推薦記在keepass,我在用的密碼管理軟件。
我添加了一條home的記錄,記錄類型為A.
原來是用客戶端獲取一些信息,客戶端也找不到了,那就用API吧。
這是wget的一個更新動態域名的命令。所有的***根據你的情況填寫。
wget --no-check-certificate --post-data "login_token=*****,*********************&format=json&domain_id=******&record_id=******&record_line_id=10=0&sub_domain=****" https://dnsapi.cn/Record.Ddns
這是curl的一個更新動態域名的命令。所有的***根據你的情況填寫。
curl -X POST https://dnsapi.cn/Record.Ddns -d 'login_token=*****,*********************&format=json&domain_id=******&record_id=******&record_line_id=10=0&sub_domain=****'
login_token=完整的 API Token 是由 ID,Token 組合而成的,用英文的逗號分割
domain_id= 6217161 域名的ID
record_id=32837409 子域的ID
sub_domain=home 子域的名字
record_line_id=10=0 線路電信
獲取基本信息,驗證token配置正確:
wget --no-check-certificate --post-data "login_token=****,********************&format=json" https://dnsapi.cn/Info.Version
curl -X POST https://dnsapi.cn/Info.Version -d 'login_token=****,********************&format=json'
wget會保存一個文件
curl直接輸出在屏幕
這個json串,可以在線解析一下,方便看:
https://www.bejson.com/
獲取域名列表
wget --no-check-certificate --post-data "login_token=****,********************&format=json" https://dnsapi.cn/Domain.List
curl -X POST https://dnsapi.cn/Domain.List -d 'login_token=****,********************&format=json'
再去解析
這個ID,就是你的domain_id
獲取域名列表
wget --no-check-certificate --post-data 'login_token=****,********************&format=json&domain_id=62171614' https://dnsapi.cn/Record.List
curl -X POST https://dnsapi.cn/Record.List -d 'login_token=****,********************&format=json&domain_id=62171614'
解析后,找到要動態解析的子域id,或者說要用的域名的id,子域的名字
我這里找的是home,就是給家里的路由找個動態域名,出門在外也能找到回家的路。
login_token=
domain_id= 62171614
record_id=328374092
sub_domain=home
現在我們關心的數據都查出來了,重新組合一下:
wget --no-check-certificate --post-data "login_token=**,********,41a8ac7ce3039d8e7eb087ff534763d1&format=json&domain_id=62171614&record_id=328374092&record_line_id=10=0&sub_domain=home" https://dnsapi.cn/Record.Ddns
curl -X POST https://dnsapi.cn/Record.Ddns -d "login_token=**,********&format=json&domain_id=62171614&record_id=328374092&record_line_id=10=0&sub_domain=home"
在命令行里訪問一下,看你的域名解析是不是已經變成你的IP了。
只是record_line_id沒有說明,只寫了個10=0。我也沒怎么理解它是什么意思。難道是類似於CDN加速的東西?
我是電信線路,就先寫上電信的ID了。
"line_ids": {
"默認": 0,
"國內": "7=0",
"國外": "3=0",
"電信": "10=0",
"聯通": "10=1",
"教育網": "10=2",
"移動": "10=3",
"百度": "90=0",
"谷歌": "90=1",
"搜搜": "90=4",
"有道": "90=2",
"必應": "90=3",
"搜狗": "90=5",
"奇虎": "90=6",
"搜索引擎": "80=0"
},
在路由上嘗試一下這個shell命令
暈吧
wget不支持https
curl沒有這個命令
安裝吧。
openwrt--系統--軟件包--過濾器--wget
wget
wget-nossl
安裝wget,就可以實現使用wget這個命令來更新ddns
安裝curl 就可以使用curl命令
不過openwrt的curl還要加一個-k參數,忽略證書。
下面說怎么在openwrt中使用這個,創建/etc/hotplug.d/iface/30-dnspod.sh
文件內容如下#!/bin/sh
#!/bin/sh # wan ifup [ $ACTION = "ifup" -a $INTERFACE = "wan" ] curl -X POST https://dnsapi.cn/Record.Ddns -k -d "login_token=***,****&format=json&domain_id=62171614&record_id=328374092&record_line_id=10=0&sub_domain=home"
curl命令中增加了-k,或略服務器HTTPS效驗
#!/bin/sh # wan ifup [ $ACTION = "ifup" -a $INTERFACE = "wan" ] wget --no-check-certificate --output-document=/dev/null --post-data "login_token=***,******&format=json&domain_id=62171614&record_id=328374092&record_line_id=10=0&sub_domain=home" https://dnsapi.cn/Record.Ddns
wget命令中增加了--output-document=/dev/null,不保存返回文件。
這個意思就是WAN口上線30秒以后,執行這個wget請求,請求到dnspod的ddns更新接口,就實現了注冊。