numero33/godo-ddns

GODO-DDNS

Golang DigitalOcean DynDNS（DigitalOcean动态DNS更新器）

适用于Synology设备

镜像概述和主要用途

GODO-DDNS是一个基于Golang开发的轻量级动态DNS更新工具，专门用于DigitalOcean DNS服务。它允许用户通过简单的HTTP请求动态更新域名的IPv4地址记录，特别适用于需要动态IP地址的场景（如家庭服务器、NAS设备等），且已验证可在Synology设备上正常工作。

核心功能和特性

• 简单易用：通过HTTP请求即可完成DNS记录更新
• 轻量高效：基于Golang开发，资源占用低，运行效率高
• DigitalOcean集成：直接对接DigitalOcean API，实现DNS记录动态更新
• 灵活部署：支持Docker容器化部署，也可本地编译运行

使用场景和适用范围

• 家庭网络中需要动态解析IP的设备（如Synology NAS）
• 个人服务器或小型服务，需要通过域名访问但IP地址不固定的场景
• 需要自动化维护DNS记录的开发者或系统管理员

使用方法和配置说明

基本使用

通过HTTP GET请求触发DNS更新，请求格式如下：

bash
curl 'https://yourdomain.com/update?h=__HOSTNAME__&ip=__MYIP__&p=__PASSWORD__'

参数说明：

• __HOSTNAME__：需要更新的主机名（域名）
• __MYIP__：当前的IPv4地址
• __PASSWORD__：DigitalOcean API令牌（需从DigitalOcean Apps & API获取）

Docker部署

Docker镜像地址：https://hub.docker.com/r/numero33/godo-ddns

基本部署命令：

bash
docker run -d -p 80:8080 -e GODOHOST=8080 numero33/godo-ddns

参数说明：

• -p 80:8080：将容器内的8080端口映射到主机的80端口（可根据需求调整）
• -e GODOHOST=8080：设置服务监听端口（容器内部端口）

本地构建

如果需要本地编译运行，可执行以下步骤：

bash
# 编译可执行文件
go build -o godo-ddns

# 添加执行权限
chmod +x godo-ddns

# 运行服务（示例监听80端口）
GODOHOST=":80" ./godo-ddns

环境变量说明：

• GODOHOST：设置服务监听地址和端口，格式为":端口号"（如":8080"表示监听所有网络接口的8080端口）