jbbodart/gandi-livedns

gandi-livedns

镜像概述

gandi-livedns容器用于通过Gandi的LiveDNS服务（[***] IP更新DNS区域记录。该镜像基于Alpine Linux构建，极为轻量且依赖极少，实际的DNS更新程序完全通过shell脚本实现。

核心功能和特性

• 轻量级设计：基于Alpine Linux，镜像体积小，资源占用低
• 低依赖性：仅需基础系统组件，运行环境简单
• shell脚本实现：核心更新逻辑通过shell脚本编写，易于审计和修改
• 灵活配置：支持自定义更新间隔、TTL值，可分别控制IPv4/IPv6记录更新
• 强制IP指定：支持手动指定IPv4/IPv6地址用于DNS记录更新

配置说明

必填环境变量

• APIKEY：您的Gandi API密钥
• DOMAIN：您在Gandi托管的域名
• RECORD_LIST：需更新的DNS记录，使用分号";"分隔（如"blog;www;@"）

可选环境变量

• REFRESH_INTERVAL：更新间隔时间（默认：10分钟）
• TTL：DNS记录的生存时间（默认：300秒）
• SET_IPV4：是否更新A记录（默认：yes）
• SET_IPV6：是否更新AAAA记录（默认：no）
• FORCE_IPV4：强制用于A记录的IPv4地址（不指定则自动获取WAN IP）
• FORCE_IPV6：强制用于AAAA记录的IPv6地址（不指定则自动获取WAN IP）

使用示例

基本运行方式

通过docker run命令在后台运行，使用默认配置：

sh
docker run -d \
    -e "APIKEY=<您的Gandi API密钥>" \
    -e "RECORD_LIST=blog;www;@" \
    -e "DOMAIN=您的Gandi托管域名.com" \
    jbbodart/gandi-livedns

上述命令将每10分钟更新blog.您的Gandi托管域名.com、[*]

Docker Compose配置

使用docker-compose.yml和环境变量文件的方式部署：

docker-compose.yml

yaml
version: '3.7'
services:
  dyndns:
    image: jbbodart/gandi-livedns
    restart: unless-stopped
    env_file:
      - "dyndns.env"

dyndns.env

properties
APIKEY=<您的Gandi API密钥>
RECORD_LIST=blog;www;@
DOMAIN=您的Gandi托管域名.com
# 可选配置示例
# REFRESH_INTERVAL=15mn
# TTL=600
# SET_IPV6=yes

使用场景

适用于需要将动态WAN IP自动同步到Gandi DNS记录的场景，如家庭服务器、小型办公网络等需要通过域名访问动态IP设备的环境。