معرفی شرکت ها
freenom-dns-updater-1.2.9
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
A tool to update freenom's dns records
| ویژگی | مقدار |
|---|---|
| سیستم عامل | - |
| نام فایل | freenom-dns-updater-1.2.9 |
| نام | freenom-dns-updater |
| نسخه کتابخانه | 1.2.9 |
| نگهدارنده | [] |
| ایمیل نگهدارنده | [] |
| نویسنده | maxisoft |
| ایمیل نویسنده | maxisoft@maxisoft.ga |
| آدرس صفحه اصلی | https://github.com/maxisoft/Freenom-dns-updater |
| آدرس اینترنتی | https://pypi.org/project/freenom-dns-updater/ |
| مجوز | MIT |
# Freenom dns updater
[](https://github.com/maxisoft/Freenom-dns-updater/blob/main/LICENSE.txt)
A tool written in python to update [freenom](http://Freenom.com)'s dns records
## Main Features
* Manage (add/update/remove) a domain's dns record with cli
* Automatic records updates according to ip (v4/v6) changes
* Auto renew domains
## Upcoming features
* Password encryption
## Installation
```bash
pip install freenom-dns-updater
```
## Usage
### Basic usage
Let's say you want to add or update your main A/AAAA domain records *exemple.tk* with your current ip (v4/v6).
Simply type :
```
fdu record update $LOGIN $PASSWORD exemple.tk
```
Note that if you don't have a ipv6 access, the tool will detect that and will update only the A record (ipv4) of *example.tk*.
In order to add or update the subdomain *sub.example.tk*:
```
fdu record update $LOGIN $PASSWORD example.tk -n sub
```
### Advanced usage
If you want to update multiple (sub)domains you could call the tool for each domains.
Even better, you can create a configuration file.
A configuration is a [YAML](https://en.wikipedia.org/wiki/YAML) file, which look like :
```YAML
login: yourlogin@somemail.domain
password: yourpassword
# list here the records you want to add/update
record:
# the following will update both the A and AAAA records with your current ips (v4 and v6).
# Note that if you don't have a ipv6 connection, the program'll detect it and will only update the A record (ipv4)
- domain: test.tk
# the following will update both your subdomain's A and AAAA records with your current ips (v4 and v6)
- domain: test.tk
name: mysubdomain
# here's more advanced exemples
# the following will update the AAAA record with a specified ipv6
- domain: test2.tk
name: # you can omit this line
type: AAAA
target: "fd2b:1c1b:3641:1cd8::" # note that you have to quote ipv6 addresses
ttl: 24440
# the following will update your subdomain's A record with your current ip (v4)
- domain: test2.tk
name: mysubdomain
type: A
target: auto # you can omit this line
# you can omit the record type and give only ipv4 or ipv6 addresses.
- domain: test2.tk
name: ipv6sub
target: "fd2b:1c1b:3641:1cd8::"
- domain: test2.tk
name: ipv4sub
target: "64.64.64.64"
```
In order to use such configuration, you can use the following command :
```bash
fdu update /path/to/config
```
Where */path/to/config* can be either:
- A path to a file (default location is ```/etc/freenom.yml```)
- A http url (a raw secret [gist](https://gist.githubusercontent.com/maxisoft/1b979b64e4cf5157d58d/raw/freenom.yml) for instance)
## Schedule
In order to launch regularly an update, you can launch the tool with :
```bash
fdu process -c -i -r -t 3600 /path/to/config
```
Where the params are :
| param | description |
|-----------------|------------------------------------------------------|
| -c | cache the ip and update only if there is any changes |
| -i | ignore errors when updating |
| -r | renew the domains |
| -t | time (in second) to wait between two updates |
| /path/to/config | a path or a url to a configuration file |
### Using systemd
For ease of use a systemd unit file is available along the source code.
- Save your configuration into ```/etc/freenom.yml```
- Copy the ```systemd/system/freenom-dns-updater.service``` into a valid systemd unit folder (```/usr/lib/systemd/system/``` for instance).
- finally enable the service using
```
systemctl enable freenom-dns-updater
systemctl start freenom-dns-updater
```
### Using other Os / services manager
There's two straightforward choices :
- Launch the previous ```fdu process``` command
- Schedule the ```fdu update``` command using cron, windows' scheduled task, ...
## Known issues
- The website [my.freenom.com](my.freenom.com) is not really stable (503/504 errors very often) => there's 3 retry on every request made by the tool but even with this it's common to face a remote server error
## Docker image
[](https://microbadger.com/images/maxisoft/freenom-dns-updater "")
If you want to run this tool in an "isolated" environment there's a docker image available at
[maxisoft/freenom-dns-updater](https://hub.docker.com/r/maxisoft/freenom-dns-updater/)
### Ipv6
Note that if you want to use the ipv6 functionality, you have to enable the [docker ipv6 stack](https://docs.docker.com/v1.5/articles/networking/#ipv6)
### Examples
- Update dns records using a gist config file :
```bash
docker run -it --rm maxisoft/freenom-dns-updater fdu update https://gist.githubusercontent.com/maxisoft/1b979b64e4cf5157d58d/raw/freenom.yml
```
- Run the tool in a background docker with a local config file :
```bash
docker run -d --rm -v /path/to/config:/etc/freenom.yml maxisoft/freenom-dns-updater
```
نیازمندی
| مقدار | نام |
|---|---|
| - | requests |
| - | beautifulsoup4 |
| - | PyYAML |
| - | six |
| - | click |
| - | oscrypto |
| - | check-manifest |
زبان مورد نیاز
| مقدار | نام |
|---|---|
| ~=3.6 | Python |
نحوه نصب
نصب پکیج whl freenom-dns-updater-1.2.9:
pip install freenom-dns-updater-1.2.9.whl
نصب پکیج tar.gz freenom-dns-updater-1.2.9:
pip install freenom-dns-updater-1.2.9.tar.gz