ronnieroller/ddns

DDNS

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

动机

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

什么是DDNS

来自***

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

安装

二进制安装

从https://github.com/skibish/ddns/releases%E4%B8%8B%E8%BD%BD%E5%AF%B9%E5%BA%94%E6%93%8D%E4%BD%9C%E7%B3%BB%E7%BB%9F%E7%9A%84%E4%BA%8C%E8%BF%9B%E5%88%B6%E6%96%87%E4%BB%B6%E8%87%B3%60/usr/local/bin/ddns%60%EF%BC%8C%E7%84%B6%E5%90%8E%E8%BF%90%E8%A1%8C%EF%BC%9A

bash
ddns

Docker安装

下载https://hub.docker.com/r/skibish/ddns%E5%B9%B6%E4%BD%BF%E7%94%A8%EF%BC%9A

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
  telegram:
    read: below

通知

通知基于https://github.com/sirupsen/logrus#hooks%E5%AE%9E%E7%8E%B0%EF%BC%8C%E5%9C%A8%E9%85%8D%E7%BD%AE%E6%96%87%E4%BB%B6%E4%B8%AD%E6%B7%BB%E5%8A%A0%E5%A6%82%E4%B8%8B%E6%A0%BC%E5%BC%8F%E7%9A%84%E9%85%8D%E7%BD%AE%EF%BC%9A

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

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

支持的通知类型

SMTP

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

***

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