Zurück zum Blog

Let's Encrypt SSL installieren: Kostenloses Zertifikat mit Certbot

Let's Encrypt SSL installieren: kostenloses Zertifikat mit Certbot für Nginx und Apache, automatische Verlängerung, Wildcards und typische Fehler.

Nodesty-Team9 Min. LesezeitSicherheit
Der Schriftzug Let's Encrypt SSL mit Certbot auf dunklem Nodesty-Hintergrund

Wenn Sie auf Ihrem eigenen Linux-Server Let's Encrypt SSL installieren möchten, ist Certbot das Werkzeug der Wahl. Let's Encrypt ist eine gemeinnützige Zertifizierungsstelle, die kostenlose Zertifikate ausstellt, denen alle Browser vertrauen; Certbot beantragt das Zertifikat, trägt es in Ihre Nginx- oder Apache-Konfiguration ein und verlängert es vor dem Ablauf. Auf einem richtig vorbereiteten Server ist das Ganze in wenigen Minuten erledigt.

In dieser Anleitung zeigen wir, was Sie vorab brauchen, wie Sie Certbot unter Ubuntu, Debian und AlmaLinux installieren, ein Zertifikat für Nginx und Apache holen, was die Modi Webroot und Standalone leisten, wo die Zertifikatsdateien liegen, wie die automatische Verlängerung funktioniert, was für Wildcard-Zertifikate und Rate Limits gilt und wie Sie typische Fehler beheben. Die Grundlagen erklären wir in Was ist ein SSL-Zertifikat?

Bevor Sie anfangen

Let's Encrypt stellt ein Zertifikat erst aus, nachdem geprüft wurde, dass Sie die Domain kontrollieren. Beim Standardverfahren, der HTTP-01-Challenge, verbinden sich die Server von Let's Encrypt über Port 80 mit Ihrer Domain und suchen eine Datei, die Certbot dort ablegt. Drei Dinge müssen dafür stimmen:

  • Das DNS zeigt auf den Server. Der A-Eintrag (und der AAAA-Eintrag, falls vorhanden) jedes Namens, der im Zertifikat stehen soll, muss auf die IP-Adresse Ihres Servers zeigen. Die Eintragstypen erklären wir in Was ist DNS?
  • Die Ports 80 und 443 sind offen. Port 80 wird für Validierung und Verlängerung gebraucht, Port 443 für HTTPS selbst.
  • Der Webserver antwortet bereits für die Domain. Für die Domain sollte es auf Port 80 einen Server Block in Nginx oder einen Virtual Host in Apache geben; wie Sie ihn anlegen, zeigt unsere Anleitung Nginx installieren.

Prüfen Sie die DNS-Einträge und öffnen Sie die Ports:

dig +short example.com A
dig +short example.com AAAA
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp

dig sollte die IP-Adresse Ihres Servers ausgeben (fehlt der Befehl, installieren Sie ihn mit sudo apt install dnsutils). Firewall-Regeln erklären wir in der Anleitung UFW Firewall; unter AlmaLinux führen Sie sudo firewall-cmd --permanent --add-service=http --add-service=https und danach sudo firewall-cmd --reload aus.

Certbot installieren

Unter Ubuntu und Debian liegen Certbot und die Plugins für die Webserver in den Standard-Paketquellen. Installieren Sie das Plugin, das zu Ihrem Webserver passt:

sudo apt update
sudo apt install certbot python3-certbot-nginx

Für Apache installieren Sie python3-certbot-apache statt python3-certbot-nginx.

Das Certbot-Projekt selbst empfiehlt das Snap-Paket, das stets die neueste Version enthält und beide Plugins bereits mitbringt. Wenn Sie es bevorzugen, entfernen Sie zuerst das apt-Paket, damit sich die beiden nicht in die Quere kommen:

sudo apt remove certbot
sudo snap install --classic certbot
sudo ln -s /snap/bin/certbot /usr/bin/certbot

Unter AlmaLinux und Rocky Linux kommt Certbot aus dem EPEL-Repository:

sudo dnf install epel-release
sudo dnf install certbot python3-certbot-nginx

Zertifikat für Nginx holen

sudo certbot --nginx -d example.com -d www.example.com

Beim ersten Aufruf fragt Certbot nach einer E-Mail-Adresse und bittet Sie, den Nutzungsbedingungen von Let's Encrypt zuzustimmen. Danach validiert es die Domains, speichert das Zertifikat, sucht den Server Block mit passendem server_name, ergänzt dort die Zeilen listen 443 ssl und ssl_certificate (markiert mit # managed by Certbot), richtet die Weiterleitung von HTTP auf HTTPS ein und lädt Nginx neu.

Jeder Name braucht eine eigene Option -d; www.example.com ist nicht automatisch abgedeckt, nur weil example.com im Zertifikat steht. Um später einen Namen hinzuzufügen, führen Sie den Befehl mit der vollständigen Liste der Namen erneut aus.

Zertifikat für Apache holen

sudo apt install certbot python3-certbot-apache
sudo certbot --apache -d example.com -d www.example.com

Certbot sucht den Virtual Host, dessen ServerName oder ServerAlias zur Domain passt, legt eine HTTPS-Variante davon an (unter Ubuntu und Debian eine Datei mit der Endung -le-ssl.conf in /etc/apache2/sites-available/), aktiviert das SSL-Modul und lädt Apache neu. Unter AlmaLinux heißt das Plugin-Paket genauso: python3-certbot-apache.

Nur das Zertifikat: Webroot und Standalone

Soll Certbot Ihre Konfiguration nicht anfassen oder läuft auf dem Server weder Nginx noch Apache, verwenden Sie certonly mit einem dieser Verfahren:

VerfahrenSo läuft die ValidierungWann sinnvoll?
--nginx / --apacheCertbot passt die Webserver-Konfiguration vorübergehend anDer Normalfall; Certbot richtet das Zertifikat ein
--webrootEine Datei wird im Website-Ordner abgelegt; der Webserver läuft weiterSie verwalten die SSL-Konfiguration selbst
--standaloneCertbot startet einen eigenen temporären Webserver auf Port 80Auf Port 80 läuft kein Webserver
DNS-ChallengeEin TXT-Eintrag wird in der DNS-Zone der Domain angelegtWildcard-Zertifikate oder Port 80 nicht erreichbar
sudo certbot certonly --webroot -w /var/www/example.com -d example.com -d www.example.com
sudo certbot certonly --standalone -d mail.example.com

Bei Webroot schreibt Certbot die Validierungsdatei nach .well-known/acme-challenge/ in dem mit -w angegebenen Ordner; es muss also der Ordner sein, den Ihr Webserver für die Domain ausliefert. Standalone funktioniert nur, wenn sonst nichts auf Port 80 lauscht.

Mit certonly tragen Sie die Zertifikatspfade selbst in Ihre Konfiguration ein, und der Dienst muss nach jeder Verlängerung neu geladen werden. Hängen Sie --deploy-hook "systemctl reload nginx" an den Befehl an; Certbot speichert den Hook und führt ihn nach jeder erfolgreichen Verlängerung aus.

Wo die Zertifikate liegen

Certbot legt alles unter /etc/letsencrypt/ ab. Die Dateien, die Sie verwenden, liegen in /etc/letsencrypt/live/example.com/:

DateiInhalt
fullchain.pemIhr Zertifikat samt Zwischenzertifikaten; die Datei für den Webserver
privkey.pemDer private Schlüssel; geben Sie ihn niemals weiter
cert.pemNur Ihr Zertifikat
chain.pemNur die Zwischenzertifikate

In Nginx sehen die beiden Zeilen so aus:

ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;

Die Dateien in live sind Verknüpfungen auf die jeweils neueste Version in /etc/letsencrypt/archive/. Verweisen Sie in Ihrer Konfiguration immer auf den live-Pfad, statt die Dateien an einen anderen Ort zu kopieren; Kopien werden bei einer Verlängerung nicht aktualisiert. sudo certbot certificates listet Ihre Zertifikate, die enthaltenen Namen und die Ablaufdaten auf.

Automatische Verlängerung

Zertifikate von Let's Encrypt gelten 90 Tage, und Let's Encrypt hat angekündigt, die Laufzeit in den kommenden Jahren weiter zu verkürzen; die Verlängerung muss also automatisch laufen. Das Certbot-Paket richtet einen systemd-Timer ein, der zweimal täglich läuft und jedes Zertifikat verlängert, das kurz vor dem Ablauf steht, standardmäßig etwa 30 Tage vorher:

systemctl list-timers | grep certbot
sudo certbot renew --dry-run

Der Timer heißt beim apt-Paket certbot.timer und beim Snap snap.certbot.renew.timer. Unter AlmaLinux heißt er certbot-renew.timer, und Sie müssen ihn mit sudo systemctl enable --now certbot-renew.timer selbst aktivieren.

certbot renew --dry-run spielt die gesamte Verlängerung in der Testumgebung von Let's Encrypt durch, ohne Ihre Zertifikate zu ersetzen. Läuft der Befehl ohne Fehler durch, klappt die Verlängerung auch im Ernstfall. Die Verlängerung nutzt dasselbe Verfahren wie der erste Antrag, Port 80 muss also offen bleiben. Let's Encrypt verschickt keine Warn-E-Mails mehr vor dem Ablauf; nehmen Sie das Ablaufdatum des Zertifikats deshalb in Ihr Monitoring auf, wie in unserer Anleitung Server Monitoring beschrieben.

Wildcard-Zertifikate: die DNS-01-Challenge

Ein Wildcard-Zertifikat deckt alle Subdomains ab, etwa *.example.com. Let's Encrypt stellt solche Zertifikate nur über die DNS-01-Challenge aus: Statt einer Datei auf dem Webserver weisen Sie die Kontrolle nach, indem Sie in der DNS-Zone der Domain einen TXT-Eintrag namens _acme-challenge.example.com anlegen.

sudo certbot certonly --manual --preferred-challenges dns -d example.com -d '*.example.com'

Certbot zeigt den Wert für den TXT-Eintrag an und wartet, bis Sie ihn bei Ihrem DNS-Anbieter eingetragen haben. Ein so erhaltenes Zertifikat lässt sich nicht automatisch verlängern, weil der Eintrag bei jeder Verlängerung geändert werden muss. Für eine dauerhafte Lösung nutzen Sie das Certbot-DNS-Plugin Ihres Anbieters (zum Beispiel das Paket python3-certbot-dns-cloudflare); es legt den Eintrag mit einem auf dem Server hinterlegten Token über die API des Anbieters an.

Rate Limits

Let's Encrypt begrenzt, wie viele Zertifikate innerhalb einer Woche für eine Domain und für exakt dieselbe Namensliste ausgestellt werden, und wie viele fehlgeschlagene Validierungen pro Stunde erlaubt sind. Im normalen Betrieb kommen Sie nicht in die Nähe dieser Grenzen; erreicht werden sie meist, wenn derselbe fehlerhafte Befehl immer wieder ausgeführt oder ein Server mehrmals hintereinander neu aufgesetzt wird.

Solange Sie noch an Ihrer Einrichtung arbeiten, hängen Sie --dry-run an die Befehle certonly und renew an: Die Anfrage geht an die Testumgebung und zählt nicht für die echten Limits. Haben Sie ein Limit erreicht, nennt die Fehlermeldung den Zeitpunkt für den nächsten Versuch; bis dahin hilft nur Warten.

Typische Fehler

  • DNS problem (NXDOMAIN): Die Domain hat noch keinen A-Eintrag, oder die Änderung ist noch nicht bei allen DNS-Servern angekommen. Prüfen Sie mit dig +short example.com und warten Sie nach einer Änderung einen Moment.
  • Ein veralteter AAAA-Eintrag: Hat die Domain einen AAAA-Eintrag, bevorzugt Let's Encrypt IPv6. Ein Eintrag, der von einem alten Server übrig ist, kann die Validierung scheitern lassen, obwohl der A-Eintrag stimmt.
  • Timeout during connect (likely firewall problem): Port 80 ist geschlossen. Prüfen Sie UFW, die Firewall Ihres Anbieters und ob der Webserver auf Port 80 lauscht.
  • Invalid response, 404 oder unauthorized: Die Anfrage ist bei einer anderen Website oder in einem anderen Ordner gelandet. Prüfen Sie, ob server_name zur Domain passt beziehungsweise bei Webroot der Pfad hinter -w stimmt.
  • Could not automatically find a matching server block: Das Zertifikat wurde ausgestellt, aber kein Server Block führt die Domain in server_name. Korrigieren Sie die Zeile und führen Sie den Befehl erneut aus.
  • Too many certificates oder too many failed authorizations: Sie haben ein Rate Limit erreicht; warten Sie die in der Meldung genannte Zeit ab.
  • Ein CAA-Eintrag verhindert die Ausstellung: Hat die Domain CAA-Einträge, muss einer davon Let's Encrypt erlauben, zum Beispiel 0 issue "letsencrypt.org". Prüfen Sie mit dig +short example.com CAA.

Die Details jedes Durchlaufs stehen in /var/log/letsencrypt/letsencrypt.log.

Das Ergebnis testen

curl -I http://example.com
curl -I https://example.com
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -issuer -dates

Der erste Befehl sollte eine 301-Weiterleitung auf die https://-Adresse liefern, der zweite eine normale Antwort ohne Zertifikatsfehler. Der dritte gibt aus, wer das Zertifikat ausgestellt hat und von wann bis wann es gilt. Rufen Sie die Website außerdem im Browser auf und testen Sie die Adresse mit und ohne www.

Funktioniert HTTPS überall, können Sie Browser mit HSTS dazu bringen, die Website ausschließlich über HTTPS zu öffnen; das und die übrigen Header erklären wir in HTTP Security Header.

Let's Encrypt auf Nodesty-Servern

Die Nodesty-Pakete AMD Ryzen 9 9950X vServer und AMD EPYC 7763 vServer kommen mit NVMe-Speicher und vollem Root-Zugriff; Sie können Certbot installieren und alle Befehle aus dieser Anleitung auf Ihrem eigenen Server ausführen. Bei den vServer-Paketen sind tägliche Backups kostenlos und werden 7 Tage aufbewahrt. Möchten Sie keinen Server verwalten, enthält jeder Tarif im Webhosting von Nodesty ein kostenloses SSL-Zertifikat: Sobald Ihre Domain auf das Hosting zeigt, aktivieren Sie es in cPanel oder DirectAdmin, ganz ohne Certbot und Kommandozeile.

Häufig gestellte Fragen

Ist ein Let's-Encrypt-Zertifikat wirklich kostenlos und sicher?

Ja. Let's Encrypt ist eine gemeinnützige Zertifizierungsstelle, die domainvalidierte Zertifikate kostenlos ausstellt. Sie verschlüsseln genauso wie kostenpflichtige DV-Zertifikate und werden von allen aktuellen Browsern akzeptiert. Die Laufzeit ist kürzer, doch darum kümmert sich Certbot mit der automatischen Verlängerung.

Wie lange ist ein Let's-Encrypt-Zertifikat gültig?

Zertifikate von Let's Encrypt gelten 90 Tage, und Let's Encrypt hat angekündigt, die Laufzeit in den kommenden Jahren weiter zu verkürzen. Das Datum müssen Sie nicht selbst im Blick behalten, denn Certbot prüft zweimal täglich und verlängert ein Zertifikat, wenn noch etwa 30 Tage übrig sind.

Muss ich das Zertifikat von Hand verlängern?

Nein. Das Certbot-Paket richtet einen systemd-Timer ein, der Zertifikate automatisch verlängert. Sie sehen ihn mit systemctl list-timers und testen den gesamten Ablauf mit sudo certbot renew --dry-run. Läuft der Test ohne Fehler durch, funktioniert die Verlängerung von selbst.

Bekomme ich bei Let's Encrypt ein Wildcard-Zertifikat?

Ja, allerdings nur über die DNS-01-Challenge. Statt eine Datei auf dem Webserver abzulegen, weisen Sie die Kontrolle über die Domain mit einem TXT-Eintrag namens _acme-challenge in der DNS-Zone nach. Für die automatische Verlängerung nutzen Sie das Certbot-DNS-Plugin Ihres DNS-Anbieters, das den Eintrag über dessen API anlegt.

Warum meldet Certbot, dass die Challenge fehlgeschlagen ist?

Meist zeigt die Domain noch nicht auf den Server, ein alter AAAA-Eintrag verweist auf ein anderes Ziel oder Port 80 ist in der Firewall geschlossen. Let's Encrypt muss Ihren Server per HTTP über Port 80 erreichen, um die Domain zu validieren. Korrigieren Sie DNS und Firewall und testen Sie vor dem nächsten Versuch mit der Option --dry-run.

Brauche ich Certbot im Nodesty-Webhosting?

Nein. Jeder Tarif im Webhosting von Nodesty enthält ein kostenloses SSL-Zertifikat, das Sie in cPanel oder DirectAdmin aktivieren, sobald Ihre Domain auf das Hosting zeigt. Certbot ist für Server gedacht, die Sie selbst verwalten, etwa einen vServer mit Root-Zugriff.

Nodesty

Über den Autor

Nodesty-Team · Infrastruktur und Support

Das Nodesty-Team betreibt unsere Server, unser Netzwerk und unseren DDoS-Schutz im Alltag und beantwortet Support-Anfragen rund um die Uhr. Diese Ratgeber entstehen aus dieser Arbeit.

Verwandte Artikel

Starte deinen Server jetzt.

Erstellen, wachsen und skalieren Sie Ihre Projekte grenzenlos auf der Premium-Infrastruktur von Nodesty.

                                                                                                                                                                                                                            
                                                                                                                                                                                                                            
                                                                                                                                                                                                                            
                                                                                                                             ············································                                                   
                                                ··································································································..........···························                                     
                                       ················..........................................................................................................................··············                             
                                  ·············.................::::::::::::::::::::::::::::::::::::::::::::::....................:::::::::::::::::::::::::::::::::::::::................···········                        
                             ············................:::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::............·········                     
                         ············.................:::::::::::::::::::::::::::::::::::::::::::::::::::------------::::::::::::::::::::::::::::::----------------:::::::::::::::::::::..........········                  
                    ············......................::::::::::::::::::::::::::::::::::::------------------------------------------------------------------------------------:::::::::::::.........········                
                ··········.............................................::::::::::::::::::-------------==========================================-----------------------------------:::::::::::........·······               
             ········..................:.....................................::::::::::--------=======+++++++++++++++++++++++++++++++++++++=========================------------------::::::::::.......·······              
           ······.........::::::::::::::::::::................................:::::::-----=====++++xxxxxx**************************xxxxxxxxx++++++++++++++===================------------::::::::.......·······             
          ·····.......:::::::::::::::::::::::::::.............................:::::----===+++xxx****%%%%&&&&&&#############&&&&&&&%%%%%*******xxxxxxxx++++++++++++++==============----------:::::::......······             
         ····......::::::::-------------:::::::::::..........................::::---===+++xx***%%%&&&####@@@@@@@@@@@@@@@@@@@@@@@@####&&&&&%%%%*******xxxxxxxxx+++++++++++++===========--------::::::......·····             
        ····.....:::::::--------------------:::::::::.......................::::---===++xxx**%%&&&###@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@###&&&&%%%%%********xxxxxxxxxxx++++++++++++========------::::::.....······            
        ····.....:::::--------------------------::::::::....................::::---===++xx***%%&&&####@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@###&&&&&%%%%%**********xxxxxxxxxxxxx+++++++++=======------:::::.....·····            
        ····....::::::-------=============---------:::::::::................:::::---===+++xx***%%%&&&#####@@@@@@@@@@@@@@@@@@@@@@@@@#####&&&&&%%%%%%*************xxxxxxxxxxxxxx+++++++++======-----:::::....·····            
         ····....:::::-------================---------:::::::::...............:::::----===++++xxx***%%%%&&&&&&#################&&&&&&%%%%%%%*******************xxxxxxxxxxxxxxxxx++++++++======----:::::....·····            
         ·····....:::::--------=================---------::::::::::..............:::::::-----====+++++xxxxxx**************************xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx++++++++=====-----::::....·····            
          ·····.....:::::--------=================----------:::::::::::.................:::::::::-------=============++++++++++++++++++++++++++++++++++++xxxxxxxxxxxxxxxxxxxxxxx++++++++======-----::::....·····            
            ·····.....:::::::----------===========-------------::::::::::::.........................::::::::::::::::::------------------=============+++++++++++++++++++++++++++++++++=======-----::::.....·····            
              ······......:::::::---------------------------------:::::::::::::........................................:::::::::::::::-----------============+++++++++++++++++++++========------:::::.....·····             
                 ······........:::::::::---------------------------:::::::::::::::::...........................................:::::::::::::------------=============================--------::::::.....······              
                    ·········.........:::::::::::::::-------------::::::::::::::::::::::::.......................................::::::::::::::::--------------------------------------::::::::......·······                
                          ··········............::::::::::::::::::::::::::::::::::::::::::::::::::................................::::::::::::::::::::::::::-------------:::::::::::::::.........········                   
                                  ············..................:::::::::::::::::::::::::::::::::::::::::::.........................:::::::::::::::::::::::::::::::::::::................···········                        
                                             ················.............................................................................................................·················                                 
                                                           ······················................................................................···························                                                
                                                                               ·········································································