SSD Nodes Learn Hosting plans →
Mga Gabay Matt ConnorNi Matt Connor · Na-update 2026-10-24

Paano gumawa ng wildcard certificate sa Certbot DNS-01

Alamin paano gumagana ang TXT record proof sa DNS-01, aling plugin ang dapat i-install, at paano nananatiling awtomatiko ang pag-renew ng wildcard certificate.

Bakit kailangan ng wildcard certificate ang DNS-01

Saklaw ng wildcard certificate ang bawat first-level subdomain ng isang domain: saklaw ng *.example.com ang app.example.com, blog.example.com, at anumang iba pang name na isang label ang lalim. Nag-iisyu ang Let's Encrypt ng wildcard certificate sa pamamagitan lamang ng DNS-01 challenge, kaya kailangang patunayan ng Certbot na kontrolado mo ang DNS ng domain sa pamamagitan ng pag-publish ng TXT record sa _acme-challenge.example.com. Hindi sapat ang HTTP-01 challenge dahil ang paghahatid ng token file ay nagpapatunay lamang ng kontrol sa isang hostname—ang hostname kung saan kinuha ng validation server ang file. Ang wildcard ay pahayag tungkol sa bawat posibleng name na isang level sa ilalim ng domain, at DNS lamang ang public record na kumakatawan sa buong namespace.

Ang requirement na ito ang nagtatakda sa lahat ng iba pang bahagi ng page na ito. Para pumasa sa DNS-01, kailangan mong makagawa ng TXT records sa zone ng domain o sa hiwalay na validation zone na tinutukoy ng _acme-challenge gamit ang CNAME, na tatalakayin sa ibaba. Maaari mo itong gawin nang mano-mano o sa pamamagitan ng API (application programming interface) ng iyong DNS provider. Gumagana ang manual na paraan sa unang pagkakataon, ngunit mabibigo ito sa renewal sa tiyak na dahilang ipinapakita sa ibaba. Ang API na paraan, gamit ang Certbot DNS plugin, ay nagre-renew nang walang manual na interbensyon. Ito ang setup na dapat mong gamitin sa huli.

Ito ang wildcard chapter ng aming mga gabay sa Certbot. Tinalakay ang ordinaryong certificate para sa iisang hostname, configuration ng web server, at mga rule para sa port 80 sa Certbot gamit ang nginx sa Ubuntu 24.04 at Certbot gamit ang Apache sa Ubuntu 24.04.

Paano Gumagana ang TXT Record ng _acme-challenge

Kapag humiling ang Certbot ng *.example.com, sumasagot ang Let's Encrypt gamit ang random token. Pinagsasama ng Certbot ang token na iyon sa iyong ACME (automatic certificate management environment) account key, hina-hash ang resulta gamit ang SHA-256, at gumagawa ng maikling text value. Kailangang lumitaw ang value na iyon bilang TXT record sa _acme-challenge.example.com. Pagkatapos, nag-q-query ang Let's Encrypt sa authoritative name servers ng iyong domain mula mismo sa sarili nitong infrastructure. Kung tumutugma ang record na nabasa nito sa value na inaasahan nito, napatunayan mong kontrolado mo ang zone, at ang kontrol sa zone ay tinatanggap bilang kontrol sa bawat pangalan sa ilalim nito.

May dalawang detalye na sanhi ng karamihan sa mga kabiguan:

  • Kapag humiling ka ng example.com at *.example.com sa iisang certificate, nangangahulugan ito ng dalawang magkahiwalay na challenge, at parehong nasa iisang pangalan matatagpuan ang dalawang TXT record, ang _acme-challenge.example.com. Kailangang magkasabay silang umiral. Tama ang pagdaragdag ng ikalawang record; ang pagpapalit sa una gamit ang ikalawa ay magpapabigo sa unang challenge.
  • Binabasa ng validation ang iyong authoritative servers, ngunit maaaring umabot ng isang minuto o higit pa bago maipadala ng control panel ng provider ang bagong record papunta sa mga ito. Suriin mula sa labas bago mo hayaang tumakbo ang validation:
dig +short TXT _acme-challenge.example.com @1.1.1.1

Kapag na-print nito ang value na hiningi ng Certbot, puwede nang magtagumpay ang validation. Kapag walang na-print, maghintay at patakbuhin itong muli.

Tingnan muna kung paano ito gumagana: manual mode

Sa manual mode, ikaw mismo ang mag-e-edit ng DNS, at ito ang pinakamagandang paraan para maunawaan ang mekanismo bago ito i-automate:

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

Pinipigilan ng quotes sa paligid ng wildcard na ituring ng shell mo ang * bilang filename pattern. Humihinto si Certbot at nagbibigay ng mga instruction:

Please deploy a DNS TXT record under the name:
_acme-challenge.example.com.
with the following value:
Jx9mQ2wLr8vTn5cKp0aYdG3hB7fZs4eN1oiRuXqMk6E

Gumawa ng TXT record na iyon sa panel ng DNS provider mo, kumpirmahin na visible ito gamit ang dig command sa itaas, at saka ka lang pumindot ng Enter. Dahil hinihingi ng run na ito ang bare domain at ang wildcard, doble ang prompt ni Certbot; panatilihin ang dalawang record hanggang matapos ang pag-isyu ng certificate. Nagtatapos ang matagumpay na proseso sa mga pamilyar na linya:

Successfully received certificate.
Certificate is saved at: /etc/letsencrypt/live/example.com/fullchain.pem

Bakit hindi kayang i-renew ng manual mode ang sarili nito

Bawat renewal ay isang bagong challenge na may bagong token, kaya nagbabago ang TXT value sa tuwing magre-renew. Sa loob ng 60 araw, mawawalan na ng silbi ang record na na-paste mo ngayon. Pinapatakbo ng renewal timer ang Certbot nang walang nag-aasikaso, dalawang beses kada araw, at walang taong nasa keyboard para i-paste ang bagong value, kaya nabibigo ang renewal ng certificate na na-isyu nang manual sa eksaktong error na ito:

Failed to renew certificate example.com with error: The manual plugin is not
working; there may be problems with your existing configuration.
The error was: PluginError('An authentication script must be provided with
--manual-auth-hook when using the manual plugin non-interactively.')

Puwede mong matugunan ang requirement na iyon sa pamamagitan ng pagsulat ng mga --manual-auth-hook script na tumatawag sa API ng DNS provider mo, pero sa puntong iyon, ginagawa mo na nang manual ang sarili mong bersyon ng DNS plugin. Gamitin ang manual mode para matutunan ang flow, o para sa totoong one-off na kaso sa isang domain na hindi mo pa ma-automate ang DNS nito, at mag-set ng paalala bago pa dumating ang ika-90 araw, dahil hindi na nagpapadala ang Let's Encrypt ng mga expiry email. Para sa lahat ng iba pang kaso, gumamit ng plugin.

Ang plugin route: certbot-dns-cloudflare sa Ubuntu 24.04

Ang isang DNS plugin ang naghahawak ng API credential para sa DNS provider mo at ang buong TXT record na proseso mismo ang gumagawa nito, kapag nag-isyu at muli sa bawat pag-renew. Cloudflare ang worked example dito dahil ito ang provider plugin na pinaka-kailangan ng karamihan, at naka-package na ito sa Ubuntu.

Inirerekomenda ng aming mga Certbot guide ang mga apt package sa Ubuntu 24.04, at nananatiling totoo ang tindig na iyon para sa Cloudflare:

sudo apt update
sudo apt install certbot python3-certbot-dns-cloudflare

Isang tapat na paalala tungkol sa mga bersyon. Ang 24.04 archive ay nagshi-ship ng plugin na ito sa bersyong 2.0.0 kasabay ng Certbot 2.9.0; ipinapakita ng apt policy python3-certbot-dns-cloudflare ang sa iyo. Hindi mapanganib ang hindi pagtutugma, at gumagana ang mga scoped API token, dahil ang python3-cloudflare library sa ilalim nito sa 24.04 ay 2.11.1, mas mataas kaysa sa 2.3.1 na kailangan ng plugin para sa suporta sa token. Sa mga mas lumang Ubuntu release, masyadong luma ang library na iyon para sa mga token, at doon nanggagaling ang mga babala na makikita mo online tungkol sa apt plugin na pumipilit gumamit ng Global API Key. Sa 24.04, hindi na ito aplikable.

Sa Cloudflare dashboard, gumawa ng scoped API token, hindi ang Global API Key: My Profile, pagkatapos API Tokens, pagkatapos Create Token, na may iisang permission na Zone / DNS / Edit, limitado sa iisang zone na kung saan ka nag-iisyu. Ilagay ito sa isang file na root lang ang makakapag-basa:

sudo mkdir -p /root/.secrets
sudo tee /root/.secrets/cloudflare.ini > /dev/null <<'EOF'
dns_cloudflare_api_token = paste_your_scoped_token_here
EOF
sudo chmod 600 /root/.secrets/cloudflare.ini

Sinusuri ng Certbot ang mode at nagbababala tungkol sa Unsafe permissions on credentials configuration file kung nababasa ang file ng iba. Ngayon, mag-isyu:

sudo certbot certonly \
  --dns-cloudflare \
  --dns-cloudflare-credentials /root/.secrets/cloudflare.ini \
  -d example.com -d '*.example.com'

Ginagawa ng plugin ang mga TXT record sa pamamagitan ng API, naghihintay ng maikling propagation delay, hinahayaang tumakbo ang validation, pagkatapos ay binubura ulit ang mga record. Kung mabagal kumuha ng mga pagbabago ang name server ng zone mo, taasan ang paghihintay gamit ang --dns-cloudflare-propagation-seconds 60. Napupunta ang certificate sa /etc/letsencrypt/live/example.com/, at itinuturo mo ang nginx o Apache sa fullchain.pem at privkey.pem eksaktong gaya ng ipinapakita ng mga base guide, kasama na ang deploy hook.

Kung wala sa apt ang plugin ng iyong provider

Ang 24.04 archive ay nagpa-package lamang ng mga plugin para sa ilang provider, kabilang ang Cloudflare, Route 53, DigitalOcean, at generic RFC 2136 interface. Patakbuhin ang apt search certbot-dns upang makita ang listahan. Kung wala ang iyong provider, dito lamang naiiba ang aming apt-first na payo: i-install ang Certbot at ang plugin mula sa snap, at alisin muna ang apt Certbot upang hindi mag-agawan ang dalawang renewal timer sa /etc/letsencrypt:

sudo apt remove certbot python3-certbot-dns-cloudflare
sudo snap install --classic certbot
sudo ln -s /snap/bin/certbot /usr/bin/certbot
sudo snap set certbot trust-plugin-with-root=ok
sudo snap install certbot-dns-yourprovider

Kumokonekta lamang ang snap plugin sa snap Certbot. Hindi nito mapapalawak ang apt Certbot, kaya hindi dapat sabay na naka-install ang dalawang ito. Kung walang API ang iyong DNS host, mayroon kang tatlong praktikal na opsyon. Maaari mong ilipat ang DNS ng domain sa provider na may API. Maaari kang magpatakbo ng sarili mong name server at ituro rito ang rfc2136 plugin. Maaari mo ring panatilihin ang kasalukuyan mong DNS host at magdagdag nang isang beses ng CNAME mula _acme-challenge.example.com papunta sa validation zone na may API, gaya ng hosted acme-dns service o acme-dns server na ikaw mismo ang nagpapatakbo. Sinusundan ng Let's Encrypt ang CNAME na ito sa panahon ng validation, kaya nasa delegated zone ang mga TXT record at hindi na kailangang baguhin muli ang main zone.

Pag-renew: patunayan ngayon, hindi sa loob ng 60 araw

Itinatala ng Certbot kung paano na-issue ang bawat certificate sa /etc/letsencrypt/renewal/example.com.conf, kasama ang authenticator = dns-cloudflare at ang credentials path, kaya ni-renew ito ng standard na timer na tumatakbo dalawang beses kada araw, nang walang kailangang gawin mula sa iyo. Subukan muna ang buong proseso gamit ang staging environment:

sudo certbot renew --dry-run

Kapag pumasa ito, nangangahulugan na gumagana ang credential at kumpleto ang validation mula umpisa hanggang dulo; susunod ang parehong path ang gagamitin ng aktwal na renewal pagkalipas ng 60 araw. May dalawang dapat gawin ngayon din. Una, walang mababago sa renewed certificate na naka-disk hangga't hindi ito nire-reload ng web server, kaya i-wire ang deploy hook na inilarawan sa mga gabay para sa nginx at Apache. Pangalawa, pahalagahan ang credentials file: sinumang makakabasa nito ay makakapag-edit ng iyong DNS zone, at sapat na iyon para i-redirect ang iyong mail o para pumasa sa sarili nilang DNS-01 challenges. Panatilihin ito sa mode 600 sa ilalim ng /root, i-scope ang token sa isang zone lamang, at i-rotate ito kung sakaling maghinala kang na-leak ito.

Kailan Hindi Mo Kailangan ang Wildcard

Ang wildcard ang tamang tool kapag maraming subdomain, o kapag hindi mo mahuhulaan ang mga subdomain. Mali itong gawing default para sa lahat ng iba pa.

  • Isang subdomain lang, o kaunti at kilala na: mas simple ang normal na SAN (subject alternative name) certificate. Sinasaklaw ng certbot --nginx -d example.com -d www.example.com -d app.example.com ang hanggang 100 pangalan sa plain HTTP-01, at wala pang DNS API credential na naka-store sa server.
  • Isang label lang ang tinutugma ng wildcard. Hindi saklaw ng *.example.com ang bare example.com, kaya hiniling ng mga command sa itaas ang pareho, at hindi rin nito saklaw ang a.b.example.com; kakailanganin niyan ang *.b.example.com.
  • Iisang private key ang nasa likod ng bawat subdomain. Kapag na-breach ang machine na may hawak nito, apektado agad ang lahat ng pangalang saklaw ng wildcard.
  • Kung si Traefik ang nagta-terminate ng TLS (transport layer security) para sa mga container mo, hindi mo na kailangan ang Certbot: humihiling mismo si Traefik ng wildcard certificate sa pamamagitan ng DNS-01, gamit ang parehong uri ng provider token.

Dito talaga kapaki-pakinabang ang wildcard: mga subdomain na per-customer o per-app na ginagawa nang mas mabilis kaysa gusto mong mag-reissue ng certificate, at mga internal host na walang public port 80, tulad ng mga serbisyong maa-access lang sa loob ng isang WireGuard VPN. Hindi kailanman kumokonekta ang DNS-01 sa host na sini-certify, kaya kahit ang isang ganap na private na machine ay maaaring magkaroon ng publicly trusted na certificate.

FAQ

Makapag-iisyu ba ang Certbot ng wildcard certificate gamit ang HTTP-01?

Hindi. Pinatutunayan ng HTTP-01 ang kontrol sa isang hostname dahil kumukuha ang validation server ng token file mula sa eksaktong name na iyon. Saklaw ng wildcard ang bawat first-level name sa ilalim ng domain, kaya hinihingi ng Let's Encrypt ang DNS-01 challenge para rito. HTTP-based ang --nginx, --apache, --webroot at --standalone authenticators. Ang tanging paraan ay maglagay ng TXT record sa _acme-challenge.example.com, o sa zone kung saan ito naka-delegate gamit ang CNAME, nang mano-mano o sa pamamagitan ng DNS plugin.

Saklaw ba ng wildcard certificate ang root domain?

Hindi. Eksaktong isang label lamang ang tinutugma ng wildcard, kaya sinasaklaw ng *.example.com ang www.example.com ngunit hindi ang bare example.com at hindi rin ang a.b.example.com. Hilingin ang dalawang name sa iisang certificate gamit ang -d example.com -d '*.example.com'. Lumilikha ito ng dalawang challenge, at nasa iisang _acme-challenge.example.com name ang dalawang TXT record. Idagdag ang pangalawang record nang hindi binubura ang una.

Bakit hindi awtomatikong nagre-renew ang wildcard certificate ko?

Dahil inisyu ito gamit ang --manual. Kailangan ng bawat renewal ng bagong TXT value, at walang paraan ang unattended timer para i-paste ito. Dahil dito, humihinto ang renewal at lumalabas ang error na An authentication script must be provided with --manual-auth-hook when using the manual plugin non-interactively. I-isyu muli ang certificate gamit ang DNS plugin gaya ng certbot-dns-cloudflare, o magbigay ng --manual-auth-hook at --manual-cleanup-hook scripts na nag-e-edit ng record sa pamamagitan ng API ng iyong provider.

Gaano katagal bago lumitaw ang _acme-challenge TXT record?

Depende ito sa DNS provider mo: maaaring ilang segundo hanggang ilang minuto. Binabasa ng validation ang authoritative servers ng zone mo, kaya suriin gamit ang dig +short TXT _acme-challenge.example.com @1.1.1.1 at maghintay hanggang lumitaw ang inaasahang value bago ipagpatuloy ang manual na run. Kapag plugin ang gamit, dagdagan ang built-in wait sa pamamagitan ng propagation option ng plugin, halimbawa --dns-cloudflare-propagation-seconds 60, kung iniulat ng validation na hindi nakita ang record.

Mas hindi ba secure ang wildcard certificate kaysa sa normal na certificate?

Magkapareho ang cryptography ng mga ito. Ang pagkakaiba ay nasa operasyon: isang private key ang sumasaklaw sa lahat ng subdomain, kaya mas malawak ang epekto kapag nakompromiso ito. Sensitive secret din ang DNS API credential na kailangan ng automation, at naka-store ito sa server. Kung iilan lamang ang kilala mong subdomain, iniiwasan ng SAN certificate ang dalawang panganib na ito. Ito mismo ang sitwasyong inirerekomenda ng gabay na ito na huwag gumamit ng wildcard.

Nakatulong ba ang artikulong ito?