jdfischer/gandi-dynamic-dns

Gandi动态DNS更新工具镜像

镜像概述

该镜像提供一个脚本工具，用于动态更新Gandi托管域名的DNS记录，自动将指定域名记录指向当前外部IP地址。使用前需通过Gandi网站预先创建域名区域。

核心功能与特性

• 动态更新Gandi DNS记录，保持域名始终指向当前外部IP
• 支持通过环境变量或文件配置必要参数
• Docker容器模式下默认每1800秒（12小时）自动执行更新
• 轻量级设计，易于部署和集成到现有系统

使用场景

适用于需要动态IP地址的场景，如家庭网络服务器、个人VPS、临时部署环境等，确保域名解析始终指向当前可用IP。

使用方法

非Docker环境使用

需配置以下环境变量或在类路径根目录创建对应文件：

• API_KEY（必填）：Gandi API密钥，可通过环境变量设置或创建api_key文件
• API_URL（可选）：Gandi API URL，默认使用生产环境URL，可通过环境变量设置或创建api_url文件
• RECORD（必填）：要更新的DNS记录名称，可通过环境变量设置或创建record文件
• ZONE（必填）：域名区域名称（需以点结尾），可通过环境变量设置或创建zone文件

示例：要将alpha.betha.com指向当前IP，需确保Gandi账户中存在betha.com区域，此时ZONE设为betha.com.（注意结尾的点），RECORD设为alpha。

Docker容器使用

基本用法

通过Docker运行容器，设置必要的环境变量：

bash
docker run -d \
  -e API_KEY="your_gandi_api_key" \
  -e RECORD="alpha" \
  -e ZONE="betha.com." \
  --name gandi-dynamic-dns \
  jdfischer/gandi-dynamic-dns

Docker Compose配置

创建docker-compose.yml文件：

yaml
version: '3'
services:
  gandi-dynamic-dns:
    image: jdfischer/gandi-dynamic-dns
    environment:
      - API_KEY=your_gandi_api_key
      - RECORD=alpha
      - ZONE=betha.com.
    restart: always

启动容器：

bash
docker-compose up -d

配置参数说明

定时更新机制

Docker容器默认每1800秒（12小时）自动执行一次DNS更新，确保IP地址变化时能及时同步到DNS记录。