https://github.com/cnfatal/alidnsctl
A tool to operate alidns records.
https://github.com/cnfatal/alidnsctl
alidns ddns
Last synced: 8 months ago
JSON representation
A tool to operate alidns records.
- Host: GitHub
- URL: https://github.com/cnfatal/alidnsctl
- Owner: cnfatal
- Created: 2023-01-06T14:31:45.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2023-01-08T06:28:06.000Z (over 3 years ago)
- Last Synced: 2025-07-22T11:51:57.462Z (11 months ago)
- Topics: alidns, ddns
- Language: Go
- Homepage:
- Size: 12.7 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# alidnsctl
A lite tool to operate with Aliyun DNS Records.
## Quick Start
An exampl in ppp `/etc/ppp/ip-up.d/20-ddns.sh` script:
```sh
#!/bin/sh -e
export ACCESS_KEY_ID=""
export ACCESS_KEY_SECRET=""
alidnsctl set router.example.com ${IPLOCAL}
```
## Install
Download prebuild binaries from [github release](https://github.com/cnfatal/alidnsctl/releases/latest).
```sh
wget https://github.com/cnfatal/alidnsctl/releases/latest/download/alidnsctl-linux-amd64 -O /usr/bin/alidnsctl
chmod +x /usr/bin/alidnsctl
```
Install from source code:
```sh
go install github.com/cnfatal/alidnsctl@latest
```
## Usage
Set access key via enviroment:
```sh
export ACCESS_KEY_ID=
export ACCESS_KEY_SECRET=
```
Example update records:
```sh
alidnsctl set api.example.com 127.0.0.1
alidnsctl set --type AAAA api.example.com fe80::b0bb:26ff:fe2b:cb20
alidnsctl set --type CNAME @.example.com www.example.com
alidnsctl set --type TXT txt.example.com hello_world hello_world2
```
For more infomations see help:
```sh
alidnsctl --help
```
List records:
```sh
$ alidnsctl list abc.example.com
[
{
"DomainName": "example.com",
"Line": "default",
"Locked": false,
"RR": "abc",
"RecordId": "xxxxxxxxx",
"Status": "ENABLE",
"TTL": 600,
"Type": "CNAME",
"Value": "www.example.com",
"Weight": 1
}
]
```
Remove Record:
```sh
$ alidnsctl del router.example.com 127.0.0.1 fe80::b0bb:26ff:fe2b:cb20
[] #show left records on rr
```
List Domains:
```sh
$ alidnsctl domains list
[
{
"AliDomain": true,
"CreateTime": "2017-09-07T01:21Z",
"CreateTimestamp": 1504747278000,
"DnsServers": {
"DnsServer": [
"dns29.hichina.com",
"dns30.hichina.com"
]
},
"DomainId": "xxxx-xxxx-xxxx-xxxx-675c9c69e149",
"DomainName": "example.com",
"PunyCode": "example.com",
"RecordCount": 8,
"ResourceGroupId": "group",
"Starmark": false,
"Tags": {},
"VersionCode": "mianfei",
"VersionName": "Alibaba Cloud DNS"
}
]
```