texasaggie97/hover-dns-updater

hover-dns-updater 镜像文档

镜像概述

hover-dns-updater是一款用于动态更新Hover DNS记录的工具，可根据当前外部IP地址自动更新一个或多个DNS条目。支持两种运行模式：单次更新或持续监控（按设定时间间隔检查IP变化）。该工具基于Andrew Barilla的脚本开发，支持2FA认证，适用于需要动态DNS功能的个人或小型网络环境。

版本：1.0.1
许可证：GPL
作者：Mark Silva（基于Andrew Barilla的脚本），lmann99（添加2FA支持）

核心功能与特性

• 动态IP同步：自动检测外部IP变化并更新Hover DNS记录
• 多记录支持：可同时更新多个DNS条目
• 灵活运行模式：支持单次更新或持续监控（自定义检查间隔）
• 安全认证：支持Hover账号2FA（TOTP）认证
• 日志记录：可配置日志文件路径，便于问题排查
• 跨平台部署：支持直接运行、Ubuntu服务部署及Docker容器化部署

使用场景

• 家庭网络服务器（如NAS、个人网站）需要动态DNS解析
• 小型办公网络中需将动态公网IP与域名绑定
• 任何需要将动态IP地址自动同步到Hover DNS记录的场景

详细使用方法

前提条件

• Python 3.10及以上
• pip（Python包管理工具）
• Poetry（Python依赖管理工具）

配置准备

获取Hover TOTP密钥

1. 登录Hover.com
2. 启用2FA，手动设置移动应用并记录 secret key（TOTP密钥）
3. 移除密钥中的空格（如从"xxxx xxxx xxxx xxxx xxxx xxxx xx"格式中去除空格）

获取Hover DNS ID

1. 登录Hover.com
2. 在同一浏览器中访问https://www.hover.com/api/domains/YOURDOMAIN.COM/dns（将YOURDOMAIN.COM替换为实际域名）
3. 在返回的JSON数据中，找到需更新的DNS记录对应的"id"（格式类似"dns***"）

Docker部署

构建镜像

bash
docker build -t hover-dns-updater . 
docker tag hover-dns-updater texasaggie97/hover-dns-updater:latest texasaggie97/hover-dns-updater:v1.0.1 
docker push texasaggie97/hover-dns-updater

运行容器（基础模式）

bash
docker run -d \
  -e USERNAME="your_hover_username" \
  -e PASSWORD="your_hover_password" \
  -e TOPTKEY="your_totp_secret_key" \
  -e DNS1="dns00000000" \
  -e DNS2="dns00000001" \
  -e LOGFILE="/logs/hover-dns-updater.log" \
  -v /path/to/logs:/logs \
  --name hover-dns-updater \
  texasaggie97/hover-dns-updater \
  python hover-dns-updater.py --service

Docker Compose配置（RancherOS示例）

docker-compose.yml

yaml
version: '2'
volumes:
    logs:
        external: true
        driver: rancher-nfs

services:
    hover-dns-updater:
        image: texasaggie97/hover-dns-updater
        environment:
            USERNAME: "your_hover_username"
            PASSWORD: "your_hover_password"
            TOPTKEY: "your_totp_secret_key"
            DNS1: "dns00000000"
            DNS2: "dns00000001"
            LOGFILE: "/logs/docker-hover-dns-updater.log"
            POLLTIME: 600  # 检查间隔（秒），默认10分钟
        stdin_open: true
        working_dir: /hover-dns-updater
        volumes:
        - logs:/logs
        tty: true
        command:
        - python
        - hover-dns-updater.py
        - --service
        labels:
            io.rancher.container.pull_image: always

rancher-compose.yml

yaml
version: '2'
services:
    hover-dns-updater:
        scale: 1
        start_on_create: true

环境变量说明

故障排除

• 认证失败：检查用户名、密码及TOTP密钥是否正确（确保密钥无空格）
• DNS更新失败：确认DNS ID是否正确，可通过Hover API再次获取
• 日志无输出：检查LOGFILE路径是否可写，容器是否有权限访问日志目录
• 服务未启动：检查Docker容器状态或Ubuntu服务状态（sudo service hover-dns-updater status）

贡献与反馈

欢迎提交贡献！开发相关命令：

• poetry run black .：代码格式化
• poetry run flake8：代码检查
• poetry run pytest：运行测试

报告bug或提交功能需求，请访问https://github.com/texasaggie97/hover-dns-updater-new/issues%E3%80%82

许可证

hover-dns-updater采用GPL许可证（详见https://github.com/texasaggie97/hover-dns-updater-new/blob/master/LICENSE%EF%BC%89%E3%80%82%E5%85%B6%E4%BB%96%E9%9B%86%E6%88%90%E9%A1%B9%E7%9B%AE%E5%8F%AF%E8%83%BD%E9%87%87%E7%94%A8%E4%B8%8D%E5%90%8C%E8%AE%B8%E5%8F%AF%E8%AF%81%E3%80%82