Řešení problémů (troubleshooting)
Nejčastější situace, na které při vystavení, nasazení a obnově Let's Encrypt certifikátu narazíš — vždy příčina → řešení. Příkazy pro Linux jsou v bash (s sudo), pro Windows v PowerShellu spuštěném jako Administrator. Vygenerovaný ZIP obsahuje verify.sh / verify.ps1, které většinu kontrol níže udělají za tebe, a runbook.html s postupem přesně pro tvůj scénář.
Jak ověřit, že certifikát funguje
Linux / macOS (openssl, curl)
HOST=example.com; PORT=443
# Kdo certifikát vydal, pro koho a dokdy platí
openssl s_client -connect $HOST:$PORT -servername $HOST -showcerts </dev/null 2>/dev/null \
| openssl x509 -noout -dates -subject -issuer
# Řetězec: server musí posílat 2+ certifikáty (leaf + intermediate)
openssl s_client -connect $HOST:$PORT -servername $HOST -showcerts </dev/null 2>/dev/null \
| grep -c 'BEGIN CERTIFICATE'
# HTTPS z pohledu klienta (bez -k! pokud curl hlásí problém s certifikátem, něco je špatně)
curl -vI https://$HOST:$PORT/
Očekávaný výsledek: issuer obsahuje O = Let's Encrypt, notAfter je ~90 dní od vystavení, počet certifikátů ≥ 2, curl nehlásí SSL certificate problem.
Windows (PowerShell)
$h = 'example.com'; $p = 443
Test-NetConnection $h -Port $p # TcpTestSucceeded : True
Invoke-WebRequest -Uri "https://${h}:${p}/" -UseBasicParsing | Select-Object StatusCode
# Jaký certifikát server skutečně posílá
$tcp = New-Object Net.Sockets.TcpClient($h, $p)
$ssl = New-Object Net.Security.SslStream($tcp.GetStream(), $false,
[Net.Security.RemoteCertificateValidationCallback]{ $true })
$ssl.AuthenticateAsClient($h)
[Security.Cryptography.X509Certificates.X509Certificate2]$ssl.RemoteCertificate |
Format-List Subject, Issuer, NotAfter
$tcp.Close()
Máš-li openssl (např. z Git for Windows): '' | openssl s_client -connect ${h}:${p} -servername $h -showcerts.
Online
- SSL Labs Server Test — jen pro veřejně dostupný server na portu 443. Chceš známku A/A+ a „Chain issues: None".
- Konec platnosti hlídej sám: ZIP obsahuje
.icspřipomínku expirace do kalendáře (Let's Encrypt e-maily o expiraci už neposílá).
Obnova
Linux (certbot)
sudo certbot renew --dry-run # zkouška obnovy proti staging serveru, nic nemění
sudo certbot certificates # co je vystavené a dokdy platí
systemctl list-timers 'certbot*' --no-pager # timer (Debian/Ubuntu/RHEL); Alpine: crontab -l
sudo tail -n 50 /var/log/letsencrypt/letsencrypt.log
Po obnově se webserver reloaduje deploy hookem (/etc/letsencrypt/renewal-hooks/deploy/reload.sh, u cronu --deploy-hook). Pokud timer neběží: sudo systemctl enable --now certbot.timer.
Windows (win-acme)
& 'C:\Program Files\win-acme\wacs.exe' --list # renewaly, další termín, instalační skript
& 'C:\Program Files\win-acme\wacs.exe' --renew --test # zkouška proti staging (renew-test.ps1)
Get-ScheduledTask -TaskName 'win-acme*' | Get-ScheduledTaskInfo |
Format-List TaskName, LastRunTime, LastTaskResult, NextRunTime
Get-ChildItem "$env:ProgramData\win-acme" -Recurse -Filter '*.log' |
Sort-Object LastWriteTime -Descending | Select-Object -First 1 | Get-Content -Tail 50
Pokud Scheduled Task chybí nebo je vypnutý: & 'C:\Program Files\win-acme\wacs.exe' --setuptaskscheduler.
Nejčastější chyby
Port 80 není dostupný z internetu (HTTP-01)
Příznak: Timeout during connect (likely firewall problem), Connection refused, win-acme „validation failed".
Příčina: firewall, NAT bez port-forwardu, poskytovatel blokuje port 80, webserver poslouchá jen na localhost.
Řešení: otestuj zvenčí (mobilní data, jiná síť), ne z LAN:
curl -I http://example.com/.well-known/acme-challenge/test # očekáváš 404 od tvého serveru, ne timeout
Otevři port (ufw allow 80/tcp, firewall-cmd --permanent --add-service=http && firewall-cmd --reload, Windows New-NetFirewallRule -DisplayName "HTTP-01" -Direction Inbound -LocalPort 80 -Protocol TCP -Action Allow) a přidej port-forward na routeru. Když port 80 otevřít nejde, zvol ve wizardu „port 80 dostupný z internetu: ne" → DNS-01.
CAA záznam blokuje letsencrypt.org
Příznak: CAA record for example.com prevents issuance.
Příčina: doména (nebo její nadřazená) má CAA záznam, který Let's Encrypt neuvádí.
Řešení:
dig CAA example.com +short # zkontroluj i nadřazené domény
Přidej 0 issue "letsencrypt.org" (pro wildcard i 0 issuewild "letsencrypt.org"), nebo omezující CAA odstraň. Počkej na vypršení TTL.
DNS-01: TXT záznam se nestihl rozšířit
Příznak: Incorrect TXT record / No TXT record found at _acme-challenge.example.com, přestože v Cloudflare záznam je.
Příčina: validace proběhla dřív, než se záznam propsal na autoritativní servery.
Řešení: v issue.sh zvyš --dns-cloudflare-propagation-seconds 30 na 60–120 (hodnota se uloží i do /etc/letsencrypt/renewal/<doména>.conf pro obnovy). win-acme: v settings.json zvyš Validation.PreValidateDnsRetryCount / PreValidateDnsRetryInterval. Kontrola:
dig TXT _acme-challenge.example.com @1.1.1.1 +short
Smaž staré _acme-challenge TXT záznamy po ručních pokusech. Authentication error (10000) = špatný/expirovaný token nebo token bez práv na tuto zónu → Cloudflare token.
Rate limity Let's Encrypt
Příznak: too many failed authorizations recently, too many certificates already issued.
Příčina: limity Let's Encrypt — 5 neúspěšných validací na účet/hostname/hodinu, 50 certifikátů na registrovanou doménu za týden, 5 duplicitních certifikátů (stejná sada jmen) za týden.
Řešení: nejdřív nanečisto — přepínač „Nejdřív nanečisto" v kroku 4 přidá --dry-run (certbot) / --test (win-acme), staging server má limity mnohem vyšší. Po chybě nejdřív odstraň příčinu, neopakuj pokus ve smyčce; po hodině to půjde znovu. Přehled: letsencrypt.org/docs/rate-limits.
Wildcard vyžaduje DNS-01 a nepokrývá apex
Příznak: HTTP-01 pro *.example.com selže; certifikát pro *.example.com nefunguje na https://example.com.
Příčina: wildcard lze ověřit jen přes DNS-01. *.example.com pokrývá www.example.com nebo api.example.com, ale ne example.com ani a.b.example.com.
Řešení: DNS-01 (Cloudflare nebo ruční TXT) a do certifikátu dej obě jména: *.example.com i example.com. Pozor na cesty: certbot pojmenuje lineage bez *. → /etc/letsencrypt/live/example.com/ (vygenerované skripty s tím počítají).
Windows: IIS už drží port 443 → jiný port pro mServer
Příznak: netsh http add sslcert končí chybou 183 („Cannot create a file when that file already exists") nebo mServer na 443 nenaběhne.
Příčina: port 443 má IIS (nebo jiná aplikace přes http.sys).
Řešení: dej mServeru jiný port (444, 8443) v záložce HTTPS i ve wizardu. netsh http show sslcert ukáže, kdo který port drží.
Windows: certifikát bez privátního klíče / netsh error 1312
Příznak: SSL Certificate add failed, Error: 1312 — A specified logon session does not exist.
Příčina: certifikát v úložišti nemá privátní klíč, nebo je v CurrentUser\My místo LocalMachine\My.
Řešení:
Get-ChildItem Cert:\LocalMachine\My | Where-Object { $_.HasPrivateKey } |
Format-Table Thumbprint, Subject, NotAfter
Když správný certifikát chybí, spusť znovu issue.ps1 (ukládá do LocalMachine\My i s klíčem); binding vždy s certstorename=MY.
PowerShell blokuje stažené .ps1
Příznak: … cannot be loaded because running scripts is disabled nebo … is not digitally signed.
Příčina: soubory z internetu mají „Mark of the Web", execution policy skripty odmítá.
Řešení:
Unblock-File .\*.ps1
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
win-acme: plugin Cloudflare nesedí s verzí wacs.exe
Příznak: Unable to find validation plugin cloudflare, Could not load file or assembly ….
Příčina: plugin.validation.dns.cloudflare.*.zip je z jiného release než wacs.exe.
Řešení: install.ps1 stahuje plugin ze stejného release jako wacs.exe — po ruční aktualizaci win-acme ho spusť znovu (příp. .\install.ps1 -Version vX.Y.Z). Kontrola: Get-ChildItem 'C:\Program Files\win-acme' -Filter '*Cloudflare*'.
HAProxy potřebuje sloučený PEM
Příznak: po obnově HAProxy stále posílá starý certifikát; unable to load SSL private key.
Příčina: HAProxy čte fullchain + privátní klíč z jednoho souboru; certbot obnovuje jen /etc/letsencrypt/live/….
Řešení: renewal hook z wizardu sloučený PEM při každé obnově znovu sestaví z $RENEWED_LINEAGE a HAProxy reloadne. Ručně:
sudo sh -c 'umask 077; cat /etc/letsencrypt/live/example.com/fullchain.pem /etc/letsencrypt/live/example.com/privkey.pem > /etc/haproxy/certs/example.com.pem'
sudo haproxy -c -f /etc/haproxy/haproxy.cfg && sudo systemctl reload haproxy
„Too many redirects" / HTTP-01 za Cloudflare proxy (oranžový mráček)
Příznak: validace končí přesměrováním, Too many redirects, 403/520 od Cloudflare; standalone režim vůbec nedostane spojení.
Příčina: s proxy (oranžový mráček) končí HTTP na Cloudflare — „Always Use HTTPS", cache nebo Cloudflare vlastní certifikát stojí v cestě, a na tvůj server se challenge nedostane.
Řešení: použij DNS-01 (Cloudflare token) — nejjednodušší a funguje i pro wildcard. Nebo záznam dočasně přepni na šedý mráček (DNS only), vystav certifikát a pak proxy vrať; režim SSL/TLS v Cloudflare nastav na Full (strict). Alternativně vyjmi /.well-known/acme-challenge/* z „Always Use HTTPS" a cache pravidlem.
certbot „unauthorized" / challenge soubor se neservíruje (webroot)
Příznak: Invalid response from http://example.com/.well-known/acme-challenge/…: 404 (nebo 301/403).
Příčina: špatná cesta k webrootu (pro doménu odpovídá jiný vhost), rewrite pravidla (SPA catch-all, redirect na HTTPS), blokované „tečkové" adresáře.
Řešení: ověř, že soubor z webrootu je zvenčí vidět:
WEBROOT=/var/www/html
sudo mkdir -p $WEBROOT/.well-known/acme-challenge
echo ok | sudo tee $WEBROOT/.well-known/acme-challenge/test >/dev/null
curl -i http://example.com/.well-known/acme-challenge/test # očekáváš 200 a "ok"
Skutečný root najdeš přes sudo nginx -T | grep -B3 'root ' / apachectl -S. Pro nginx pomůže výjimka:
location ^~ /.well-known/acme-challenge/ { root /var/www/html; default_type text/plain; }
Když to nejde rozmotat, použij standalone (webserver na chvíli zastavit) nebo DNS-01.
RHEL / Alma / Rocky: chybí EPEL
Příznak: No match for argument: certbot.
Příčina: certbot je v EPEL, ne v základních repozitářích.
Řešení:
sudo dnf install epel-release # Alma / Rocky / CentOS Stream
# čisté RHEL: epel-release není v repozitářích, instaluje se z URL
sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
sudo dnf install certbot python3-certbot-dns-cloudflare # + python3-certbot-nginx / -apache
Na RHEL bývá potřeba ještě subscription-manager repos --enable codeready-builder-for-rhel-9-$(arch)-rpms.
Alpine Linux — poznámky
Příčina: Alpine nemá systemd ani bash by default a část balíčků je v repozitáři community.
Řešení:
apk add bash curl openssl certbot py3-certbot-dns-cloudflare # community repo musí být povolený v /etc/apk/repositories
rc-update add crond default && rc-service crond start # obnova přes cron, ne timer
crontab -l # řádek z cron-entry.txt
rc-service nginx reload # OpenRC místo systemctl
Skripty z wizardu jsou pro bash — spouštěj je bash issue.sh, ne sh.
Certifikát se obnovil, ale server posílá starý
Příčina: webserver se nereloadnul (hook selhal), HAProxy má starý sloučený PEM, na Windows zůstal binding na starý thumbprint.
Řešení: sudo systemctl reload nginx (apache2/haproxy/caddy) a zkontroluj hook v /var/log/letsencrypt/letsencrypt.log; Windows: netsh http show sslcert a wacs.exe --list (u renewalu musí být installation script); pro mServer samostatný návod. Potom znovu ověření ze začátku této stránky.