Accès
- Ouvrez votre navigateur :
https://<SERVER-IP> - Acceptez l'avertissement de certificat du navigateur, car l'installation utilise un certificat TLS auto-signé.
- Une authentification est requise (fenêtre Basic Auth)
- Méthode d'authentification : HTTP Basic Auth
- Les identifiants de connexion sont stockés de manière sécurisée dans :
/root/.cloudzy-creds
Ajouter des fichiers
- Placez les fichiers et dossiers que vous souhaitez partager dans :
/root/directory-lister/files - Directory Lister lit ce répertoire directement : les fichiers ajoutés apparaissent automatiquement, sans redémarrer l'application.
Fichiers et répertoires importants
- Chemin d'installation :
/root/directory-lister - Fichiers listés :
/root/directory-lister/files - Fichier Docker Compose :
/root/directory-lister/docker-compose.yml - Fichier d'environnement :
/root/directory-lister/.env - Identifiants :
/root/directory-lister/.credentials - Configuration Nginx :
/etc/nginx/sites-available/directory-lister - Fichier Basic Auth :
/etc/nginx/.htpasswd-directory-lister - Certificat TLS :
/etc/nginx/ssl/directory-lister.crt - Clé privée TLS :
/etc/nginx/ssl/directory-lister.key
Gestion des services
Afficher les conteneurs en cours d'exécution :
docker compose -f /root/directory-lister/docker-compose.yml ps
Redémarrer Directory Lister :
docker compose -f /root/directory-lister/docker-compose.yml restart
Consulter les journaux de Directory Lister :
cd /root/directory-lister && docker compose logs -f
Arrêter Directory Lister :
docker compose -f /root/directory-lister/docker-compose.yml stop
Démarrer Directory Lister :
docker compose -f /root/directory-lister/docker-compose.yml start
Recréer Directory Lister :
docker compose -f /root/directory-lister/docker-compose.yml up -d
Vérifier l'état de Nginx :
systemctl status nginx
Redémarrer Nginx :
systemctl restart nginx
Recharger Nginx :
systemctl reload nginx
Validez la configuration de Nginx :
nginx -t
Activation de HTTPS avec un domaine
1. Faites pointer votre domaine vers l'IP du serveur.
2. Modifiez /etc/nginx/sites-available/directory-lister et remplacez les deux server_name _; directives par votre domaine (par ex. server_name yourdomain.com;).
3. Installez Certbot :
apt install -y certbot python3-certbot-nginx
4. Obtenez un certificat Let's Encrypt :
certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com
5. Modifiez /etc/nginx/sites-available/directory-lister et mettez à jour les ssl_certificate et ssl_certificate_key directives pour utiliser votre certificat Let's Encrypt.
Before:
ssl_certificate /etc/nginx/ssl/directory-lister.crt;
ssl_certificate_key /etc/nginx/ssl/directory-lister.key;
After:
ssl_certificate /etc/letsencrypt/live/yourdomain.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/yourdomain.com/privkey.pem;
6. Rechargez Nginx pour appliquer les modifications :
systemctl reload nginx
7. Accédez à Directory Lister à l'adresse https://yourdomain.com.
Désactiver HTTP Basic Auth dans Nginx (facultatif)
Pour rendre Directory Lister accessible publiquement sans authentification, suivez les étapes ci-dessous afin de désactiver HTTP Basic Auth.
Modifiez le fichier de site Nginx : /etc/nginx/sites-available/directory-lister
Supprimez ou commentez ces lignes :
auth_basic "Directory Lister";
auth_basic_user_file /etc/nginx/.htpasswd-directory-lister;
Recharger Nginx :
systemctl restart nginx
Remarques
- Directory Lister s'exécute dans Docker derrière NGINX.
- L'accès public est protégé par HTTP Basic Authentication.
- Les fichiers listés sont stockés dans
/root/directory-lister/files. - Le conteneur de l'application n'a qu'un accès en lecture au répertoire des fichiers.
