Documents/WeChat Files/wxid_q0nnu6gl2jxr22/FileStorage/File/2024-07/aliyun-ddns-client - 志元云盘

File OriginalPic	EditTime	Size
__pycache__	2023-05-26 14:08:50	20.91 KB
CHANGELOG.md	2023-05-26 14:05:57	239 B
config.py	2023-05-26 14:05:57	4.24 KB
ddns.conf	2023-05-26 14:10:43	751 B
ddns.conf.example	2023-05-26 14:05:57	680 B
ddns.py	2023-05-26 14:05:57	3.24 KB
ddns.service	2023-05-26 14:05:57	216 B
ddns.timer	2023-05-26 14:05:57	160 B
README.md	2023-05-26 14:05:57	3.47 KB
record.py	2023-05-26 14:05:57	6.21 KB
utils.py	2023-05-26 14:05:57	4.11 KB
yunresolver.py	2023-05-26 14:05:57	8.71 KB

## aliyun-ddns-client(v0.3)

Python DDNS client for Aliyun(http://www.hdget.com/aliyun-ddns-client)

### LIMITATION
This version of DDNS client only supports auto updating 'A' type DomainRecord with IPV4 address.

Other types are not supported because they need following value format other than IP address:
- 'NS', 'MX', 'CNAME' types DomainRecord need domain name format value
- 'AAAA' type DomainRecord need IPV6 address format value
- 'SRV' type DomainRecord need name.protocal format value
- 'Explicit URL' and 'Implicit  URL' need URL format value

### PREREQUISITE
Some 3rd party python libraries are required for aliyun-ddns-client as below, you can install it via pip or easy_install:

- requests
- netifaces (needed only when you want to get IP address from the interface setting, it maybe useful when you have multiple interfaces.)

For example:
```
# pip install requests
# pip install netifaces # optional 
```

### INSTALLATION

#### 1. USE CRONJOB
1. Download all files to somewhere, e,g: /opt/aliyun-ddns-client
2. Rename "ddns.conf.example" to "ddns.conf" in the same dir
3. Create a cronjob which execute "python ddns.py" periodly, e,g:
`
*/5 * * * * cd /opt/aliyun-ddns-client && /usr/bin/python ddns.py
`
4. Make sure ddns.conf can be accessed by cronjob user

#### 2. USE SYSTEMD
1. Download all files to some where, e,g:/root/tools/aliyun-ddns-client
2. Rename "ddns.conf.example" to "ddns.conf" in the same dir
3. Copy two files: "ddns.timer" and "ddns.service" to "/usr/lib/systemd/system"
4. 
```
 root@local# systemctl daemon-reload
 root@local# systemctl start ddns.timer
 root@local# systemctl status ddns.timer -l
```

### CONFIGURATION
Required options need to be set in /etc/ddns.conf:
* access_id
* access_key
* domain
* sub_domain

Optional options:
* type
* debug

```
[DEFAULT]
# access id obtains from aliyun
access_id=
# access key obtains from aliyun
access_key=
# it is not used at this moment, you can just ignore it
interval=600
# turn on debug mode or not
debug=true

[DomainRecord1]
# domain name, like google.com
domain=
# subdomain name, like www, blog, bbs, *, @, ...
sub_domain=
# resolve type, 'A', 'AAAA'..., currently it only supports 'A'
type=A

[feature_public_ip_from_nic]
enable=false
interface=eth0
```

### GETTING STARTED 
1. Create a DNS resolve entry in Aliyun console manually, e,g: blog.guanxigo.com
2. You can leave any IP address on Aliyun server for this entry, like 192.168.0.1
3. Make sure all required options are inputted correctly in "ddns.conf"
4. Enable the features you want to use.
5. Make sure "ddns.conf" can be readable for the user who setup cron job

NOTICE:
Only domain records both defined in local config file and Aliyun server will be updated

### FAQ

* Q: Why it failed with error message "The input parameter \"Timestamp\" that is mandatory for processing this request is not supplied." in describeDomainRecords()?

A: Please check what's the value in params 'TimeStamp'. If the value has big difference with the correct time, you need use ntpdate to sync system time to the correct one.

* Q: Why it failed with error message "Failed to save the config value"?

A: You need make sure current cronjob user has permission to write file /etc/ddns.conf.
  
* Q: Why it raise exception "AttributeError: 'X509' object has no attribute '_x509'"?
  
  A: PyOpenSSL version need >= 0.14, and you may try to fix this problem by do following:
  ```
  sudo yum uninstall python-requests
  sudo pip uninstall pyopenssl cryptography requests
  sudo pip install requests
  ```

云盘

Home / 志元云盘 / Documents / WeChat Files / wxid_q0nnu6gl2jxr22 / FileStorage / File / 2024-07 / aliyun-ddns-client