🔐 Let's Encrypt Wizard
English ← Zpět do průvodce

Ř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

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.