wojteek/dynhost

DynHost

这是一个用于获取并同步外部IP地址到OVH或Cloudflare DNS记录的工具，帮助在动态IP环境下维护域名解析的正确性。

开发动机

该工具使用Golang开发，初衷是解决OVH DynHost的IP更新需求——由于互联网服务提供商无法保证IP地址永久不变，需要自动更新DNS记录以保持域名解析有效。

使用场景

适用于动态IP场景，例如在树莓派上搭建Open***服务时，通过该工具自动更新域名对应的IP，避免因IP变化导致服务无法访问。

使用方法

bash
./bin/dynhost [全局选项] 命令 [命令选项] [参数...]

Docker（推荐）

运行Docker镜像：

bash
docker run -v $(pwd)/data.json:/app/data.json wojteek/dynhost:latest --help

可使用特定版本标签替代latest。

docker-compose.yml示例

yaml
version: "3"
services:
  dynhost:
    image: wojteek/dynhost:latest
    command: [
      "--timer=15m",
      "cloudflare",
      "--auth-token=YOUR_AUTH_TOKEN",
      "--zone-id=YOUR_ZONE_ID",
      "--dns-id=YOUR_DNS_ID",
      "--hostname=dynhost.example.com",
    ]
    container_name: "dynhost"
    restart: always
    volumes:
      - ./data.json:/app/data.json:rw

从源码构建

执行以下命令构建工具：

bash
make build-app

全局选项

--data value    设置应用数据JSON文件路径（默认："data.json"）
--timer value   设置自动检查外部IP的间隔（默认：0s）
--debug         启用调试模式（默认：false）
--help, -h      显示帮助信息（默认：false）
--version, -v   打印版本号（默认：false）

命令列表

cloudflare [命令选项] [参数...] - Cloudflare提供商

注意：请勿使用Cloudflare全局API密钥，推荐创建具有Zone.DNS编辑权限的API Token（可指定具体域名）。

选项

--auth-token value  Cloudflare API认证令牌 [$CLOUDFLARE_AUTH_TOKEN]
--zone-id value     域名区域ID（Cloudflare DNS） [$CLOUDFLARE_ZONE_ID]
--dns-id value      DNS记录ID（Cloudflare DNS） [$CLOUDFLARE_DNS_ID]
--hostname value    主机名（Cloudflare DNS） [$CLOUDFLARE_HOSTNAME]

ovh [命令选项] [参数...] - OVH提供商

若未获取DynHost凭证，请参考OVH文档。

选项

--auth-username value  DynHost认证用户名 [$OVH_AUTH_USERNAME]
--auth-password value  DynHost认证密码 [$OVH_AUTH_PASSWORD]
--hostname value       DynHost主机名 [$OVH_HOSTNAME]

自动启动

若需设置自动启动，推荐使用systemd。以下是示例配置（需根据自身环境调整）：

ini
[Unit]
Description="DynHost"

[Service]
User=YOUR_USER
ExecStart=/path/to/dynhost [全局选项] 命令 [命令选项] [参数...]
Restart=always
RestartSec=10s
KillMode=process
TimeoutSec=infinity

[Install]
WantedBy=multi-user.target

在Raspbian系统中，配置文件通常位于/lib/systemd/system/dynhost.service。