# TRDDNS

**Repository Path**: yahocen/trddns

## Basic Information

- **Project Name**: TRDDNS
- **Description**: 火山引擎动态DNS，TrafficRoute DNS，DDNS
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: graalvm
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2023-11-01
- **Last Updated**: 2024-09-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 项目名称：
火山引擎动态DNS解析工具 TRDDNS

## 概述
该开源项目是为了帮助那些使用火山引擎的用户解决动态 IP 地址的解析问题。作者在将个人域名从阿里云迁移到火山引擎后，发现火山引擎缺乏类似于阿里云的 AliyunDdnsCSharp 工具，因此基于火山引擎的 TrafficRoute DNS 套件文档，使用 Java 17 简单实现了一个动态 DNS 解析工具。

## 功能特点
- 动态 IP 地址解析： 通过使用火山引擎的 TrafficRoute DNS 套件文档，实现了动态 IP 地址的解析功能。
- 实用性： 旨在帮助用户管理个人域名下的动态 IP 地址，确保服务可靠性和连通性。
- 简单易用： 设计简单，易于配置和部署，适用于各种场景下的动态 IP 地址解析需求。

## 技术栈：
- Java 17：采用最新版本的 Java 17 编写，充分利用 Java 所具备的优势和特性，实现高性能的动态 DNS 解析功能。
- GraalVM：采用 GraalVM 进行高效编译，提高程序运行速度和性能。
- TrafficRoute DNS 套件：依据火山引擎的 TrafficRoute DNS 套件文档，进行开发与实现，提升 DNS 解析服务的质量和稳定性。

## 使用方式
### 运行项目
在命令行中直接运行 trddns.exe 并按照以下命令参数进行配置。
`trddns.exe [主机记录] [顶级域名] [API访问密钥Access Key ID] [API访问密钥Secret Access Key]`
例如
`trddns.exe www test.com 123456 abc......xyz`

### 项目配置
#### 参数说明
- [主机记录]：您要进行动态 IP 解析的域名主机记录，例如 www。
- [顶级域名]：您的顶级域名，例如 example.com。
- [API访问密钥Access Key ID]：火山引擎 API 访问的 Access Key ID。
- [API访问密钥Secret Access Key]：火山引擎 API 访问的 Secret Access Key。

#### 获取 API 访问密钥
您可以参考 火山引擎文档[https://www.volcengine.com/docs/6291/65568] 获取 API 访问密钥，确保拥有适当的访问权限以便进行 DNS 的修改操作。

#### 定时任务运行
该工具默认只进行一次 DNS 扫描监控，因此建议配合定时工具使用，以实现周期性的 DNS 监控。可以选择使用系统自带的定时任务工具，比如 Linux 的 Cron 或者 Windows 的计划任务，或者使用第三方的定时任务工具。

### 注意事项
- 请确保输入参数正确，以免造成 DNS 设置错误或不必要的问题。
- 请确保配置的定时任务间隔合理，避免频繁的 DNS 扫描请求。
- 确保在执行定时任务时参数正确，避免出现不必要的 DNS 设置问题。
- 本工具是用于个人域名动态解析，务必合法使用，避免用于违规操作。