LLI Wiki — My Digital Knowledge Base

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/.

Mastodon LLIMastodon SocialFosstodon