mcfedr/ddns-do

ddns-do 镜像文档

镜像概述

ddns-do是一个基于Digital Ocean Domains的轻量级动态DNS更新器Docker镜像，用于自动检测并更新DNS记录。该镜像源自https://github.com/mthssdrbrg/ddns-route53%E9%A1%B9%E7%9B%AE%E7%9A%84%E5%88%86%E6%94%AF%EF%BC%8C%E4%B8%93%E9%97%A8%E8%B0%83%E6%95%B4%E4%BB%A5%E9%80%82%E9%85%8DDigital Ocean域名服务，简化动态IP环境下的DNS记录维护。

核心功能与特性

• 自动检测公网IP并更新Digital Ocean DNS记录
• 支持通过环境变量或命令行参数灵活配置
• 集成doctl工具与Digital Ocean API交互
• 可自定义DNS记录类型（默认A记录）和TTL（默认300秒）
• 支持在DNS记录变更时执行指定脚本
• 轻量级设计，仅依赖bash、dig和doctl基础工具

使用场景与适用范围

适用于需要动态维护DNS记录的场景：

• 家庭网络或小型办公网络（动态公网IP环境）
• 云服务器/VPS（IP地址可能变更的环境）
• 远程访问需求（如NAS、监控设备等需固定域名访问）
• 需自动维护Digital Ocean域名记录的个人或企业用户

使用方法与配置说明

前提条件

• 拥有Digital Ocean账号及已注册的域名
• 已在Digital Ocean控制台创建基础DNS记录（如A记录）
• 准备Digital Ocean访问令牌（可在Account > API > Personal Access Tokens创建）

拉取镜像

bash
docker pull mcfedr/ddns-do:latest

基本使用（docker run）

bash
docker run -d \
  -e DIGITALOCEAN_ACCESS_TOKEN="your_digitalocean_token" \
  -e DDNS_DO_DOMAIN="example.com" \
  -e DDNS_DO_RECORD="home" \
  --name ddns-do mcfedr/ddns-do

高级配置（含自定义TTL和变更脚本）

bash
docker run -d \
  -e DIGITALOCEAN_ACCESS_TOKEN="your_digitalocean_token" \
  -e DDNS_DO_DOMAIN="example.com" \
  -e DDNS_DO_RECORD="home" \
  -e DDNS_DO_TTL="600" \
  -e DDNS_DO_TYPE="A" \
  -v /host/path/change-script.sh:/scripts/change.sh \
  -e DDNS_DO_SCRIPT="/scripts/change.sh" \
  --name ddns-do mcfedr/ddns-do

docker-compose配置

yaml
version: '3'
services:
  ddns-do:
    image: mcfedr/ddns-do:latest
    environment:
      - DIGITALOCEAN_ACCESS_TOKEN=your_digitalocean_token
      - DDNS_DO_DOMAIN=example.com
      - DDNS_DO_RECORD=home
      - DDNS_DO_TTL=300
      - DDNS_DO_TYPE=A
      - DDNS_DO_SCRIPT=/scripts/change.sh
    volumes:
      - /host/path/change-script.sh:/scripts/change.sh
    restart: unless-stopped

环境变量说明

命令行参数说明

支持通过命令行参数覆盖环境变量配置（参数优先级更高）：

bash
docker run --rm mcfedr/ddns-do \
  --domain example.com \
  --record home \
  --ttl 600 \
  --type A

注意：不支持--long-option=形式的参数格式（如--domain=example.com），需使用空格分隔参数与值。

查看帮助信息

bash
docker run --rm mcfedr/ddns-do --help