skibish/ddns

DDNS

!https://github.com/skibish/ddns/workflows/run%20tests/badge.svg !https://github.com/skibish/ddns/workflows/release/badge.svg https://goreportcard.com/badge/github.com/skibish/ddns](https://goreportcard.com/report/github.com/skibish/ddns)

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

在博客中了解更多

动机

我们有诸如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%E4%BA%8C%E8%BF%9B%E5%88%B6%E6%96%87%E4%BB%B6%E5%88%B0%60/usr/local/bin/ddns%60%E3%80%82

启动命令：

bash
ddns

或者您可以下载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

文档

您可以从https://github.com/skibish/ddns/releases%E4%B8%8B%E8%BD%BD%E9%80%82%E7%94%A8%E4%BA%8E%E6%82%A8%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%E3%80%82

注意！ 目前已在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
  gotify:
    read: below

通知

这些通知基于https://github.com/sirupsen/logrus#hooks%E3%80%82 在配置文件中添加如下：

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

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

支持的通知列表：

SMTP

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

***

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

Gotify

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