DDNS

!Test !Release ![Go Report Card]([***]

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

在博客中了解更多

动机

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

什么是DDNS

来自***

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

安装

从发布页面下载二进制文件到/usr/local/bin/ddns。

启动命令：

bash
ddns

或者您可以下载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
  gotify:
    read: below

通知

这些通知基于sirupsen/logrus hooks。 在配置文件中添加如下：

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

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

支持的通知列表：

SMTP

yaml
smtp:
  user: "***"
  password: "1234"
  host: "localhost"
  port: "22"
  to: "***"
  subject: "我的DDNS发送消息"
  secure: true # 可选标志。如果使用SSL发送邮件，请设置此项

***

yaml
***:
  token: "***机器人令牌"
  chat_id: "1234"

Gotify

yaml
gotify:
  app_url: "[***]" # gotify的URL
  app_token: "" # gotify应用的令牌
  title: "DDNS" # 消息的可选标题，默认为DDNS