DDNS

以Digital Ocean Networking DNS为后端的个人DDNS客户端。

动机

我们有诸如DynDNS、No-IP等服务用于远程访问电脑。但我们真的需要它们吗？本项目是您自己的DDNS解决方案，并且可以免费使用（感谢Digital Ocean Networking DNS）。

什么是DDNS

来自***

动态DNS（DDNS或DynDNS）是一种自动更新域名系统（DNS）中名称服务器的方法，通常实时更新其配置的主机名、地址或其他信息的活动DDNS配置。

安装

二进制安装

从发布页面下载对应操作系统的二进制文件至/usr/local/bin/ddns，然后运行：

bash
ddns

Docker安装

下载Docker镜像并使用：

bash
docker run \
  -v /path/to/config.yml:/config/.ddns.yml \
  skibish/ddns -conf-file /config/.ddns.yml

注意！ 目前已在Linux和macOS上测试。

文档

运行ddns -h可查看帮助信息，输出如下：

text
Usage of ./ddns:
  -check-period duration
      检查IP是否变更的周期 (默认 5m0s)
  -conf-file string
      配置文件位置 (默认 "$HOME/.ddns.yml")
  -req-timeout duration
      外部资源请求超时时间 (默认 10s)
  -v  显示版本并退出

必须提供配置文件。 默认从$HOME/.ddns.yml读取。

您需要在Digital Ocean Networks面板中设置域名，并在域名提供商的配置中将域名指向Digital Ocean的NS记录。

参考：如何使用DigitalOcean设置主机名

配置文件格式

配置文件应采用以下格式：

yaml
token: "AMAZING TOKEN"                          # Digital Ocean令牌
domains:                                        # 要更新的域名
  - "example.com"
forceIPV6: true                                 # 使用IPv6地址解析（默认false，强制使用IPv4）
records:                                        # 要更新的域名记录
  - type: "A"                                   # 记录类型
    name: "www"                                 # 记录名称
  - type: "TXT"
    name: "demo"
    data: "My IP is {{.IP}} and I am {{.mood}}" # "data"键是可选的。您可以在此处编写任何内容，并引用"params"中的值。"IP"键是保留的。
params:
  mood: "cool"
notify:                                         # 可选通知配置
  smtp:
    read: below
  ***:
    read: below

通知

通知基于sirupsen/logrus hooks实现，在配置文件中添加如下格式的配置：

yaml
# 顶部配置部分
#...

notify:
  <通知名称>:
    # ...配置内容

支持的通知类型

SMTP

yaml
smtp:
  user: "***"          # 用户***
  password: "1234"             # 密码
  host: "localhost"            # SMTP主机
  port: "22"                   # SMTP端口
  to: "***"            # 收件人***
  subject: "My DDNS发送消息"   # 邮件主题
  secure: true                 # 可选标志。如果使用SSL发送邮件，需设置为true

***

yaml
***:
  token: "***机器人令牌"  # ***机器人令牌
  chat_id: "1234"              # 聊天ID