# ddns4j-spring-boot-starter

**Repository Path**: Xsssd/ddns4j-spring-boot-starter

## Basic Information

- **Project Name**: ddns4j-spring-boot-starter
- **Description**: ddns4j-spring-boot-starter是一个简单好用的ddns聚合框架，帮您轻松集成多家dns服务并且支持动态解析.使您高效率的发布springboot应用及调试接口.你的 ⭐️ ⭐️⭐️Star⭐️⭐️ ⭐️，是我的动力！如果你觉得还不错，请点上一颗小星星
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: https://sssd.top
- **GVP Project**: No

## Statistics

- **Stars**: 27
- **Forks**: 1
- **Created**: 2023-10-08
- **Last Updated**: 2024-12-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: spring-boot-starter, ddns, IPv4, IPV6, 域名解析

## README

<h1 align="center" style="margin: 30px 0 30px; font-weight: bold;">ddns4j-spring-boot-starter v1.0.4</h1>
<h4 align="center" style="margin: 30px 0 30px; font-weight: bold;">DDNS4J -- 让动态域名解析变的更简单</h4>

<p align="center">
<a href='https://gitee.com/Xsssd/ddns4j-spring-boot-starter/stargazers'><img src='https://gitee.com/Xsssd/ddns4j-spring-boot-starter/badge/star.svg?theme=dark' alt='star'></img></a>
<a href='https://gitee.com/Xsssd/ddns4j-spring-boot-starter/members'><img src='https://gitee.com/Xsssd/ddns4j-spring-boot-starter/badge/fork.svg?theme=dark' alt='fork'></img></a>
<a href='https://img.shields.io/badge/license-apache-blue'><img src='https://img.shields.io/badge/license-apache-blue'></img></a>
</p>

## 简介
>`ddns4j-spring-boot-starter` 是一个用于集成 DDNS4J 到 Spring Boot 应用的 Starter。DDNS4J 是一个完全开源的 DDNS 服务，支持 IPv4 和 IPv6，允许用户动态更新域名解析记录，以方便将SpringBoot项目提供给外部展示及调试。
## 特点
- 支持SpringBoot生态。
- 支持多种 DDNS 服务提供商，包括阿里云、腾讯云和 Cloudflare。
- 自动检测 IPv4 或 IPv6 公共地址并更新解析记录。
- 默认开启 Cloudflare 代理以提高性能和安全性。
## 使用
### 添加依赖
```xml
<dependency>
    <groupId>top.sssd</groupId>
    <artifactId>ddns4j-spring-boot-starter</artifactId>
    <version>1.0.4</version>
</dependency>
```
### 简易功能配置
```yaml
ddns4j:
  enabled: true  #是否开启ddns4j
  shutdown-on-cleared: true #关闭时清除dns记录
  easy-mode:
    service-provider: 1 # 1 阿里云 2 腾讯云 3 cloudflare
    service-provider-id: your-service-provider-id
    service-provider-secret: your-service-provider-secret
    domain: your-domain
```
### 简易版查看是否正常运行
![简易版查看是否正常运行](./doc/简易版配置正常启动.png "简易版查看是否正常运行")
### 完整功能配置
>在 application.properties 或 application.yml 文件中添加以下配置：
```yaml
ddns4j:
  enabled: true #是否开启ddns4j,默认为关闭
  shutdown-on-cleared: true #是否在服务关闭时,清除dns记录
```
### 启动web项目
>在浏览器中http:ip:port/index.html 即可访问

![ddns4j-功能区介绍](./doc/ddns4j-功能区介绍.png "ddns4j-功能区介绍")
![效果图](./doc/效果图.png "效果图")

## 交流群
![群二维码](./doc/ddns4j交流群(一)群二维码.png "QQ群二维码")

## 推荐阅读
如果想要深入了解 DDNS 和 DDNS4J，可以访问我的独立使用的项目[DDNS4J](https://github.com/Xsssd/ddns4j) 或者我的博客 https://blog.sssd.top

该博客站点就是使用ddn4j搭建而成,响应较慢请大家海涵!了解更多有关网络和开发的知识。