lcotonea/gandilivedns
lcotonea
这是一款针对Gandi域名 registrar的Python3动态DNS更新工具，通过LiveDNS REST API将指定子域名的A记录更新为运行主机的外部IPv4地址，支持多子域名及自定义IP查询服务。
下载次数: 0状态：社区镜像维护者：lcotonea仓库类型：镜像最近更新：5 年前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
gandi-live-dns镜像说明
镜像概述
本镜像为原始gandi-live-dns项目的Python3移植版本，是一款轻量的动态DNS更新工具，专为Gandi域名 registrar设计。它利用Gandi官方的LiveDNS REST API，自动将指定子域名的A记录同步到运行该镜像的主机的外部IPv4地址，解决动态IP场景下域名访问的稳定性问题。
核心功能
- 多子域名支持: 可同时更新多个子域名的A记录
- 灵活IP查询: 支持自定义IP查询服务（包括公共服务和自托管服务）
- API驱动: 基于Gandi v5 REST API实现，更新高效可靠
使用场景
- 家庭服务器: 家庭NAS、个人博客等服务在动态IP环境下，通过固定子域名（如home.example.com）保持可访问性
- 小型站点: 托管在动态IP上的小型网站或应用，确保用户始终通过一致域名访问
- 远程办公: 远程访问内部服务时，避免因IP变化导致连接失败
配置说明
环境变量
运行镜像需配置以下环境变量：
- TOP_TLD: 顶级域名（例如：example.com）
- SUB_DOMAINS_ARRAY: 需要更新的子域名数组（格式：
["www", "home"]） - LOOKUP_URL: 获取外部IP的服务地址（例如：
https://ifconfig.co/ip） - GANDI_SECRET_API_KEY: Gandi生产环境API密钥（从[***]
前置步骤
- 申请API密钥: 登录Gandi账户，在API设置中申请生产环境密钥
- 创建A记录: 在Gandi域名管理界面，为目标子域名创建初始A记录
部署示例
Docker Run命令
bashdocker run -d \ --name gandi-live-dns \ -e TOP_TLD="example.com" \ -e SUB_DOMAINS_ARRAY='["www", "home"]' \ -e LOOKUP_URL="https://ifconfig.co/ip" \ -e GANDI_SECRET_API_KEY="你的Gandi API密钥" \ lcotonea/gandilivedns
自托管IP查询服务
若需自托管IP查询服务，可部署简单PHP方案：
- 将https://github.com/cavebeat/gandi-live-dns/blob/master/src/example-index.php%E6%94%BE%E7%BD%AE%E5%88%B0LAMP%E6%9C%8D%E5%8A%A1%E5%99%A8%E7%9A%84%60/ip%60%E7%9B%AE%E5%BD%95
- 访问
https://你的域名/ip/验证IP返回功能 - 将
LOOKUP_URL设置为该地址（例如：https://blog.yourdomain.com/ip/）
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 gandilivedns 镜像标签
docker pull docker.xuanyuan.run/lcotonea/gandilivedns:<标签>
DockerHub 原生拉取命令
docker pull lcotonea/gandilivedns:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"