The requested nginx plugin does not appear to be installed
Ai rulat certbot --nginx, dar pachetul cu pluginul pentru nginx nu e instalat. Pe Ubuntu instalează python3-certbot-nginx (sau, cu snap, certbot din snap, care îl include) și rulează din nou comanda.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
certbot e împărțit în bucăți: programul de bază și câte un plugin pentru fiecare server web. Opțiunea --nginx îi cere să folosească pluginul care citește și modifică configurația nginx. The requested nginx plugin does not appear to be installed înseamnă că certbot a pornit, dar nu găsește acel plugin.
Pe Ubuntu, apt install certbot instalează doar baza; pluginul vine în pachetul separat python3-certbot-nginx (pentru Apache, python3-certbot-apache). Instalarea prin snap (snap install --classic certbot) include ambele pluginuri. O altă cauză: două instalări de certbot (una din apt, una din pip sau snap), iar comanda din PATH e cea fără plugin; which -a certbot le arată.
După instalarea pluginului, certbot plugins trebuie să listeze nginx.
De ce apare: cauzele frecvente
1Doar pachetul de bază instalat
apt-get install -y nginx certbot
certbot --nginx -d magazin-exemplu.roapt-get install -y nginx certbot python3-certbot-nginx
certbot --nginx -d magazin-exemplu.roPluginul nginx e într-un pachet separat. Cu el instalat, --nginx găsește pluginul.
2Două instalări de certbot
pip install certbot
certbot --nginxwhich -a certbot
sudo snap install --classic certbotUn certbot din pip nu vede pluginul instalat cu apt. O singură instalare, cu pluginul inclus, elimină confuzia.
3Plugin pentru alt server web
apt-get install -y python3-certbot-apache
certbot --nginxapt-get install -y python3-certbot-nginxFiecare server web are pluginul lui. Pentru nginx e nevoie de python3-certbot-nginx.
Repară eroarea, direct în pagină
Scriptul instaleaza.sh pregătește un server nou: instalează nginx și certbot, apoi cere certificatul cu pluginul nginx. La rulare se oprește cu The requested nginx plugin does not appear to be installed. Completează linia de instalare a pachetelor ca pluginul să fie instalat împreună cu certbot.
Indiciu
Pe Ubuntu, pluginul are un pachet propriu, cu numele python3-certbot-...
Reparația
Adaugă pachetul pluginului în linia de instalare:
sed -i 's/install -y nginx certbot$/install -y nginx certbot python3-certbot-nginx/' instaleaza.sh
cat instaleaza.sh#!/bin/bash
set -e
apt-get update
apt-get install -y nginx certbot python3-certbot-nginx
certbot --nginx -d magazin-exemplu.ro -d www.magazin-exemplu.roDe ce merge
apt-get install certbot aducea doar programul de bază, fără codul care știe să lucreze cu nginx, așa că certbot --nginx nu găsea pluginul. python3-certbot-nginx adaugă acel plugin. Cu el instalat în aceeași comandă, certbot --nginx poate citi configurația, obține certificatul și configura nginx să-l folosească.
Alte forme ale mesajului
The requested apache plugin does not appear to be installedCould not choose appropriate plugin: The requested nginx plugin does not appear to be installed
Cum o eviți pe viitor
- În scriptul de instalare, pune pluginul lângă certbot:
certbot python3-certbot-nginx. - Folosește o singură metodă de instalare (apt sau snap), nu amândouă.
- Verifică cu
certbot pluginsînainte de prima cerere de certificat. - După instalare, testează reînnoirea cu
certbot renew --dry-run.
Întrebări frecvente
Pot folosi certbot fără plugin?
Da, cu --webroot sau --standalone, care nu au nevoie de pluginul nginx. Atunci configurezi singur certificatul în nginx.
Pluginul modifică singur configurația nginx?
Da: adaugă ssl_certificate, listen 443 ssl și, dacă alegi, redirecționarea HTTP → HTTPS. Verifică apoi cu nginx -t.
Erori înrudite
Could not automatically find a matching server block for magazin-exemplu.ro. Set the `server_name` directive to use the Nginx installer. certbot --nginx a obținut (sau vrea să instaleze) certificatul, dar nu găsește în configurarea nginx un bloc server cu server_name magazin-exemplu.ro. Pune numele domeniului în server_name, verifică cu sudo nginx -t și rulează din nou certbot. Could not bind TCP port 80 because it is already in use by another process on this system (such as a web server). Please stop the program in question and then try again. certbot --standalone vrea să pornească propriul server web pe portul 80, dar acolo rulează deja nginx sau Apache. Nu opri site-ul: folosește --webroot -w /var/www/site (sau pluginul --nginx), care trec verificarea prin serverul web existent. nginx: [emerg] no "ssl_certificate" is defined for the "listen ... ssl" directive in /etc/nginx/sites-enabled/magazin:2 Blocul server ascultă cu TLS (listen 443 ssl), dar nu spune ce certificat și ce cheie să folosească, deci nginx nu pornește. Adaugă în același bloc ssl_certificate cu fullchain.pem și ssl_certificate_key cu privkey.pem, apoi rulează sudo nginx -t. Învață Securitate cibernetică de la zero, cu exerciții la fiecare lecție
Curs Cybersecurity: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
