b4tman
/
pddnsc
1
0
Fork 0
Code Issues 8 Pull Requests Actions Packages Projects 1 Releases Activity
возможно будет клиент ddns
29 Commits 1 Branch 0 Tags 121 KiB
Python 98.8%
Dockerfile 1.2%
Go to file
Dmitry Belyaev 992197649c
add pre-commit 		2024-02-21 11:07:23 +03:00
pddnsc refactor vscale 2024-02-21 10:40:29 +03:00
settings fmt + StateFileFilter 2024-02-20 10:40:23 +03:00
state hold state dir 2024-02-19 17:08:02 +03:00
.dockerignore add Dockerfile 2024-02-20 20:44:27 +03:00
.gitignore add Dockerfile 2024-02-20 20:44:27 +03:00
.pre-commit-config.yaml add pre-commit 2024-02-21 11:07:23 +03:00
Dockerfile Dockerfile: use empty settings + state dirs 2024-02-20 21:18:52 +03:00
LICENSE add LICENSE 2024-02-20 12:08:01 +03:00
README.md fix README 2024-02-20 16:12:13 +03:00
requirements.dev.txt add pre-commit 2024-02-21 11:07:23 +03:00
requirements.txt add ip addrs validation 2024-02-21 09:41:51 +03:00

README.md

pddnsc

Возможно DDNS клиент

запуск

python -m pddnsc.cli

конфигурация

Конфигурация находится в файле settings/config.toml. Пример конфигурации:

[sources]
  # сервис https://www.ipify.org
  [sources.ipfy]
    provider = "IPIFYSource" # имя python класса

[filters]
  # этот фильтр означает, что если ip адреса не изменились (по хешу)
  # то не нужно никуда отсылать ничего
  [filters.state-hash]
    provider = "StateHashFilter"
    filepath = "state/hash.txt"

[outputs]
  # сохранение хеша всех ip адресов в файл, 
  # чтобы потом проверить изменились ли они
  [outputs.hash-file]
    provider = "StateHashFile"
    filepath = "state/hash.txt"

  # сервис доменов на vscale (vds.selectel.ru)
  # токен в переменной окружения VSCALE_API_TOKEN
  [outputs.vscale]
    provider = "VscaleDomains" 
    domain = "example.com"
    target = "www" # изменяем www.example.com
    ttl = 3600
    ipv4 = true # менять A запись
    ipv6 = false # НЕ менять AAAA запись

Конфигурация состоит из секций:

  • sources - источники ip адресов (выбирается результат от первого по времени сработавшего источника, который вернул хотябы один ipv4 или ipv6 адрес)
  • filters - фильтры, если хоть один вернет ложь то программа ничего никуда не запишет и не отправит, например проверка, что ip адрес не изменился
  • outputs - модули вывода, например вывод в консоль, запись в файл или создание dns записей на сервере

Все модули источников/фильтров/вывода работают конкурентно через asyncio.

TODO

  • Добавить названия python классов и их параметры.