Gandi Live DNS 项目教程

Gandi Live DNS 项目教程

gandi-live-dns DynDNS Updater for Gandi LiveDNS REST API 项目地址: https://gitcode.com/gh_mirrors/ga/gandi-live-dns

1. 项目的目录结构及介绍

gandi-live-dns/
├── src/
│   ├── gandi-live-dns.py
│   ├── config.py
│   ├── example_config.py
│   ├── __init__.py
│   └── ...
├── README.md
├── LICENSE
└── ...

• src/: 包含项目的主要源代码文件。

  • gandi-live-dns.py: 项目的启动文件，负责更新DNS记录。
  • config.py: 项目的配置文件，包含API密钥、API端点、域名和子域名等信息。
  • example_config.py: 配置文件的示例，用户可以复制并修改此文件以创建自己的配置文件。
  • init.py: Python包的初始化文件。

• README.md: 项目的说明文档，包含项目的概述、安装和使用说明。

• LICENSE: 项目的许可证文件，本项目使用GPL-3.0许可证。

2. 项目的启动文件介绍

gandi-live-dns.py

gandi-live-dns.py 是项目的启动文件，负责执行以下任务：

• 检查当前计算机的外部IPv4地址。
• 通过Gandi LiveDNS REST API更新DNS记录。
• 支持命令行参数，如强制更新（-f 或 --force）。

启动文件的主要功能包括：

• IP地址检查: 通过外部服务获取当前计算机的外部IP地址。
• DNS记录更新: 比较当前IP地址与DNS记录中的IP地址，如果不同则更新DNS记录。
• 命令行参数: 支持-h（帮助信息）和-f（强制更新）参数。

3. 项目的配置文件介绍

config.py

config.py 是项目的配置文件，用户需要根据实际情况修改此文件以配置API密钥、API端点、域名和子域名等信息。

配置文件的主要内容包括：

• api_secret: Gandi API密钥，用于身份验证。
• api_endpoint: Gandi LiveDNS API的端点地址。
• domain: 需要更新的域名。
• subdomains: 需要更新的子域名列表。

示例配置文件内容如下：

api_secret = '---my_secret_API_KEY----'
api_endpoint = 'https://dns.api.gandi.net/api/v5'
domain = 'mydomain.tld'
subdomains = ["subdomain1", "subdomain2", "subdomain3"]

用户需要将example_config.py复制为config.py，并根据实际情况修改配置文件中的内容。

---

通过以上步骤，您可以成功配置和启动Gandi Live DNS项目，实现动态DNS更新功能。

gandi-live-dns DynDNS Updater for Gandi LiveDNS REST API 项目地址: https://gitcode.com/gh_mirrors/ga/gandi-live-dns