自动更新 DNS 解析 到本机 IP 地址,支持 ipv4 和 ipv6 以 本地(内网)IP 和 公网 IP。 代理模式,支持自动创建域名记录。

• 兼容和跨平台:
  • 可执行文件(无需 python 环境)
  • 多系统兼容
  • python3 支持 (2.x支持python2和python3)
  • PIP 安装
  • Docker 支持(@NN708)
• 域名支持:
  • 多个域名支持
  • 多级域名解析
  • 自动创建新记录
• IP 类型:
  • 内网 IPv4 / IPv6
  • 公网 IPv4 / IPv6 (支持自定义 API)
  • 自定义命令(shell)
  • 正则选取支持(@rufengsuixing)
• 网络代理:
  • http 代理支持
  • 多代理自动切换
• 服务商支持:
  • DNSPOD
  • 阿里 DNS
  • DNS.COM(@loftor-git)
  • DNSPOD 国际版
  • CloudFlare(@tongyifan)
  • HE.net(@NN708) (不支持自动创建记录)
  • 华为云(@cybmp3)
• 其他:
  • 可设置定时任务
  • TTL 配置支持
  • 本地文件缓存(减少 API 请求)
  • 地址变更时触发自定义回调API(与 DDNS 功能互斥)

根据需要选择一种方式: 二进制版,pip版,源码运行,或者Docker

• pip 安装(需要 pip 或 easy_install)

  1. 安装 ddns: pip install ddns 或 easy_install ddns
  2. 运行: ddns

• 二进制版(单文件,无需 python)

  • Windows ddns.exe
  • Linux (仅 Ubuntu 测试) ddns
  • Mac OSX ddns-osx

• 源码运行(无任何依赖, 需 python 环境)

  1. clone 或者下载此仓库并解压
  2. 运行./run.py (widnows 双击run.bat或者运行python run.py)

• Docker(需要安装 Docker)

  • 使用环境变量：

    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
    

1. 申请 api token,填写到对应的id和token字段:

   • DNSPOD(国内版)创建 token
   • 阿里云 accesskey
   • DNS.COM API Key/Secret
   • DNSPOD(国际版)
   • CloudFlare API Key (除了email + API KEY,也可使用Token需要列出 Zone 权限)
   • HE.net DDNS 文档（仅需将设置的密码填入token字段，id字段可留空）
   • 华为 APIKEY 申请（点左边访问密钥，然后点新增访问密钥）
   • 自定义回调的参数填写方式请查看下方的自定义回调配置说明

2. 修改配置文件,ipv4和ipv6字段，为待更新的域名,详细参照配置说明

所有字段可通过三种方式进行配置

1. 命令行参数 ddns --key=value (ddns -h 查看详情)，优先级最高
2. JSON配置文件(值为null认为是有效值，会覆盖环境变量的设置，如果没有对应的key则会尝试试用环境变量)
3. 环境变量DDNS_前缀加上key 全大写或者全小写 (${ddns_key} 或 ${DDNS_KEY})

ddns -c path/to/config.json
# 或者源码运行
python run.py -c /path/to/config.json

{
  "$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
}