自动更新 DNS 解析 到本机 IP 地址,支持 ipv4 和 ipv6 以 本地(内网)IP 和 公网 IP。 代理模式,支持自动创建域名记录。
根据需要选择一种方式: 二进制
版,pip
版,源码
运行,或者Docker
pip install ddns
或 easy_install ddns
ddns
run.bat
或者运行python run.py
)docker run -d \
-e DDNS_DNS=dnspod \
-e DDNS_ID=12345 \
-e DDNS_TOKEN=mytokenkey \
-e DDNS_IPV4=ddns.newfuture.cc \
-e DDNS_IPV6=ddns.newfuture.cc \
--network host \
newfuture/ddns
docker run -d \
-v /path/to/config.json:/config.json \
--network host \
newfuture/ddns
申请 api token
,填写到对应的id
和token
字段:
email + API KEY
,也可使用Token
需要列出 Zone 权限)token
字段,id
字段可留空)修改配置文件,ipv4
和ipv6
字段,为待更新的域名,详细参照配置说明
所有字段可通过三种方式进行配置
ddns --key=value
(ddns -h
查看详情),优先级最高${ddns_key}
或 ${DDNS_KEY}
)-c
使用指定的配置文件 (默认读取当前目录的 config.json)ddns -c path/to/config.json
# 或者源码运行
python run.py -c /path/to/config.json
key | type | required | default | description | tips |
---|---|---|---|---|---|
id | string | √ | 无 | api 访问 ID | Cloudflare 为邮箱(使用 Token 时留空) HE.net 可留空 华为云为 Access Key ID (AK) |
token | string | √ | 无 | api 授权 token | 部分平台叫 secret key , 反馈粘贴时删除 |
dns | string | No | "dnspod" |
dns 服务商 | 阿里 DNS 为alidns ,Cloudflare 为 cloudflare ,dns.com 为 dnscom ,DNSPOD 国内为 dnspod ,DNSPOD 国际版为 dnspod_com ,HE.net 为 he ,华为 DNS 为 huaweidns ,自定义回调为 callback
|
ipv4 | array | No | [] |
ipv4 域名列表 | 为[] 时,不会获取和更新 IPv4 地址 |
ipv6 | array | No | [] |
ipv6 域名列表 | 为[] 时,不会获取和更新 IPv6 地址 |
index4 | string|int|array | No | "default" |
ipv4 获取方式 | 可设置网卡 ,内网 ,公网 ,正则 等方式 |
index6 | string|int|array | No | "default" |
ipv6 获取方式 | 可设置网卡 ,内网 ,公网 ,正则 等方式 |
ttl | number | No | null |
DNS 解析 TTL 时间 | 不设置采用 DNS 默认策略 |
proxy | string | No | 无 | http 代理; 分割 |
多代理逐个尝试直到成功,DIRECT 为直连 |
debug | bool | No | false |
是否开启调试 | 运行异常时,打开调试输出,方便诊断错误 |
cache | string|bool | No | true |
是否缓存记录 | 正常情况打开避免频繁更新,默认位置为临时目录下ddns.cache ,也可以指定一个具体文件实现自定义文件缓存位置 |
0
,1
,2
,3
等): 第 i 个网卡 ip"default"
(或者无此项): 系统访问外网默认 IP"public"
: 使用公网 ip(使用公网 API 查询,url 的简化模式)"url:xxx"
: 打开 URL xxx
(如:"url:http://ip.sb"
),从返回的数据提取 IP 地址"regex:xxx"
正则表达(如"regex:192.*"
): 提取ifconfig
/ipconfig
中与之匹配的首个 IP 地址,注意 json 转义(\
要写成\\
)
"192.*"
表示 192 开头的所有 ip10.00.xxxx
应该写成"regex:10\\.00\\..\*"
("\\"
json 转义成\
)"cmd:xxxx"
: 执行命令xxxx
的 stdout 输出结果作为目标 IP"shell:xxx"
: 使用系统 shell 运行xxx
,并把结果 stdout 作为目标 IPfalse
: 强制禁止更新 ipv4 或 ipv6 的 DNS 解析["public", "172.*"]
将先查询公网API,未获取到IP后再从本地寻找172开头的IPid
字段填写回调地址,以 HTTP 或 HTTPS 开头,推荐采用 HTTPS 方式的回调 API ,当 token
字段非空且 URL 参数包含下表所示的常量字符串时,常量会被程序替换为实际值token
字段为 POST 参数,本字段为空或不存在则使用 GET 方式发起回调,回调参数采用 JSON 格式编码,当 JSON 的首层参数值包含下表所示的常量字符串时,常量会被程序替换为实际值常量名称 | 常量内容 | 说明 |
---|---|---|
__DOMAIN__ |
DDNS 域名 | |
__RECORDTYPE__ |
DDNS 记录类型 | |
__TTL__ |
DDNS TTL | |
__TIMESTAMP__ |
请求发起时间戳 | 包含小数 |
__IP__ |
获取的对应类型的IP地址 |
{
"$schema": "https://ddns.newfuture.cc/schema/v2.8.json",
"id": "12345",
"token": "mytokenkey",
"dns": "dnspod 或 dnspod_com 或 alidns 或 dnscom 或 cloudflare 或 he 或 huaweidns 或 callback",
"ipv4": ["ddns.newfuture.cc", "ipv4.ddns.newfuture.cc"],
"ipv6": ["ddns.newfuture.cc", "ipv6.ddns.newfuture.cc"],
"index4": 0,
"index6": "public",
"ttl": 600,
"proxy": "127.0.0.1:1080;DIRECT",
"debug": false
}
task.bat
(或者在管理员命令行中运行)task.bat
(执行时会闪黑框)sudo ./task.sh
安装:
sudo ./systemd.sh install
卸载:
sudo ./systemd.sh uninstall
该脚本安装的文件符合 Filesystem Hierarchy Standard (FHS):
可执行文件所在目录为 /usr/share/DDNS
配置文件所在目录为 /etc/DDNS
Docker镜像在无额外参数的情况下,已默认启用每5分钟执行一次的定时任务
Windows Server 默认安全策略会禁止任何未添加的信任 ssl 证书,可手动添加一下对应的证书 #56
使用系统自带的 IE 浏览器访问一次对应的 API 即可