📚 Guides techniques

Collection de guides et conventions pour le développement et l'administration système.

---

📁 Structure

guides/
├── serveur/          Guides d'administration serveur Linux
└── conventions/      Conventions de code et bonnes pratiques

---

🚀 Démarrage rapide

Configuration d'un VPS

Vous avez un nouveau serveur VPS à configurer ? 👉 serveur/vps-setup-rapide.md - Setup rapide (30-50 min) 👉 serveur/vps-setup-complet.md - Guide détaillé (1-2h)

Administration serveur

Votre disque est plein, des bots attaquent votre serveur, ou vous cherchez un fichier ? 👉 serveur/ - Tous les guides Linux essentiels

Conventions de code

Vous développez une application SvelteKit ? 👉 conventions/svelte-kit-frontend-conventions.md

---

📖 Tous les guides

serveur/ - Administration serveur

Configuration VPS :

• vps-setup-rapide.md - Setup VPS rapide (30-50 min)
• vps-setup-complet.md - Setup VPS détaillé (1-2h)
• kirby-vps-deploy.md - Déployer Kirby CMS sur VPS
• kirby-ci-cd-deploy.md - CI/CD automatique pour Kirby

Linux essentials :

• vim-guide-essentiel.md - Maîtriser Vim (éditeur universel)
• architecture-filesystem.md - Comprendre /etc, /var, /lib
• diagnostic-espace-disque.md - Résoudre les problèmes d'espace
• analyse-logs-detection-bots.md - Analyser les logs et bloquer les bots
• comprendre-commandes-find-du.md - Maîtriser find, du, grep

Forgejo (forge Git) :

• forgejo/QUICK-START.md - Sécuriser Forgejo en 15 min
• forgejo/bloquer-telechargements-abusifs.md - Fail2ban, rate limiting

conventions/ - Bonnes pratiques

• svelte-kit-frontend-conventions.md - Structure et conventions pour SvelteKit

---

🎯 Par besoin

Je viens d'avoir un VPS

1. Apprendre Vim - Éditeur essentiel (15 min)
2. Configuration VPS complète - Sécurité, serveur web, SSL
3. Architecture Linux - Comprendre où sont les fichiers
4. Commandes essentielles - find, du, grep

Mon serveur a un problème

• Disque plein → diagnostic-espace-disque.md
• Attaque de bots → analyse-logs-detection-bots.md
• Forgejo saturé → bloquer-telechargements-abusifs.md

Je développe une application

• SvelteKit → svelte-kit-frontend-conventions.md

---

🔍 Recherche rapide

Commandes serveur

# Espace disque
df -h                                    # Vue globale
du -sh /* | sort -h | tail -10           # Top 10 dossiers

# Recherche de fichiers
find /path -name "*.log" -size +100M     # Gros fichiers logs
grep -r "erreur" /var/log/               # Chercher dans les logs

# Services
systemctl status apache2                 # État d'un service
journalctl -u service -n 50              # Logs d'un service

SSH et déploiement

# Connexion
ssh user@host

# Déploiement avec rsync
rsync -avhP ./dist/ user@host:/var/www/site/

# Certificat SSL
certbot --apache -d example.com

Pare-feu et sécurité

# UFW
ufw status verbose                       # État du pare-feu
ufw allow 80/tcp                         # Autoriser un port

# Fail2ban
fail2ban-client status                   # Vue d'ensemble
fail2ban-client status sshd              # IPs bannies SSH

---

🛠️ Outils utiles

• Explain Shell - Décompose les commandes shell
• SSL Labs - Teste la configuration SSL
• Security Headers - Teste les en-têtes de sécurité

---

📝 Notes

Ces guides sont créés à partir d'expériences réelles en production. Ils sont conçus pour être :

• Pratiques : Des solutions concrètes à des problèmes réels
• Pédagogiques : Explications détaillées pour comprendre ce qu'on fait
• Rapides : Temps de lecture/application indiqué pour chaque guide

Structure des guides :

• 📋 Table des matières pour navigation rapide
• ✅ Checklists pour ne rien oublier
• ⚠️ Avertissements sur les points critiques
• 💡 Tips et bonnes pratiques
• 🔍 Sections troubleshooting

---

🌱 Contribuer

Améliorations bienvenues :

• Nouveaux guides
• Corrections et clarifications
• Scripts d'automatisation
• Traductions

Organisation :

• Guides serveur → serveur/
• Guides spécifiques à un service → serveur/nom-service/
• Conventions de code → conventions/