docs: add debug mode documentation to README
Added comprehensive documentation about debug mode: In "Résolution de problèmes" section: - How to check debug mode status - How to disable debug mode (production) - How to enable temporarily (development only) - Security warnings and risks explained In "Sécurité" section: - Added to best practices checklist - Reminder to verify debug mode is disabled Key warnings included: - Security: exposes sensitive information - Performance: excessive logging slows down app - Disk space: fills up disk quickly - Compliance: may log personal data (GDPR) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
This commit is contained in:
39
README.md
39
README.md
@@ -339,6 +339,44 @@ du -sh ./data # Données Nextcloud
|
|||||||
du -sh ./db # Base de données MariaDB
|
du -sh ./db # Base de données MariaDB
|
||||||
```
|
```
|
||||||
|
|
||||||
|
### Mode débogage
|
||||||
|
|
||||||
|
⚠️ **IMPORTANT**: Le mode débogage ne doit **JAMAIS** être activé en production!
|
||||||
|
|
||||||
|
**Vérifier l'état du mode débogage:**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
make occ config:system:get debug
|
||||||
|
```
|
||||||
|
|
||||||
|
**Désactiver le mode débogage (PRODUCTION):**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Via OCC (recommandé)
|
||||||
|
make occ config:system:set debug --value=false --type=boolean
|
||||||
|
|
||||||
|
# OU éditer manuellement config.php
|
||||||
|
docker-compose exec nextcloud nano /var/www/html/config/config.php
|
||||||
|
# Chercher 'debug' => true, et changer en false ou supprimer la ligne
|
||||||
|
```
|
||||||
|
|
||||||
|
**Activer temporairement pour diagnostiquer un problème (DÉVELOPPEMENT UNIQUEMENT):**
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Activer
|
||||||
|
make occ config:system:set debug --value=true --type=boolean
|
||||||
|
|
||||||
|
# IMPORTANT: Désactiver immédiatement après le diagnostic!
|
||||||
|
make occ config:system:set debug --value=false --type=boolean
|
||||||
|
```
|
||||||
|
|
||||||
|
**Pourquoi c'est dangereux en production:**
|
||||||
|
|
||||||
|
- 🚨 **Sécurité**: Expose des informations sensibles (chemins, configuration, requêtes SQL)
|
||||||
|
- 🐌 **Performance**: Génère énormément de logs et ralentit l'application
|
||||||
|
- 💾 **Espace disque**: Remplit rapidement le disque avec des logs détaillés
|
||||||
|
- 📊 **Conformité**: Peut logger des données personnelles (RGPD)
|
||||||
|
|
||||||
## 📊 Monitoring
|
## 📊 Monitoring
|
||||||
|
|
||||||
### Vérifications de santé
|
### Vérifications de santé
|
||||||
@@ -381,6 +419,7 @@ docker compose exec redis redis-cli -a ${REDIS_HOST_PASSWORD} INFO stats
|
|||||||
3. **Mises à jour régulières**: Exécutez `make backup` puis `make update` mensuellement
|
3. **Mises à jour régulières**: Exécutez `make backup` puis `make update` mensuellement
|
||||||
4. **Sauvegardes**: Utilisez `make backup` avant toute mise à jour (backup serveur quotidien géré au niveau système)
|
4. **Sauvegardes**: Utilisez `make backup` avant toute mise à jour (backup serveur quotidien géré au niveau système)
|
||||||
5. **Monitoring**: Vérifiez les logs régulièrement pour détecter les activités suspectes
|
5. **Monitoring**: Vérifiez les logs régulièrement pour détecter les activités suspectes
|
||||||
|
6. **Mode débogage désactivé**: Vérifiez avec `make occ config:system:get debug` (doit être `false` ou absent)
|
||||||
|
|
||||||
### Sécuriser l'accès
|
### Sécuriser l'accès
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user