DDNS Updater 项目教程

1. 项目的目录结构及介绍

DDNS Updater 项目的目录结构如下：

ddns-updater/
├── cmd/
│   └── ddns-updater/
│       ├── main.go
│       └── ...
├── docs/
│   └── ...
├── internal/
│   └── ...
├── k8s/
│   └── ...
├── pkg/
│   └── ...
├── .dockerignore
├── .gitignore
├── .golangci.yml
├── .markdownlint.json
├── Dockerfile
├── LICENSE
├── README.md
├── config.json
├── docker-compose.yml
├── go.mod
├── go.sum
└── ...

目录介绍

• cmd/ddns-updater/: 包含项目的主程序文件 main.go。
• docs/: 包含项目的文档文件。
• internal/: 包含项目的内部实现代码。
• k8s/: 包含 Kubernetes 相关配置文件。
• pkg/: 包含项目的公共库代码。
• .dockerignore: Docker 构建时忽略的文件列表。
• .gitignore: Git 版本控制时忽略的文件列表。
• .golangci.yml: GolangCI-Lint 配置文件。
• .markdownlint.json: Markdown 格式检查配置文件。
• Dockerfile: Docker 镜像构建文件。
• LICENSE: 项目许可证文件。
• README.md: 项目说明文档。
• config.json: 项目配置文件。
• docker-compose.yml: Docker Compose 配置文件。
• go.mod: Go 模块依赖文件。
• go.sum: Go 模块依赖校验文件。

2. 项目的启动文件介绍

项目的启动文件位于 cmd/ddns-updater/main.go。这个文件是整个项目的入口点，负责初始化配置、启动服务等操作。

主要功能

• 读取配置文件 config.json。
• 初始化 DDNS 更新服务。
• 启动 HTTP 服务器，提供 WebUI。

3. 项目的配置文件介绍

项目的配置文件是 config.json，它包含了 DDNS 服务的配置信息。

配置文件示例

[
  {
    "provider": "namecheap",
    "domain": "sub.example.com",
    "password": "e5322165c1d74692bfa6d807100c0310"
  }
]

配置项说明

• provider: DDNS 服务提供商，如 namecheap、cf 等。
• domain: 需要更新的域名。
• password: DDNS 服务的密码或令牌。

通过以上配置，项目可以自动检测外部 IP 地址的变化，并更新相应的 DNS 记录。

---

以上是 DDNS Updater 项目的教程，涵盖了项目的目录结构、启动文件和配置文件的介绍。希望这些信息能帮助你更好地理解和使用该项目。