Panneau Puffer

Accéder à PufferPanel

Ouvrez votre navigateur et allez sur : https://<SERVER_IP>

Un avertissement SSL du navigateur est attendu (certificat auto-signé).

Exécutez la commande suivante sur le serveur pour créer votre premier utilisateur. Assurez-vous de saisir « Y » lorsqu'il vous demande s'il s'agit d'un administrateur afin que vous puissiez utiliser pleinement votre panneau.

pufferpanel user add

Connectez-vous avec votre compte administrateur.

Accédez à Paramètres et configurez :

• URL principale (par exemple, https://<SERVER_IP>)
• Contrôler l'enregistrement des utilisateurs
• Configuration de la messagerie (facultatif)

Ports

• Interface utilisateur Web : 8080
• SFTP : 5657

Fichiers et répertoires importants

• Configuration du panneau : /etc/pufferpanel/config.json
• Journaux du panneau : /var/log/pufferpanel
• Racine Web (nginx) : /var/www/pufferpanel
• Certificats SSL : /etc/nginx/ssl/pufferpanel.crt & /etc/nginx/ssl/pufferpanel.key

Gestion des services

Panneau Puffer :

systemctl start pufferpanel
systemctl stop pufferpanel
systemctl restart pufferpanel
systemctl status pufferpanel

Nginx :

systemctl start nginx
systemctl stop nginx
systemctl restart nginx
systemctl reload nginx
systemctl status nginx

Activer SSL avec un domaine

1. Faites pointer votre domaine vers l'IP du serveur.

2. Modifiez la config Nginx et remplacez les deux server_name <IP>; avec votre domaine (<your-domain>) dans les blocs HTTP (port 80) et HTTPS (port 443) :

vim /etc/nginx/sites-available/pufferpanel.conf

3. Installez Certbot :

apt install -y certbot python3-certbot-nginx

4. Lancez la commande suivante pour générer un certificat Let's Encrypt valide :

certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com

5. Remplacez les chemins SSL dans la config Nginx :

vim /etc/nginx/sites-available/pufferpanel.conf
# Before:
    # ssl_certificate     /etc/nginx/ssl/pufferpanel.crt;
    # ssl_certificate_key /etc/nginx/ssl/pufferpanel.key;
# After:
    # ssl_certificate /etc/letsencrypt/live/yourdomain.com/fullchain.pem;
    # ssl_certificate_key /etc/letsencrypt/live/yourdomain.com/privkey.pem;

6. Redémarrez Nginx pour appliquer les changements :

systemctl restart nginx

7. Définissez l'URL principale dans les paramètres de l'interface utilisateur Web sur https://yourdomain.com

8. Ouvrez votre navigateur et visitez : https://yourdomain.com

Remarques

• Nginx est configuré pour rediriger automatiquement HTTP → HTTPS.
• SSL est auto-signé. Pour la production, pensez à utiliser Let's Encrypt / Certbot.
• Docker est installé et le pufferpanel l'utilisateur est ajouté au groupe Docker.