免费简单的动态域名解析DDNS实现！（基于Cloudflare）

# CloudFalre DDNS

Github仓库地址：https://github.com/dingdangdog/cloudflare_ddns

简单的脚本快速实现基于Cloudflare的DDNS。

## 安装

> 🧨**提示**：无论自动还是手动安装，请自行修改配置 `config.json` ！如果使用其他获取IP服务，请自行修改源码（如果无需授权等，可以尝试不修改源码）

### 自动安装

- ddns_client

```sh
curl -sSL https://github.com/dingdangdog/cloudflare_ddns/raw/main/script/update_ddns.sh | bash
```

修改配置并运行 `ddns_client`。

- whoisme_server

```sh
curl -sSL https://github.com/dingdangdog/cloudflare_ddns/raw/main/script/update_whoisme.sh | bash
```

修改配置并运行 `whoisme_server`。

<!-- more -->

### 手动安装

1. 在 [Last Release](https://github.com/dingdangdog/cloudflare_ddns/releases) 中下载 `ddns_client` 或 `whoisme_server`，或者自行 [打包ddns_client](#打包ddns_client) / [打包whoisme_server](#打包whoisme_server)；
2. 下载 ddns_client [配置示例](./ddns/config demo.json) 或者 whoisme_server [配置示例](./ip/config_demo.json) 到你的设备，重命名为 `config.json`，然后编辑你的配置信息；
3. 运行 `ddns_client` 或 `whoisme_server`。

## ddns

- [ddns.go](./ddns/ddns.go)

功能：想办法拿到真实 `IP`，拿到 `IP` 后调用 `Cloudflare API` 修改 `DNS` 记录。

用法：部署到你的动态公网IP主机上，修改 [配置信息](./ddns/config_demo.json) 运行即可。

### 打包ddns_client

> **提示**：下面是在 `Windows` 开发环境中的示例，请使用 `CMD` 终端命令行执行命令，不要在 `PowerShell` 中执行，否则打包的结果可能无法正常执行

```bash
# 打包Linux二进制文件，在Windows开发环境下的打包方式
cd ddns
SET GOOS=linux
SET GOARCH=amd64

go build -o ddns_client ddns.go
```

### 配置参数说明

- [ddns/config_demo.json](./ddns/config_demo.json)

```json
{
  "CLOUDFLARE": {
    "CF_API_TOKEN": "xx", // 请自行获取你的 Cloudflare 配置
    "CF_ZONE_ID": "xxx", // 请自行获取你的 Cloudflare 配置
    "CF_RECORD_ID": "xxx", // 请自行获取你的 Cloudflare 配置
    "DNS_TYPE": "A",
    "DNS_DOMAIN_NAME": "xxx.com", // 要设置的 DNS 域名
    "DNS_DOMAIN_CONTENT": "xxx.com", // 暂时没用
    "DNS_TTL": 1, // 填1会使用cloudflare默认值
    "DNS_PROXIED": false
  },
  "IP_API_URL": "http://xxx.com/whoisme", // 获取 真实公网IP 的接口
  "DDD_CLIENT_ID": 0, // whoisme接口授权id
  "DDD_CLIENT_KEY": "Test_Cilent_Key", // whoisme接口授权key
  "MODE": "development",
  "INTERVAL": 180
}
```

**PS：如果你不会配置，欢迎评论交流，提的人多了可以单独写一篇文章详细介绍如何获取配置项并配置！**

## ip

- [whoisme.go](./ip/whoisme.go)

功能：一个简单的获取客户端公网IP并返回的服务。

用法：部署到你的另一台公网服务器上，`ddns_client` 请求服务器的这个接口，获取客户端真实IP并返回。

### 打包whoisme_server

> **提示**：下面是在 `Windows` 开发环境中的示例，请在 `CMD` 终端命令行执行命令，不要在 `PowerShell` 中执行，否则打包的结果可能无法正常执行

```bash
# 打包Linux二进制文件，在Windows开发环境下的打包方式
cd ip
SET GOOS=linux
SET GOARCH=amd64

go build -o whoisme_server whoisme.go
```