PrivateBin sous nginx et uWSGI : dossier /run, Certbot et GoAccess
Mémo : droits, dossier /run manquant pour uWSGI, certificat Let's Encrypt avec Certbot et rapport GoAccess en temps réel.
Mémo d'exploitation pour une instance PrivateBin servie par nginx et uWSGI sur Debian : droits sur les dossiers, dossier /run manquant, certificat Let's Encrypt avec Certbot et rapport GoAccess en temps réel. L'installation initiale suit ce guide.
Droits sur les dossiers de l'application
L'utilisateur système privatebin doit être propriétaire du code et du dossier de données :
sudo chown -R privatebin:privatebin <install_dir>/privatebin
sudo chown -R privatebin:privatebin /var/lib/privatebin
Le service uWSGI ne démarre plus : dossier /run manquant
Si la configuration uWSGI (/etc/uwsgi/privatebin.ini) place son socket dans /run/privatebin, ce dossier disparaît à chaque redémarrage car /run est un système de fichiers temporaire. Le service échoue alors au démarrage (voir journalctl -xeu <service>). Correctif immédiat :
sudo mkdir /run/privatebin
sudo chown privatebin:privatebin /run/privatebin
sudo systemctl restart <service uwsgi de l'application>
Pour que le dossier soit recréé à chaque démarrage, voir cette discussion : How to have uWSGI create a /run/uwsgi folder on reboot.
Certificat Let's Encrypt avec Certbot
sudo certbot --nginx --agree-tos --redirect --staple-ocsp --email admin@example.com -d privatebin.example.com
| Option | Rôle |
|---|---|
--nginx |
Utilise le plugin nginx : obtient le certificat et modifie la configuration du site |
--agree-tos |
Accepte les conditions d'utilisation sans question |
--redirect |
Ajoute la redirection HTTP vers HTTPS |
--staple-ocsp |
Active l'OCSP stapling |
--email |
Adresse de contact pour les alertes d'expiration |
-d |
Nom de domaine du certificat |
Pour supprimer manuellement un certificat (par exemple après une émission ratée), supprimer ses trois emplacements :
sudo rm -rf /etc/letsencrypt/live/privatebin.example.com/
sudo rm -rf /etc/letsencrypt/renewal/privatebin.example.com.conf
sudo rm -rf /etc/letsencrypt/archive/privatebin.example.com/
La commande sudo certbot delete --cert-name privatebin.example.com fait la même chose proprement.
Rapport GoAccess en temps réel sur HTTPS
GoAccess génère un rapport HTML à partir du journal d'accès nginx. Avec --real-time-html, il sert aussi un WebSocket ; sur un site en HTTPS il faut lui fournir le certificat et la clé :
goaccess /var/log/nginx/access.log -o /var/www/goaccess/report.html --real-time-html \
--ssl-cert=/etc/letsencrypt/live/goaccess.example.com/fullchain.pem \
--ssl-key=/etc/letsencrypt/live/goaccess.example.com/privkey.pem
Les directives ssl_certificate, ssl_certificate_key, ssl_trusted_certificate, ssl_stapling et include .../options-ssl-nginx.conf ajoutées par Certbot dans le bloc server de nginx pointent vers les mêmes fichiers du dossier live/.