Skip to content

Certbot dns plugin to obtain certificates by multi dns provider.

License

Notifications You must be signed in to change notification settings

warjiang/certbot-dnshub

Repository files navigation

Multi dns provider authentication plugin for certbot

CI PyPI PyPI - Python Version PyPI - Downloads PyPI - License

English | 中文

Multi dns provider authentication plugin for certbot. It can help you automatically apply and update Let's Encrypt wildcard certificates.

PreRequisites

  1. You already have a domain name, such as example.com.
  2. The corresponding domain name service provider has provided openapi or sdk, such as dnspod, aliyun, tencent cloud, etc.
  3. Get the configuration information(for example ak/sk or token) of openai or sdk

Usage

you can use this plugin with docker or pip. We recommend using docker. Take dnspod as an example, first get the dnspod openapi configuration information, and then execute the following command:

  1. Use docker container

    docker pull certbot/certbot
    docker run -it --rm --name certbot \
           -v /etc/letsencrypt:/etc/letsencrypt \
           -v /var/lib/letsencrypt:/var/lib/letsencrypt \
           -v `pwd`/credentials.ini:/opt/certbot/credentials.ini \
           --entrypoint /bin/sh certbot/certbot
    pip install certbot-dnshub 
    chmod 600 /opt/certbot/credentials.ini
    certbot certonly -a dnshub \
           --dnshub-credentials /path/to/credentials.ini \
           -d www.example.com 
  2. Use pip

    python3 -m venv certbot
    source certbot/bin/activate
    pip install certbot certbot-dnshub
    chmod 600 /path/to/credentials.ini
    certbot certonly -a dnshub \
         --dnshub-credentials /path/to/credentials.ini \
         -d www.example.com 

Supported DNS providers

Provider Provider Document Usage Document Update Time
dnspod dnspod Document Usage Document 2023-11-26
aliyun aliyun dns Document Usage Document 2023-11-27

FAQ

  1. Unsafe permissions on credentials configuration file: /opt/certbot/credentials.ini faq-credentials-permission.png permission of credentials.ini invalid, you can change it to 600 manually
    chmod 600 /path/to/credentials.ini

About

Certbot dns plugin to obtain certificates by multi dns provider.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages