# Guides d'administration serveur

Collection de guides pratiques pour administrer des serveurs Linux et services auto-hébergés.

## 📁 Structure

```
serveur/
├── linux-essentials/     Guides généralistes Linux
└── forgejo/             Guides spécifiques Forgejo
```

---

## 🚀 Démarrage rapide

### Vous débutez sur Linux ?
👉 Commencez par [linux-essentials/architecture-filesystem.md](linux-essentials/architecture-filesystem.md)

### Votre disque est plein ?
👉 Suivez [linux-essentials/diagnostic-espace-disque.md](linux-essentials/diagnostic-espace-disque.md)

### Problème avec Forgejo ?
👉 Consultez [forgejo/QUICK-START.md](forgejo/QUICK-START.md)

---

## 📚 Tous les guides

### [linux-essentials/](linux-essentials/) - Bases Linux

| Guide | Description | Niveau | Temps |
|-------|-------------|--------|-------|
| **[architecture-filesystem.md](linux-essentials/architecture-filesystem.md)** | Comprendre /etc, /var, /lib et l'organisation Linux | Débutant | 30-45 min |
| **[diagnostic-espace-disque.md](linux-essentials/diagnostic-espace-disque.md)** | Identifier et résoudre les problèmes d'espace disque | Débutant | 15-30 min |
| **[analyse-logs-detection-bots.md](linux-essentials/analyse-logs-detection-bots.md)** | Analyser les logs, détecter et bloquer les bots | Intermédiaire | 20-40 min |
| **[comprendre-commandes-find-du.md](linux-essentials/comprendre-commandes-find-du.md)** | Maîtriser find, du, pipes et grep (pédagogique) | Débutant | 1h |

### [forgejo/](forgejo/) - Forge Git

| Guide | Description | Niveau | Temps |
|-------|-------------|--------|-------|
| **[QUICK-START.md](forgejo/QUICK-START.md)** | Sécuriser Forgejo contre les bots en 15 min | Intermédiaire | 15 min |
| **[bloquer-telechargements-abusifs.md](forgejo/bloquer-telechargements-abusifs.md)** | Guide complet : Fail2ban, rate limiting, monitoring | Intermédiaire | 30-60 min |

---

## 🎯 Par problème

### Disque saturé (100%)

**Diagnostic :**
1. Identifier le coupable → [diagnostic-espace-disque.md](linux-essentials/diagnostic-espace-disque.md)
2. Si c'est `repo-archive` (Forgejo) → [forgejo/bloquer-telechargements-abusifs.md](forgejo/bloquer-telechargements-abusifs.md)

### Bots qui attaquent

**Actions :**
1. Analyser les logs → [analyse-logs-detection-bots.md](linux-essentials/analyse-logs-detection-bots.md)
2. Bloquer avec Fail2ban → [forgejo/bloquer-telechargements-abusifs.md](forgejo/bloquer-telechargements-abusifs.md)

### Apprendre Linux

**Parcours :**
1. Architecture système → [architecture-filesystem.md](linux-essentials/architecture-filesystem.md)
2. Commandes essentielles → [comprendre-commandes-find-du.md](linux-essentials/comprendre-commandes-find-du.md)
3. Pratique → [diagnostic-espace-disque.md](linux-essentials/diagnostic-espace-disque.md)

---

## 🔧 Commandes les plus utiles

### Espace disque
```bash
df -h                                    # Vue globale
sudo du -sh /* | sort -h | tail -10      # Top 10 racine
sudo du -sh /var/* | sort -h | tail -10  # Top 10 dans /var
```

### Fichiers
```bash
find /path -type f -size +100M           # Gros fichiers
find /path -type f -mmin +360            # Fichiers de +6h
find /path -type f -mmin +360 -delete    # Supprimer fichiers de +6h
```

### Logs
```bash
sudo journalctl -u service -n 50         # Logs d'un service
sudo tail -f /var/log/syslog             # Logs système en temps réel
docker logs container --since 24h        # Logs Docker 24h
```

### Système
```bash
ls -la /etc/                             # Configurations
ls -la /var/log/                         # Logs
du -sh /var/lib/docker                   # Données Docker
```

---

## 📖 Référence rapide

### Dossiers Linux essentiels

| Dossier | Rôle | Exemple typique |
|---------|------|-----------------|
| `/etc` | Configurations | `/etc/nginx/nginx.conf` |
| `/var/log` | Logs | `/var/log/syslog` |
| `/var/lib` | Données d'état | `/var/lib/docker/` |
| `/home` | Dossiers utilisateurs | `/home/debian/` |
| `/tmp` | Temporaire (vidé au reboot) | `/tmp/fichier` |
| `/usr/bin` | Commandes système | `/usr/bin/python3` |
| `/usr/local/bin` | Commandes manuelles | `/usr/local/bin/mon-script` |

Voir le guide complet : [architecture-filesystem.md](linux-essentials/architecture-filesystem.md)

---

## 🆘 Aide rapide

### Mon disque est plein
```bash
df -h                                    # Identifier le disque
sudo du -sh /* | sort -h | tail -10      # Trouver le gros dossier
```
→ Puis consulter [diagnostic-espace-disque.md](linux-essentials/diagnostic-espace-disque.md)

### Je ne trouve pas un fichier de config
```bash
find /etc -name "*mot-clé*"              # Chercher dans /etc
```
→ Voir [architecture-filesystem.md](linux-essentials/architecture-filesystem.md)

### Fail2ban ne fonctionne pas
```bash
sudo fail2ban-client status              # Vérifier les jails actives
sudo journalctl -u fail2ban -n 50        # Voir les logs
```
→ Consulter [forgejo/bloquer-telechargements-abusifs.md](forgejo/bloquer-telechargements-abusifs.md)

---

## 🌱 Contribuer

Ces guides sont créés à partir de diagnostics réels sur des serveurs en production.

**Structure des guides :**
- Généralistes → `linux-essentials/`
- Spécifiques à un service → `nom-service/`

**Améliorations bienvenues :**
- Nouveaux guides
- Corrections
- Clarifications
- Scripts d'automatisation