2026-02-13 14:58:13 +01:00 · 2026-02-13 14:58:13 +01:00 · d0a243509d
commit d0a243509d
parent 9218efa6e2
9 changed files with 4546 additions and 6 deletions
--- a/README.md
+++ b/README.md
@ -0,0 +1,156 @@
+# 📚 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](serveur/vps-setup-rapide.md)** - Setup rapide (30-50 min)
+👉 **[serveur/vps-setup-complet.md](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/](serveur/)** - Tous les guides Linux essentiels
+
+### Conventions de code
+Vous développez une application SvelteKit ?
+👉 **[conventions/svelte-kit-frontend-conventions.md](conventions/svelte-kit-frontend-conventions.md)**
+
+---
+
+## 📖 Tous les guides
+
+### [serveur/](serveur/) - Administration serveur
+
+**Configuration VPS :**
+- **[vps-setup-rapide.md](serveur/vps-setup-rapide.md)** - Setup VPS rapide (30-50 min)
+- **[vps-setup-complet.md](serveur/vps-setup-complet.md)** - Setup VPS détaillé (1-2h)
+- **[kirby-vps-deploy.md](serveur/kirby-vps-deploy.md)** - Déployer Kirby CMS sur VPS
+- **[kirby-ci-cd-deploy.md](serveur/kirby-ci-cd-deploy.md)** - CI/CD automatique pour Kirby
+
+**Linux essentials :**
+- **[vim-guide-essentiel.md](serveur/linux-essentials/vim-guide-essentiel.md)** - Maîtriser Vim (éditeur universel)
+- **[architecture-filesystem.md](serveur/linux-essentials/architecture-filesystem.md)** - Comprendre /etc, /var, /lib
+- **[diagnostic-espace-disque.md](serveur/linux-essentials/diagnostic-espace-disque.md)** - Résoudre les problèmes d'espace
+- **[analyse-logs-detection-bots.md](serveur/linux-essentials/analyse-logs-detection-bots.md)** - Analyser les logs et bloquer les bots
+- **[comprendre-commandes-find-du.md](serveur/linux-essentials/comprendre-commandes-find-du.md)** - Maîtriser find, du, grep
+
+**Forgejo (forge Git) :**
+- **[forgejo/QUICK-START.md](serveur/forgejo/QUICK-START.md)** - Sécuriser Forgejo en 15 min
+- **[forgejo/bloquer-telechargements-abusifs.md](serveur/forgejo/bloquer-telechargements-abusifs.md)** - Fail2ban, rate limiting
+
+### [conventions/](conventions/) - Bonnes pratiques
+
+- **[svelte-kit-frontend-conventions.md](conventions/svelte-kit-frontend-conventions.md)** - Structure et conventions pour SvelteKit
+
+---
+
+## 🎯 Par besoin
+
+### Je viens d'avoir un VPS
+1. **[Apprendre Vim](serveur/linux-essentials/vim-guide-essentiel.md)** - Éditeur essentiel (15 min)
+2. **[Configuration VPS complète](serveur/vps-setup.md)** - Sécurité, serveur web, SSL
+3. **[Architecture Linux](serveur/linux-essentials/architecture-filesystem.md)** - Comprendre où sont les fichiers
+4. **[Commandes essentielles](serveur/linux-essentials/comprendre-commandes-find-du.md)** - find, du, grep
+
+### Mon serveur a un problème
+- **Disque plein** → [diagnostic-espace-disque.md](serveur/linux-essentials/diagnostic-espace-disque.md)
+- **Attaque de bots** → [analyse-logs-detection-bots.md](serveur/linux-essentials/analyse-logs-detection-bots.md)
+- **Forgejo saturé** → [bloquer-telechargements-abusifs.md](serveur/forgejo/bloquer-telechargements-abusifs.md)
+
+### Je développe une application
+- **SvelteKit** → [svelte-kit-frontend-conventions.md](conventions/svelte-kit-frontend-conventions.md)
+
+---
+
+## 🔍 Recherche rapide
+
+### Commandes serveur
+```bash
+# 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
+```bash
+# 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é
+```bash
+# 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](https://explainshell.com/)** - Décompose les commandes shell
+- **[SSL Labs](https://www.ssllabs.com/ssltest/)** - Teste la configuration SSL
+- **[Security Headers](https://securityheaders.com/)** - 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/`
--- a/serveur/README.md
+++ b/serveur/README.md
@ -6,6 +6,7 @@ Collection de guides pratiques pour administrer des serveurs Linux et services a

 ```
 serveur/
+├── vps-setup.md          Configuration complète d'un VPS depuis zéro
 ├── linux-essentials/     Guides généralistes Linux
 └── forgejo/             Guides spécifiques Forgejo
 ```
@ -14,6 +15,9 @@ serveur/

 ## 🚀 Démarrage rapide

+### Vous avez un nouveau VPS ?
+👉 Suivez [vps-setup.md](vps-setup.md) pour le configurer et sécuriser
+
 ### Vous débutez sur Linux ?
 👉 Commencez par [linux-essentials/architecture-filesystem.md](linux-essentials/architecture-filesystem.md)

@ -27,10 +31,20 @@ serveur/

 ## 📚 Tous les guides

+### Configuration VPS
+
+| Guide | Description | Niveau | Temps |
+|-------|-------------|--------|-------|
+| **[vps-setup-rapide.md](vps-setup-rapide.md)** | Setup VPS rapide et sécurisé (SSH, UFW, Fail2ban, Apache, SSL) | Débutant | 30-50 min |
+| **[vps-setup-complet.md](vps-setup-complet.md)** | Guide détaillé avec explications approfondies | Débutant | 1-2h |
+| **[kirby-vps-deploy.md](kirby-vps-deploy.md)** | Déployer Kirby CMS sur VPS (VirtualHost, multi-sites, déploiement) | Intermédiaire | 20-30 min |
+| **[kirby-ci-cd-deploy.md](kirby-ci-cd-deploy.md)** | CI/CD pour Kirby (GitLab CI, Forgejo Actions, Docker) | Avancé | 1-2h setup |
+
 ### [linux-essentials/](linux-essentials/) - Bases Linux

 | Guide | Description | Niveau | Temps |
 |-------|-------------|--------|-------|
+| **[vim-guide-essentiel.md](linux-essentials/vim-guide-essentiel.md)** | Maîtriser Vim pour éditer les fichiers de configuration | Débutant | 15-30 min |
 | **[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 |
@ -47,6 +61,16 @@ serveur/

 ## 🎯 Par problème

+### Nouveau VPS à configurer
+
+**Parcours rapide (30-50 min) :**
+1. Setup de base → [vps-setup-rapide.md](vps-setup-rapide.md)
+2. Déployer Kirby → [kirby-vps-deploy.md](kirby-vps-deploy.md)
+
+**Parcours détaillé (2-3h) :**
+1. Setup complet → [vps-setup-complet.md](vps-setup-complet.md)
+2. Déployer Kirby → [kirby-vps-deploy.md](kirby-vps-deploy.md)
+
 ### Disque saturé (100%)

 **Diagnostic :**
@ -62,14 +86,45 @@ serveur/
 ### 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)
+1. Éditeur Vim → [vim-guide-essentiel.md](linux-essentials/vim-guide-essentiel.md) ⭐ Essentiel
+2. Architecture système → [architecture-filesystem.md](linux-essentials/architecture-filesystem.md)
+3. Commandes essentielles → [comprendre-commandes-find-du.md](linux-essentials/comprendre-commandes-find-du.md)
+4. Pratique → [diagnostic-espace-disque.md](linux-essentials/diagnostic-espace-disque.md)

 ---

 ## 🔧 Commandes les plus utiles

+### Configuration VPS
+```bash
+# Première connexion
+ssh root@IP_DU_VPS
+
+# Créer un utilisateur
+adduser monuser && usermod -aG sudo monuser
+
+# Configurer le pare-feu
+ufw allow 22/tcp && ufw allow 80/tcp && ufw allow 443/tcp
+ufw enable
+
+# Vérifier les services
+systemctl status apache2
+systemctl status fail2ban
+fail2ban-client status sshd
+```
+
+### Déploiement
+```bash
+# Avec rsync
+rsync -avhP ./dist/ user@IP:/var/www/site/
+
+# Recharger Apache après déploiement
+ssh user@IP 'sudo systemctl reload apache2'
+
+# Obtenir un certificat SSL
+sudo certbot --apache -d example.com
+```
+
 ### Espace disque
 ```bash
 df -h                                    # Vue globale
@ -106,7 +161,7 @@ du -sh /var/lib/docker                   # Données Docker

 | Dossier | Rôle | Exemple typique |
 |---------|------|-----------------|
-| `/etc` | Configurations | `/etc/nginx/nginx.conf` |
+| `/etc` | Configurations | `/etc/apache2/apache2.conf` |
 | `/var/log` | Logs | `/var/log/syslog` |
 | `/var/lib` | Données d'état | `/var/lib/docker/` |
 | `/home` | Dossiers utilisateurs | `/home/debian/` |
--- a/serveur/kirby-ci-cd-deploy.md
+++ b/serveur/kirby-ci-cd-deploy.md
--- a/serveur/kirby-vps-deploy.md
+++ b/serveur/kirby-vps-deploy.md
@ -0,0 +1,700 @@
+# Déployer Kirby CMS sur VPS
+
+Guide pour déployer un ou plusieurs sites Kirby sur un VPS Apache.
+
+---
+
+## 📋 Prérequis
+
+- VPS configuré avec Apache et SSL → [vps-setup.md](vps-setup.md)
+- Nom de domaine pointant vers le VPS (DNS configuré)
+- Projet Kirby en local (ou à créer)
+- Accès SSH au VPS
+
+---
+
+## 🚀 Déploiement rapide (TL;DR)
+
+```bash
+# 1. Configurer Apache sur le VPS
+ssh user@vps 'sudo vim /etc/apache2/sites-available/monsite.com.conf'
+# [Coller la config VirtualHost ci-dessous]
+
+# 2. Activer le site
+ssh user@vps 'sudo a2ensite monsite.com.conf && sudo systemctl reload apache2'
+
+# 3. Cloner le projet sur le VPS
+ssh user@vps
+cd /var/www/monsite.com
+git clone https://github.com/votre-user/monsite.git .
+composer install --no-dev
+
+# 4. Obtenir le SSL
+sudo certbot --apache -d monsite.com -d www.monsite.com
+```
+
+**Temps total :** 15-20 minutes
+
+---
+
+## Étape 1 : Créer la structure sur le VPS
+
+### 1.1 Créer le dossier du site
+
+```bash
+# Se connecter au VPS
+ssh debian@IP-DU-VPS
+
+# Créer le dossier (remplacer monsite.com)
+sudo mkdir -p /var/www/monsite.com
+
+# Donner les bons droits
+sudo chown -R debian:www-data /var/www/monsite.com
+```
+
+**Explications des droits :**
+- `debian` : votre utilisateur peut modifier les fichiers (déploiement)
+- `www-data` : groupe Apache peut lire et écrire (cache, uploads, panel)
+- `-R` : récursif (tous les sous-dossiers)
+
+**Pourquoi ces droits ?**
+- Kirby a besoin d'écrire dans `/content`, `/site/sessions`, `/media`, `/site/cache`
+- Vous devez pouvoir déployer via Git sans sudo
+
+---
+
+## Étape 2 : Configuration Apache
+
+### 2.1 Créer le VirtualHost
+
+```bash
+sudo vim /etc/apache2/sites-available/monsite.com.conf
+```
+
+**Configuration pour Kirby :**
+
+```apache
+<VirtualHost *:80>
+    ServerName monsite.com
+    ServerAlias www.monsite.com
+
+    DocumentRoot /var/www/monsite.com
+
+    <Directory /var/www/monsite.com>
+        # IMPORTANT pour Kirby : permet l'utilisation de .htaccess
+        AllowOverride All
+
+        Options -Indexes +FollowSymLinks
+        Require all granted
+    </Directory>
+
+    # Logs séparés par site (facilite le debug)
+    ErrorLog ${APACHE_LOG_DIR}/monsite.com_error.log
+    CustomLog ${APACHE_LOG_DIR}/monsite.com_access.log combined
+
+    # Redirection automatique vers HTTPS (après installation SSL)
+    # RewriteEngine on
+    # RewriteCond %{SERVER_NAME} =monsite.com [OR]
+    # RewriteCond %{SERVER_NAME} =www.monsite.com
+    # RewriteRule ^ https://%{SERVER_NAME}%{REQUEST_URI} [END,NE,R=permanent]
+</VirtualHost>
+```
+
+**Points importants :**
+- `AllowOverride All` : **OBLIGATOIRE** pour Kirby (URL propres via .htaccess)
+- `-Indexes` : Empêche la liste des fichiers si pas d'index
+- Redirection HTTPS commentée (sera ajoutée automatiquement par Certbot)
+
+### 2.2 Activer le site
+
+```bash
+# Activer le module rewrite (si pas déjà fait)
+sudo a2enmod rewrite
+
+# Activer le site
+sudo a2ensite monsite.com.conf
+
+# Tester la configuration
+sudo apache2ctl configtest
+# Résultat attendu : "Syntax OK"
+
+# Recharger Apache
+sudo systemctl reload apache2
+```
+
+### 2.3 Vérifier (avant déploiement)
+
+```bash
+# Depuis votre machine locale
+curl -I http://monsite.com
+
+# Résultat attendu :
+# HTTP/1.1 403 Forbidden (normal, pas encore de fichiers)
+# ou
+# HTTP/1.1 200 OK (si fichiers index.html par défaut)
+```
+
+---
+
+## Étape 3 : Déployer Kirby avec Git
+
+**Sur le VPS :**
+
+```bash
+cd /var/www/monsite.com
+
+# Cloner le dépôt
+git clone https://github.com/votre-user/monsite.git .
+
+# Ou initialiser et tirer
+git init
+git remote add origin https://github.com/votre-user/monsite.git
+git pull origin main
+
+# Installer les dépendances Composer (si nécessaire)
+composer install --no-dev
+
+# Mettre à jour le site
+git pull origin main
+```
+
+---
+
+## Étape 4 : Configuration Kirby
+
+### 4.1 Permissions des dossiers
+
+Kirby a besoin d'écrire dans certains dossiers :
+
+```bash
+# Sur le VPS
+cd /var/www/monsite.com
+
+# Dossiers qui doivent être inscriptibles par Apache
+sudo chown -R debian:www-data content/ media/ site/sessions/ site/cache/
+sudo chmod -R 775 content/ media/ site/sessions/ site/cache/
+
+# Le reste peut rester en lecture seule pour Apache
+sudo chmod -R 755 kirby/ site/blueprints/ site/templates/
+```
+
+**Pourquoi 775 ?**
+- `7` (propriétaire debian) : lecture, écriture, exécution
+- `7` (groupe www-data) : lecture, écriture, exécution
+- `5` (autres) : lecture, exécution uniquement
+
+### 4.2 Fichier .htaccess
+
+Kirby fournit un `.htaccess` par défaut. Vérifiez qu'il est bien présent :
+
+```bash
+# Sur le VPS
+ls -la /var/www/monsite.com/.htaccess
+```
+
+**Si absent, créez-le :**
+
+```apache
+# Kirby .htaccess
+# Rewrite rules
+<IfModule mod_rewrite.c>
+
+RewriteEngine On
+
+# Redirection www (optionnel)
+# RewriteCond %{HTTP_HOST} ^www\.(.+)$ [NC]
+# RewriteRule ^(.*)$ https://%1/$1 [R=301,L]
+
+# Block files and folders
+RewriteRule ^content/(.*) index.php [L]
+RewriteRule ^site/(.*) index.php [L]
+RewriteRule ^kirby/(.*) index.php [L]
+
+# Rewrite to index.php
+RewriteCond %{REQUEST_FILENAME} !-f
+RewriteCond %{REQUEST_FILENAME} !-d
+RewriteRule ^(.*) index.php [L]
+
+</IfModule>
+
+# Additional security headers
+<IfModule mod_headers.c>
+  Header set X-Content-Type-Options "nosniff"
+  Header set X-Frame-Options "SAMEORIGIN"
+  Header set X-XSS-Protection "1; mode=block"
+</IfModule>
+```
+
+---
+
+## Étape 5 : SSL avec Let's Encrypt
+
+```bash
+# Sur le VPS
+sudo certbot --apache -d monsite.com -d www.monsite.com
+
+# Questions de Certbot :
+# Email : votre-email@example.com
+# Terms of Service : (A)gree
+# Redirect : 2 (rediriger HTTP vers HTTPS)
+```
+
+**Certbot va automatiquement :**
+1. Créer le certificat SSL
+2. Modifier le VirtualHost pour HTTPS
+3. Ajouter la redirection HTTP → HTTPS
+4. Configurer le renouvellement automatique
+
+**Vérifier le SSL :**
+
+```bash
+# Le certificat
+sudo certbot certificates | grep monsite.com
+
+# Tester le renouvellement automatique
+sudo certbot renew --dry-run
+```
+
+**Résultat attendu :**
+- `http://monsite.com` → redirige vers `https://monsite.com` 🔒
+- Panel Kirby accessible : `https://monsite.com/panel`
+
+---
+
+## Étape 6 : Multi-sites (plusieurs Kirby)
+
+Héberger plusieurs sites Kirby sur le même VPS.
+
+### 6.1 Structure recommandée
+
+```
+/var/www/
+├── monsite.com/        # Premier site
+├── autresite.fr/       # Deuxième site
+└── blog.monsite.com/   # Sous-domaine
+```
+
+### 6.2 Ajouter un nouveau site
+
+**Répéter les étapes 1-5 pour chaque site :**
+
+```bash
+# 1. Créer le dossier
+sudo mkdir -p /var/www/autresite.fr
+sudo chown -R debian:www-data /var/www/autresite.fr
+
+# 2. Créer le VirtualHost
+sudo vim /etc/apache2/sites-available/autresite.fr.conf
+# [Coller la config en changeant ServerName et DocumentRoot]
+
+# 3. Activer
+sudo a2ensite autresite.fr.conf
+sudo systemctl reload apache2
+
+# 4. Déployer
+cd /var/www/autresite.fr
+git clone https://github.com/votre-user/autresite.git .
+composer install --no-dev
+
+# 5. SSL
+sudo certbot --apache -d autresite.fr -d www.autresite.fr
+```
+
+### 6.3 Sous-domaines
+
+**Configuration DNS :**
+```
+Type    Nom           Valeur
+A       blog          IP-DU-VPS
+```
+
+**VirtualHost :**
+```apache
+<VirtualHost *:80>
+    ServerName blog.monsite.com
+    DocumentRoot /var/www/blog.monsite.com
+    # [Reste identique]
+</VirtualHost>
+```
+
+---
+
+## Configuration avancée
+
+### Optimisations Apache pour Kirby
+
+**Activer la compression :**
+
+```bash
+# Activer mod_deflate
+sudo a2enmod deflate
+
+# Créer /etc/apache2/conf-available/compression.conf
+sudo vim /etc/apache2/conf-available/compression.conf
+```
+
+```apache
+<IfModule mod_deflate.c>
+    # Compress HTML, CSS, JavaScript, Text, XML
+    AddOutputFilterByType DEFLATE text/plain
+    AddOutputFilterByType DEFLATE text/html
+    AddOutputFilterByType DEFLATE text/xml
+    AddOutputFilterByType DEFLATE text/css
+    AddOutputFilterByType DEFLATE application/xml
+    AddOutputFilterByType DEFLATE application/xhtml+xml
+    AddOutputFilterByType DEFLATE application/rss+xml
+    AddOutputFilterByType DEFLATE application/javascript
+    AddOutputFilterByType DEFLATE application/x-javascript
+    AddOutputFilterByType DEFLATE image/svg+xml
+</IfModule>
+```
+
+```bash
+# Activer la configuration
+sudo a2enconf compression
+sudo systemctl reload apache2
+```
+
+**Cache navigateur :**
+
+```bash
+sudo vim /etc/apache2/conf-available/browser-cache.conf
+```
+
+```apache
+<IfModule mod_expires.c>
+    ExpiresActive On
+
+    # Images
+    ExpiresByType image/jpeg "access plus 1 year"
+    ExpiresByType image/png "access plus 1 year"
+    ExpiresByType image/gif "access plus 1 year"
+    ExpiresByType image/webp "access plus 1 year"
+    ExpiresByType image/svg+xml "access plus 1 year"
+
+    # CSS et JavaScript
+    ExpiresByType text/css "access plus 1 month"
+    ExpiresByType application/javascript "access plus 1 month"
+
+    # Fonts
+    ExpiresByType font/woff2 "access plus 1 year"
+</IfModule>
+```
+
+```bash
+sudo a2enmod expires
+sudo a2enconf browser-cache
+sudo systemctl reload apache2
+```
+
+### Sécuriser le Panel Kirby
+
+**Option 1 : Changer l'URL du panel**
+
+```php
+// site/config/config.php
+return [
+    'panel' => [
+        'slug' => 'admin-secret-2024'
+    ]
+];
+```
+
+Accès : `https://monsite.com/admin-secret-2024`
+
+**Option 2 : Restreindre par IP**
+
+```apache
+# Dans le VirtualHost
+<Location /panel>
+    Require ip 203.0.113.0/24  # Votre IP
+    # Ou pour plusieurs IPs :
+    # Require ip 1.2.3.4
+    # Require ip 5.6.7.8
+</Location>
+```
+
+**Option 3 : Authentification HTTP basique (double protection)**
+
+```bash
+# Créer un fichier de mots de passe
+sudo htpasswd -c /etc/apache2/.htpasswd admin
+
+# Dans le VirtualHost
+<Location /panel>
+    AuthType Basic
+    AuthName "Administration"
+    AuthUserFile /etc/apache2/.htpasswd
+    Require valid-user
+</Location>
+```
+
+---
+
+## Maintenance
+
+### Sauvegardes
+
+**Script de sauvegarde automatique :**
+
+```bash
+vim ~/backup-kirby.sh
+```
+
+```bash
+#!/bin/bash
+
+DATE=$(date +%Y-%m-%d)
+BACKUP_DIR="/home/debian/backups"
+SITE_DIR="/var/www/monsite.com"
+SITE_NAME="monsite"
+
+# Créer le dossier de sauvegarde
+mkdir -p "$BACKUP_DIR"
+
+# Sauvegarder les fichiers (surtout /content)
+tar -czf "$BACKUP_DIR/${SITE_NAME}-${DATE}.tar.gz" \
+    -C "$SITE_DIR" \
+    content/ site/config/ media/
+
+# Garder seulement les 7 dernières sauvegardes
+find "$BACKUP_DIR" -name "${SITE_NAME}-*.tar.gz" -mtime +7 -delete
+
+echo "✅ Sauvegarde créée : ${SITE_NAME}-${DATE}.tar.gz"
+```
+
+**Automatiser avec cron :**
+
+```bash
+# Éditer la crontab
+crontab -e
+
+# Ajouter : sauvegarde quotidienne à 3h du matin
+0 3 * * * /home/debian/backup-kirby.sh
+```
+
+### Mises à jour Kirby
+
+**Avec Composer :**
+
+```bash
+cd /var/www/monsite.com
+composer update getkirby/cms
+```
+
+**Manuel (téléchargement) :**
+
+```bash
+# Télécharger la dernière version
+wget https://github.com/getkirby/kirby/archive/refs/tags/4.x.x.zip
+
+# Remplacer le dossier kirby/
+unzip 4.x.x.zip
+rm -rf kirby/
+mv kirby-4.x.x/ kirby/
+```
+
+### Logs
+
+**Voir les logs Apache :**
+
+```bash
+# Logs d'erreur
+sudo tail -f /var/log/apache2/monsite.com_error.log
+
+# Logs d'accès
+sudo tail -f /var/log/apache2/monsite.com_access.log
+
+# Filtrer les erreurs 404
+grep "404" /var/log/apache2/monsite.com_access.log
+
+# Filtrer les erreurs PHP
+grep "PHP" /var/log/apache2/monsite.com_error.log
+```
+
+---
+
+## Troubleshooting
+
+### Erreur 500 (Internal Server Error)
+
+**Causes fréquentes :**
+
+1. **Problème de .htaccess**
+   ```bash
+   # Vérifier la syntaxe
+   sudo apache2ctl configtest
+
+   # Temporairement désactiver .htaccess
+   sudo vim /etc/apache2/sites-available/monsite.com.conf
+   # Changer : AllowOverride None
+   ```
+
+2. **Erreur PHP**
+   ```bash
+   # Voir les logs
+   sudo tail -50 /var/log/apache2/monsite.com_error.log
+   ```
+
+3. **Permissions**
+   ```bash
+   # Vérifier les droits
+   ls -la /var/www/monsite.com/
+
+   # Corriger si nécessaire
+   sudo chown -R debian:www-data /var/www/monsite.com
+   sudo chmod -R 775 content/ media/
+   ```
+
+### Le Panel ne fonctionne pas
+
+**Vérifications :**
+
+```bash
+# 1. mod_rewrite activé ?
+apache2ctl -M | grep rewrite
+# Si absent : sudo a2enmod rewrite
+
+# 2. AllowOverride All ?
+grep "AllowOverride" /etc/apache2/sites-available/monsite.com.conf
+
+# 3. Sessions inscriptibles ?
+ls -la /var/www/monsite.com/site/sessions/
+sudo chmod 775 /var/www/monsite.com/site/sessions/
+```
+
+### Les images ne s'affichent pas
+
+**Vérifier les permissions du dossier media :**
+
+```bash
+sudo chown -R debian:www-data /var/www/monsite.com/media
+sudo chmod -R 775 /var/www/monsite.com/media
+```
+
+### Problème de cache
+
+**Vider le cache Kirby :**
+
+```bash
+rm -rf /var/www/monsite.com/site/cache/*
+```
+
+**Vider le cache Apache (si mod_cache activé) :**
+
+```bash
+sudo systemctl restart apache2
+```
+
+---
+
+## Checklist de déploiement
+
+Avant de mettre en production :
+
+- [ ] DNS configuré et propagé (`nslookup monsite.com`)
+- [ ] VirtualHost Apache créé et activé
+- [ ] Fichiers déployés (`git clone`)
+- [ ] Permissions correctes (`debian:www-data`, 775 sur content/media)
+- [ ] `.htaccess` présent
+- [ ] `mod_rewrite` activé (`sudo a2enmod rewrite`)
+- [ ] SSL installé (`certbot --apache`)
+- [ ] Redirection HTTP → HTTPS active
+- [ ] `debug => false` dans `config.php`
+- [ ] Panel accessible (`https://monsite.com/panel`)
+- [ ] Test création de page (vérifier écriture dans /content)
+- [ ] Test upload d'image (vérifier /media)
+- [ ] Logs propres (pas d'erreurs dans `/var/log/apache2/`)
+- [ ] Sauvegarde configurée (cron)
+
+---
+
+## Exemple de configuration complète
+
+Voici un exemple tiré d'un VPS réel (example.com) :
+
+**VirtualHost HTTP (auto-généré, redirige vers HTTPS) :**
+```apache
+<VirtualHost *:80>
+    ServerName example.com
+    ServerAlias www.example.com
+
+    DocumentRoot /var/www/example.com
+
+    <Directory /var/www/example.com>
+        AllowOverride All
+        Require all granted
+    </Directory>
+
+    ErrorLog ${APACHE_LOG_DIR}/example.com_error.log
+    CustomLog ${APACHE_LOG_DIR}/example.com_access.log combined
+
+    # Redirection automatique vers HTTPS
+    RewriteEngine on
+    RewriteCond %{SERVER_NAME} =example.com [OR]
+    RewriteCond %{SERVER_NAME} =www.example.com
+    RewriteRule ^ https://%{SERVER_NAME}%{REQUEST_URI} [END,NE,R=permanent]
+</VirtualHost>
+```
+
+**VirtualHost HTTPS (généré par Certbot) :**
+```apache
+<VirtualHost *:443>
+    ServerName example.com
+    ServerAlias www.example.com
+
+    DocumentRoot /var/www/example.com
+
+    <Directory /var/www/example.com>
+        AllowOverride All
+        Require all granted
+    </Directory>
+
+    ErrorLog ${APACHE_LOG_DIR}/example.com_error.log
+    CustomLog ${APACHE_LOG_DIR}/example.com_access.log combined
+
+    # SSL géré par Certbot
+    SSLCertificateFile /etc/letsencrypt/live/example.com/fullchain.pem
+    SSLCertificateKeyFile /etc/letsencrypt/live/example.com/privkey.pem
+    Include /etc/letsencrypt/options-ssl-apache.conf
+</VirtualHost>
+```
+
+**Structure des fichiers :**
+```
+/var/www/example.com/
+├── .htaccess          # Règles de réécriture Kirby
+├── index.php          # Point d'entrée
+├── kirby/             # Core Kirby
+├── content/           # Contenu (debian:www-data 775)
+├── media/             # Images générées (debian:www-data 775)
+├── site/              # Configuration et templates
+│   ├── config/
+│   ├── templates/
+│   ├── sessions/      # (debian:www-data 775)
+│   └── cache/         # (debian:www-data 775)
+└── vendor/            # Dépendances Composer
+```
+
+---
+
+## Ressources
+
+**Documentation Kirby :**
+- [Installation](https://getkirby.com/docs/guide/quickstart)
+- [Configuration](https://getkirby.com/docs/reference/system/options)
+- [.htaccess](https://getkirby.com/docs/guide/troubleshooting/debugging#check-your-htaccess)
+
+**Outils :**
+- [Kirby CLI](https://github.com/getkirby/cli) - Commandes en ligne
+- [Kirby Plainkit](https://github.com/getkirby/plainkit) - Template de départ
+
+**Communauté :**
+- [Forum Kirby](https://forum.getkirby.com/)
+- [Discord Kirby](https://chat.getkirby.com/)
+
+---
+
+**Temps total de déploiement :** 20-30 minutes par site (après le premier)
+
+**Prochaines étapes :** Configurez vos templates, créez vos blueprints, et profitez de Kirby ! 🚀
--- a/serveur/linux-essentials/README.md
+++ b/serveur/linux-essentials/README.md
@ -28,6 +28,12 @@ Guides généralistes pour comprendre et administrer un système Linux.

 ### 📖 Apprendre les commandes

+**[vim-guide-essentiel.md](vim-guide-essentiel.md)**
+- **Objectif :** Maîtriser Vim, l'éditeur présent sur tous les serveurs Linux
+- **Contenu :** Modes, navigation, édition, chercher/remplacer, cas d'usage admin
+- **Niveau :** Débutant
+- **Temps :** 15-30 min de lecture + pratique
+
 **[comprendre-commandes-find-du.md](comprendre-commandes-find-du.md)**
 - **Objectif :** Maîtriser les commandes `find`, `du`, pipes et grep
 - **Contenu :** Explications détaillées, exemples progressifs, cas pratiques
@ -39,8 +45,12 @@ Guides généralistes pour comprendre et administrer un système Linux.
 ## 🎯 Par besoin

 ### Je débute sur Linux
-1. Lire : [architecture-filesystem.md](architecture-filesystem.md)
-2. Pratiquer avec : [comprendre-commandes-find-du.md](comprendre-commandes-find-du.md)
+1. Apprendre Vim : [vim-guide-essentiel.md](vim-guide-essentiel.md) (essentiel pour éditer les fichiers)
+2. Comprendre l'organisation : [architecture-filesystem.md](architecture-filesystem.md)
+3. Maîtriser les commandes : [comprendre-commandes-find-du.md](comprendre-commandes-find-du.md)
+
+### Je configure un serveur
+1. **Obligatoire :** [vim-guide-essentiel.md](vim-guide-essentiel.md) (pour éditer les configs)

 ### Mon disque est plein
 1. Diagnostiquer : [diagnostic-espace-disque.md](diagnostic-espace-disque.md)
--- a/serveur/linux-essentials/vim-guide-essentiel.md
+++ b/serveur/linux-essentials/vim-guide-essentiel.md
@ -0,0 +1,605 @@
+# Guide essentiel Vim
+
+Guide de survie Vim pour l'administration serveur. Apprenez le minimum vital en 15 minutes.
+
+---
+
+## Pourquoi Vim ?
+
+**Vim est installé par défaut** sur 99% des serveurs Linux. Quand vous vous connectez à un serveur distant :
+- **nano** n'est pas toujours installé
+- **vim/vi** est TOUJOURS là
+- C'est l'éditeur standard Unix depuis 1976
+
+**Avantages :**
+- Ultra-rapide (pas d'interface graphique)
+- Puissant (édition avec le clavier uniquement)
+- Universel (même syntaxe sur tous les systèmes)
+
+---
+
+## Les 3 modes de Vim
+
+Vim fonctionne avec **3 modes distincts** (c'est ça qui déroute au début) :
+
+### 1. Mode Normal (par défaut)
+- **Navigation** dans le fichier
+- **Commandes** (copier, coller, supprimer)
+- **Touche `Esc`** pour revenir en mode Normal
+
+### 2. Mode Insertion
+- **Éditer** du texte (comme un éditeur classique)
+- **Touche `i`** pour entrer en mode Insertion
+- **Touche `Esc`** pour revenir en mode Normal
+
+### 3. Mode Commande
+- **Sauvegarder**, quitter, chercher/remplacer
+- **Touche `:`** pour entrer en mode Commande
+- Taper la commande puis **Entrée**
+
+---
+
+## Premiers pas : Ouvrir et quitter
+
+### Ouvrir un fichier
+
+```bash
+# Ouvrir un fichier existant
+vim /etc/ssh/sshd_config
+
+# Créer un nouveau fichier
+vim nouveau-fichier.txt
+
+# Ouvrir directement à la ligne 42
+vim +42 fichier.txt
+
+# Ouvrir avec sudo (fichiers système)
+sudo vim /etc/apache2/apache2.conf
+```
+
+### Quitter Vim
+
+**Mode Normal** → Tapez `:` puis :
+
+```vim
+:q          " Quitter (si pas de modifications)
+:q!         " Quitter SANS sauvegarder (force)
+:w          " Sauvegarder (write)
+:wq         " Sauvegarder ET quitter
+:x          " Sauvegarder ET quitter (raccourci)
+ZZ          " Sauvegarder ET quitter (sans :)
+```
+
+**🆘 Vous êtes bloqué ?**
+```
+Esc Esc Esc :q! Entrée
+```
+
+---
+
+## Éditer du texte
+
+### Entrer en mode Insertion
+
+**Depuis le mode Normal :**
+
+```vim
+i           " Insert : insérer AVANT le curseur
+a           " Append : insérer APRÈS le curseur
+o           " Open : créer une nouvelle ligne EN DESSOUS
+O           " Open : créer une nouvelle ligne AU DESSUS
+
+I           " Insérer au DÉBUT de la ligne
+A           " Insérer à la FIN de la ligne
+```
+
+**💡 Astuce :** `i` et `a` sont les plus utilisés (90% du temps)
+
+### Modifier du texte
+
+**En mode Normal :**
+
+```vim
+x           " Supprimer le caractère sous le curseur
+dd          " Supprimer toute la ligne
+dw          " Supprimer un mot (delete word)
+d$          " Supprimer jusqu'à la fin de la ligne
+D           " Supprimer jusqu'à la fin de la ligne (raccourci)
+
+u           " Annuler (undo)
+Ctrl+r      " Refaire (redo)
+
+yy          " Copier la ligne (yank)
+p           " Coller après le curseur (paste)
+P           " Coller avant le curseur
+```
+
+### Remplacer du texte
+
+```vim
+r           " Remplacer UN caractère (puis taper le nouveau)
+cw          " Remplacer un mot (change word)
+cc          " Remplacer toute la ligne (change)
+C           " Remplacer jusqu'à la fin de la ligne
+```
+
+---
+
+## Naviguer dans le fichier
+
+### Déplacements de base
+
+**Mode Normal :**
+
+```vim
+" Flèches directionnelles (fonctionnent aussi)
+h           " Gauche  ←
+j           " Bas     ↓
+k           " Haut    ↑
+l           " Droite  →
+
+" Déplacements par mot
+w           " Mot suivant (word)
+b           " Mot précédent (back)
+e           " Fin du mot (end)
+
+" Déplacements dans la ligne
+0           " Début de la ligne
+$           " Fin de la ligne
+^           " Premier caractère non-blanc de la ligne
+
+" Déplacements dans le fichier
+gg          " Début du fichier
+G           " Fin du fichier
+42G         " Aller à la ligne 42
+:42         " Aller à la ligne 42 (alternative)
+```
+
+### Défilement
+
+```vim
+Ctrl+d      " Défiler d'une demi-page vers le bas (down)
+Ctrl+u      " Défiler d'une demi-page vers le haut (up)
+Ctrl+f      " Défiler d'une page vers le bas (forward)
+Ctrl+b      " Défiler d'une page vers le haut (back)
+```
+
+---
+
+## Chercher et remplacer
+
+### Chercher
+
+**Mode Normal :**
+
+```vim
+/motif      " Chercher "motif" vers le bas
+?motif      " Chercher "motif" vers le haut
+
+n           " Résultat suivant (next)
+N           " Résultat précédent
+
+*           " Chercher le mot sous le curseur (vers le bas)
+#           " Chercher le mot sous le curseur (vers le haut)
+```
+
+**💡 Exemple :** Chercher "PasswordAuthentication" dans sshd_config
+```vim
+/PasswordAuthentication
+" Appuyez sur 'n' pour voir les occurrences suivantes
+```
+
+### Remplacer
+
+**Mode Commande** (taper `:`) :
+
+```vim
+" Format général : :[plage]s/ancien/nouveau/[options]
+
+:s/ancien/nouveau/          " Remplacer sur la ligne courante (1ère occurrence)
+:s/ancien/nouveau/g         " Remplacer sur la ligne courante (toutes)
+
+:%s/ancien/nouveau/         " Remplacer dans tout le fichier (1ère par ligne)
+:%s/ancien/nouveau/g        " Remplacer dans tout le fichier (toutes)
+:%s/ancien/nouveau/gc       " Avec confirmation (c = confirm)
+
+:10,20s/ancien/nouveau/g    " Remplacer des lignes 10 à 20
+```
+
+**💡 Exemples pratiques :**
+
+```vim
+" Remplacer tous les "no" par "yes"
+:%s/no/yes/g
+
+" Commenter toutes les lignes (ajouter # au début)
+:%s/^/#/
+
+" Décommenter (supprimer # au début)
+:%s/^#//
+
+" Remplacer avec confirmation
+:%s/PermitRootLogin yes/PermitRootLogin no/gc
+```
+
+---
+
+## Cas d'usage : Administration serveur
+
+### 1. Éditer sshd_config
+
+```bash
+sudo vim /etc/ssh/sshd_config
+```
+
+**Workflow typique :**
+
+1. Chercher le paramètre :
+   ```vim
+   /PermitRootLogin
+   ```
+
+2. Aller en mode Insertion :
+   ```vim
+   i
+   ```
+
+3. Modifier la valeur :
+   ```
+   PermitRootLogin no
+   ```
+
+4. Sauvegarder et quitter :
+   ```vim
+   Esc :wq
+   ```
+
+### 2. Éditer un VirtualHost Apache
+
+```bash
+sudo vim /etc/apache2/sites-available/monsite.conf
+```
+
+**Ajouter une ligne à la fin :**
+
+```vim
+G               " Aller à la fin du fichier
+o               " Créer une nouvelle ligne
+" Taper votre texte
+Esc :wq         " Sauvegarder et quitter
+```
+
+### 3. Décommenter plusieurs lignes
+
+**Exemple :** Décommenter 5 lignes consécutives
+
+```vim
+" Méthode 1 : Chercher/remplacer
+:10,15s/^#//    " Décommenter lignes 10 à 15
+
+" Méthode 2 : Visual block (avancé)
+Ctrl+v          " Mode visuel block
+jjjj            " Sélectionner 5 lignes vers le bas
+x               " Supprimer les # sélectionnés
+```
+
+### 4. Copier/coller une configuration
+
+**Dupliquer un bloc de configuration :**
+
+```vim
+" Se placer sur la première ligne
+V               " Mode visuel ligne (Visual)
+jjjj            " Sélectionner 5 lignes
+y               " Copier (yank)
+p               " Coller après
+```
+
+---
+
+## Configuration utile de Vim
+
+### Créer un .vimrc minimal
+
+```bash
+vim ~/.vimrc
+```
+
+**Configuration recommandée :**
+
+```vim
+" Activer la numérotation des lignes
+set number
+
+" Activer la coloration syntaxique
+syntax on
+
+" Indentation automatique
+set autoindent
+set smartindent
+
+" Taille des tabulations (4 espaces)
+set tabstop=4
+set shiftwidth=4
+set expandtab
+
+" Afficher la position du curseur
+set ruler
+
+" Recherche intelligente (insensible à la casse)
+set ignorecase
+set smartcase
+
+" Highlighting des résultats de recherche
+set hlsearch
+set incsearch
+
+" Désactiver le swap (fichiers .swp)
+set noswapfile
+
+" Sauvegarder l'historique des annulations
+set undofile
+set undodir=~/.vim/undodir
+```
+
+**Appliquer immédiatement :**
+```bash
+mkdir -p ~/.vim/undodir
+```
+
+---
+
+## Commandes avancées utiles
+
+### Indentation
+
+```vim
+>>          " Indenter la ligne (vers la droite)
+<<          " Désindenter (vers la gauche)
+
+" Indenter un bloc
+V           " Mode visuel
+jjjj        " Sélectionner des lignes
+>           " Indenter
+```
+
+### Nombres et répétitions
+
+**Format :** `[nombre][commande]`
+
+```vim
+3dd         " Supprimer 3 lignes
+5yy         " Copier 5 lignes
+10j         " Descendre de 10 lignes
+3w          " Avancer de 3 mots
+.           " Répéter la dernière commande
+```
+
+### Buffers (fichiers multiples)
+
+```vim
+:e fichier2.txt     " Ouvrir un autre fichier
+:bn                 " Buffer suivant (next)
+:bp                 " Buffer précédent (previous)
+:bd                 " Fermer le buffer courant
+:ls                 " Lister tous les buffers ouverts
+```
+
+### Split (fenêtres)
+
+```vim
+:sp fichier.txt     " Split horizontal
+:vsp fichier.txt    " Split vertical
+
+Ctrl+w w            " Naviguer entre les splits
+Ctrl+w q            " Fermer le split courant
+Ctrl+w =            " Égaliser la taille des splits
+```
+
+---
+
+## Aide et ressources
+
+### Aide intégrée
+
+```vim
+:help           " Aide générale
+:help dd        " Aide sur une commande spécifique
+:help modes     " Aide sur les modes
+```
+
+### Tutoriel interactif
+
+```bash
+# Depuis votre terminal
+vimtutor        # Tutoriel interactif (30 min)
+```
+
+---
+
+## Cheat Sheet : L'essentiel
+
+### Ouvrir/Fermer
+```vim
+vim fichier     " Ouvrir
+:w              " Sauvegarder
+:wq ou :x       " Sauvegarder et quitter
+:q!             " Quitter sans sauvegarder
+```
+
+### Modes
+```vim
+Esc             " Mode Normal
+i               " Mode Insertion (avant curseur)
+a               " Mode Insertion (après curseur)
+:               " Mode Commande
+```
+
+### Édition
+```vim
+dd              " Supprimer la ligne
+yy              " Copier la ligne
+p               " Coller
+u               " Annuler
+Ctrl+r          " Refaire
+```
+
+### Navigation
+```vim
+gg              " Début du fichier
+G               " Fin du fichier
+0               " Début de la ligne
+$               " Fin de la ligne
+:42             " Aller ligne 42
+```
+
+### Recherche
+```vim
+/motif          " Chercher
+n               " Suivant
+:%s/old/new/g   " Remplacer tout
+```
+
+---
+
+## Erreurs courantes et solutions
+
+### "E45: 'readonly' option is set"
+**Cause :** Fichier en lecture seule (souvent fichiers système)
+**Solution :**
+```vim
+:w !sudo tee %      " Sauvegarder avec sudo
+" Ou quitter et réouvrir avec sudo
+:q!
+sudo vim /etc/fichier
+```
+
+### "E37: No write since last change"
+**Cause :** Modifications non sauvegardées
+**Solution :**
+```vim
+:w              " Sauvegarder
+" Ou forcer à quitter
+:q!
+```
+
+### "Found a swap file"
+**Cause :** Vim a crashé ou fichier ouvert ailleurs
+**Solution :**
+```vim
+" Taper 'r' pour récupérer le fichier
+" Ou 'd' pour supprimer le swap file
+" Puis supprimer manuellement :
+rm .fichier.swp
+```
+
+### Bloqué en mode Insertion
+**Solution :**
+```
+Appuyez sur Esc plusieurs fois
+```
+
+### Impossible de quitter
+**Solution :**
+```vim
+Esc Esc Esc
+:q!
+```
+
+---
+
+## Mémo pour débuter
+
+**1. Ouvrir un fichier :**
+```bash
+vim fichier.txt
+```
+
+**2. Entrer en mode Insertion :**
+```
+Appuyez sur 'i'
+```
+
+**3. Modifier le texte :**
+```
+Tapez normalement
+```
+
+**4. Revenir en mode Normal :**
+```
+Appuyez sur Esc
+```
+
+**5. Sauvegarder et quitter :**
+```
+:wq puis Entrée
+```
+
+---
+
+## Progression recommandée
+
+### Semaine 1 : Bases
+- Ouvrir/fermer des fichiers
+- Modes Normal et Insertion
+- Sauvegarder avec `:w` et `:wq`
+- Navigation de base (hjkl, gg, G)
+
+### Semaine 2 : Édition
+- Supprimer avec `dd`, `x`
+- Copier/coller avec `yy`, `p`
+- Annuler/refaire avec `u`, `Ctrl+r`
+- Chercher avec `/`
+
+### Semaine 3 : Efficacité
+- Remplacer avec `:s///`
+- Mouvements rapides (`w`, `b`, `$`, `0`)
+- Répétitions avec nombres (`3dd`, `5yy`)
+- Visual mode avec `V`
+
+### Mois 2+ : Maîtrise
+- Configuration `.vimrc`
+- Buffers et splits
+- Macros
+- Plugins
+
+---
+
+## Pourquoi persévérer ?
+
+**Après 2 semaines :** Vous éditez aussi vite qu'avec nano
+**Après 1 mois :** Vous éditez plus vite qu'avec un éditeur graphique
+**Après 3 mois :** Vous ne pouvez plus vous en passer
+
+**Vim est un investissement :** Difficile au début, incroyablement efficace après.
+
+---
+
+## Ressources complémentaires
+
+- **vimtutor** : Tutoriel interactif inclus avec Vim (30 min)
+- **[Vim Adventures](https://vim-adventures.com/)** : Apprendre Vim en jouant
+- **[OpenVim](https://www.openvim.com/)** : Tutoriel interactif en ligne
+- **`:help` dans Vim** : Documentation complète intégrée
+
+**Cheat sheets :**
+- [Vim Cheat Sheet (PDF)](https://vim.rtorr.com/)
+- [Devhints Vim](https://devhints.io/vim)
+
+---
+
+## TL;DR : Minimum vital
+
+```vim
+vim fichier         # Ouvrir
+i                   # Éditer
+Esc                 # Arrêter d'éditer
+:wq                 # Sauvegarder et quitter
+:q!                 # Quitter sans sauvegarder (si erreur)
+
+/chercher           # Chercher
+dd                  # Supprimer ligne
+u                   # Annuler
+```
+
+**C'est tout ce dont vous avez besoin pour 80% des cas d'administration serveur !**
--- a/serveur/vps-setup-complet.md
+++ b/serveur/vps-setup-complet.md
--- a/serveur/vps-setup-rapide.md
+++ b/serveur/vps-setup-rapide.md
@ -0,0 +1,477 @@
+# Setup VPS rapide
+
+Configuration sécurisée d'un VPS en 30-45 minutes.
+
+**Vous voulez comprendre en détail ?** → [vps-setup-complet.md](vps-setup-complet.md)
+
+---
+
+## 🎯 Vue d'ensemble
+
+```
+1. Connexion SSH         (5 min)
+2. Mises à jour          (5 min)
+3. Utilisateur           (5 min) - Type A uniquement
+4. Clés SSH              (10 min)
+5. Sécuriser SSH         (5 min)
+6. Pare-feu UFW          (5 min)
+7. Fail2ban              (5 min)
+8. Mises à jour auto     (5 min)
+9. Apache                (5 min)
+10. SSL (Let's Encrypt)  (5 min)
+────────────────────────────────
+Total: 30-50 min
+```
+
+---
+
+## Prérequis
+
+- VPS avec IP publique
+- Terminal (macOS/Linux)
+- [Vim basics](linux-essentials/vim-guide-essentiel.md) : `i` pour éditer, `Esc :wq` pour sauvegarder
+
+**Types d'accès :**
+- **Type A** (OVH, Hetzner) : accès `root` direct
+- **Type B** (Infomaniak) : utilisateur `debian`/`ubuntu` avec sudo → **Sautez étape 3**
+
+---
+
+## 1. Première connexion (5 min)
+
+```bash
+# Type A
+ssh root@IP-DU-VPS
+
+# Type B
+ssh debian@IP-DU-VPS  # ou ubuntu, admin selon l'hébergeur
+```
+
+**Type A seulement - Changer le mot de passe root :**
+```bash
+passwd  # Mot de passe fort (20+ caractères)
+```
+
+---
+
+## 2. Mises à jour (5 min)
+
+```bash
+# Type A
+apt update && apt upgrade -y && apt autoremove -y
+
+# Type B
+sudo apt update && sudo apt upgrade -y && sudo apt autoremove -y
+```
+
+---
+
+## 3. Créer un utilisateur (5 min)
+
+**⚠️ Type B : SAUTEZ cette étape**
+
+**Type A uniquement :**
+
+```bash
+# Créer l'utilisateur (remplacez "monuser")
+adduser monuser
+
+# Ajouter au groupe sudo
+usermod -aG sudo monuser
+
+# Vérifier
+groups monuser  # Doit afficher : monuser sudo
+```
+
+---
+
+## 4. Clés SSH (10 min)
+
+**Sur votre machine locale :**
+
+```bash
+# Vérifier si vous avez déjà une clé
+ls ~/.ssh/id_*.pub
+
+# Si non, créer une clé
+ssh-keygen -t ed25519 -C "votre-email@example.com"
+# Appuyez sur Entrée 3 fois
+
+# Afficher la clé
+cat ~/.ssh/id_ed25519.pub
+# Copiez la ligne complète
+```
+
+**Sur le VPS :**
+
+```bash
+# Type A - passer à votre utilisateur
+su - monuser
+
+# Type B - déjà votre utilisateur
+
+# Créer le dossier .ssh
+mkdir -p ~/.ssh && chmod 700 ~/.ssh
+
+# Ajouter la clé
+vim ~/.ssh/authorized_keys
+# Appuyez sur 'i', collez la clé, Esc puis :wq
+
+# Droits
+chmod 600 ~/.ssh/authorized_keys
+
+# Type A - retour à root
+exit
+```
+
+**Tester (nouveau terminal) :**
+
+```bash
+ssh monuser@IP-DU-VPS  # Doit marcher SANS mot de passe
+```
+
+---
+
+## 5. Sécuriser SSH (5 min)
+
+```bash
+# Éditer la config
+# Type A
+vim /etc/ssh/sshd_config
+
+# Type B
+sudo vim /etc/ssh/sshd_config
+```
+
+**Modifier ces lignes :**
+
+```
+PermitRootLogin no
+PasswordAuthentication no
+```
+
+**Redémarrer SSH :**
+
+```bash
+# Type A
+systemctl restart sshd
+
+# Type B
+sudo systemctl restart sshd
+```
+
+**⚠️ IMPORTANT : Tester dans un NOUVEAU terminal avant de fermer l'ancien !**
+
+```bash
+ssh monuser@IP-DU-VPS  # Doit marcher
+```
+
+---
+
+## 6. Pare-feu UFW (5 min)
+
+```bash
+# Type A
+apt install ufw -y
+ufw default deny incoming
+ufw default allow outgoing
+ufw allow 22/tcp
+ufw allow 80/tcp
+ufw allow 443/tcp
+ufw enable
+ufw status verbose
+
+# Type B (ajoutez sudo partout)
+sudo apt install ufw -y
+sudo ufw default deny incoming
+sudo ufw default allow outgoing
+sudo ufw allow 22/tcp
+sudo ufw allow 80/tcp
+sudo ufw allow 443/tcp
+sudo ufw enable
+sudo ufw status verbose
+```
+
+---
+
+## 7. Fail2ban (5 min)
+
+```bash
+# Installer
+# Type A
+apt install fail2ban -y
+
+# Type B
+sudo apt install fail2ban -y
+
+# Configuration minimale
+# Type A
+cp /etc/fail2ban/jail.conf /etc/fail2ban/jail.local
+vim /etc/fail2ban/jail.local
+
+# Type B
+sudo cp /etc/fail2ban/jail.conf /etc/fail2ban/jail.local
+sudo vim /etc/fail2ban/jail.local
+```
+
+**Dans le fichier, trouver et vérifier :**
+
+```ini
+[DEFAULT]
+bantime  = 600
+findtime  = 600
+maxretry = 5
+
+[sshd]
+enabled = true
+```
+
+**Démarrer :**
+
+```bash
+# Type A
+systemctl start fail2ban
+systemctl enable fail2ban
+fail2ban-client status
+
+# Type B
+sudo systemctl start fail2ban
+sudo systemctl enable fail2ban
+sudo fail2ban-client status
+```
+
+---
+
+## 8. Mises à jour automatiques (5 min)
+
+```bash
+# Installer
+# Type A
+apt install unattended-upgrades -y
+dpkg-reconfigure -plow unattended-upgrades
+
+# Type B
+sudo apt install unattended-upgrades -y
+sudo dpkg-reconfigure -plow unattended-upgrades
+
+# Sélectionnez "Oui"
+```
+
+---
+
+## 9. Apache (5 min)
+
+```bash
+# Installer
+# Type A
+apt install apache2 -y
+systemctl start apache2
+systemctl enable apache2
+
+# Type B
+sudo apt install apache2 -y
+sudo systemctl start apache2
+sudo systemctl enable apache2
+```
+
+**Tester :**
+- Allez sur `http://IP-DU-VPS` dans votre navigateur
+- Vous devriez voir "Apache2 Debian Default Page"
+
+---
+
+## 10. Configurer un site (10 min)
+
+### DNS
+
+Chez votre registrar :
+```
+Type    Nom    Valeur
+A       @      IP-DU-VPS
+A       www    IP-DU-VPS
+```
+
+Attendre 5-30 min, puis vérifier :
+```bash
+nslookup monsite.com  # Doit retourner votre IP
+```
+
+### VirtualHost Apache
+
+```bash
+# Créer le dossier
+# Type A
+mkdir -p /var/www/monsite.com
+chown -R monuser:monuser /var/www/monsite.com
+echo "<h1>Ça marche !</h1>" > /var/www/monsite.com/index.html
+
+# Type B (remplacez debian par votre user)
+sudo mkdir -p /var/www/monsite.com
+sudo chown -R debian:debian /var/www/monsite.com
+echo "<h1>Ça marche !</h1>" > /var/www/monsite.com/index.html
+
+# Créer le VirtualHost
+# Type A
+vim /etc/apache2/sites-available/monsite.com.conf
+
+# Type B
+sudo vim /etc/apache2/sites-available/monsite.com.conf
+```
+
+**Contenu du fichier :**
+
+```apache
+<VirtualHost *:80>
+    ServerName monsite.com
+    ServerAlias www.monsite.com
+    DocumentRoot /var/www/monsite.com
+
+    <Directory /var/www/monsite.com>
+        Options -Indexes +FollowSymLinks
+        AllowOverride All
+        Require all granted
+    </Directory>
+
+    ErrorLog ${APACHE_LOG_DIR}/monsite.com_error.log
+    CustomLog ${APACHE_LOG_DIR}/monsite.com_access.log combined
+</VirtualHost>
+```
+
+**Activer le site :**
+
+```bash
+# Type A
+a2enmod rewrite
+a2ensite monsite.com.conf
+a2dissite 000-default.conf
+apache2ctl configtest  # Doit dire "Syntax OK"
+systemctl reload apache2
+
+# Type B
+sudo a2enmod rewrite
+sudo a2ensite monsite.com.conf
+sudo a2dissite 000-default.conf
+sudo apache2ctl configtest
+sudo systemctl reload apache2
+```
+
+**Tester :**
+- Allez sur `http://monsite.com`
+- Vous devriez voir "Ça marche !"
+
+---
+
+## 11. SSL (Let's Encrypt) (5 min)
+
+```bash
+# Installer Certbot
+# Type A
+apt install certbot python3-certbot-apache -y
+certbot --apache -d monsite.com -d www.monsite.com
+
+# Type B
+sudo apt install certbot python3-certbot-apache -y
+sudo certbot --apache -d monsite.com -d www.monsite.com
+
+# Répondre aux questions :
+# Email : votre-email@example.com
+# Terms : (A)gree
+# Redirect : 2 (forcer HTTPS)
+```
+
+**Tester :**
+- Allez sur `http://monsite.com` → redirige vers `https://monsite.com` 🔒
+
+---
+
+## ✅ Checklist finale
+
+- [ ] Connexion SSH par clé fonctionne
+- [ ] Mot de passe SSH désactivé
+- [ ] Root SSH désactivé
+- [ ] UFW actif (ports 22, 80, 443)
+- [ ] Fail2ban actif
+- [ ] Apache fonctionne
+- [ ] Site accessible en HTTP
+- [ ] SSL installé et HTTPS fonctionne
+- [ ] Redirection HTTP → HTTPS active
+
+---
+
+## 🚀 Prochaines étapes
+
+### Déployer votre site
+
+- **Kirby CMS** → [kirby-vps-deploy.md](kirby-vps-deploy.md)
+- **Autre site statique** → Utilisez rsync :
+  ```bash
+  rsync -avhP ./mon-site/ user@IP:/var/www/monsite.com/
+  ```
+
+### Maintenance de base
+
+```bash
+# Voir les logs Apache
+sudo tail -f /var/log/apache2/monsite.com_error.log
+
+# Voir les IPs bannies par Fail2ban
+sudo fail2ban-client status sshd
+
+# Espace disque
+df -h
+
+# Mettre à jour
+sudo apt update && sudo apt upgrade -y
+```
+
+---
+
+## 📚 Pour aller plus loin
+
+- **Guide complet** → [vps-setup-complet.md](vps-setup-complet.md)
+- **Vim** → [vim-guide-essentiel.md](linux-essentials/vim-guide-essentiel.md)
+- **Diagnostic** → [diagnostic-espace-disque.md](linux-essentials/diagnostic-espace-disque.md)
+
+---
+
+## Commandes de référence rapide
+
+```bash
+# SSH
+ssh user@host
+ssh -i ~/.ssh/cle user@host
+
+# UFW
+sudo ufw status
+sudo ufw allow 8080/tcp
+sudo ufw delete 3
+
+# Fail2ban
+sudo fail2ban-client status
+sudo fail2ban-client status sshd
+sudo fail2ban-client set sshd unbanip IP
+
+# Apache
+sudo systemctl status apache2
+sudo systemctl reload apache2
+sudo apache2ctl configtest
+sudo a2ensite site.conf
+sudo a2dissite site.conf
+
+# Certbot
+sudo certbot certificates
+sudo certbot renew --dry-run
+
+# Logs
+sudo tail -f /var/log/apache2/error.log
+sudo journalctl -u apache2 -n 50
+
+# Système
+df -h
+du -sh /var/www/*
+systemctl list-units --type=service --state=running
+```
+
+---
+
+**Temps total :** 30-50 minutes pour un VPS sécurisé et fonctionnel ! 🎉
--- a/serveur/vps-setup.md
+++ b/serveur/vps-setup.md
@ -0,0 +1,68 @@
+# Setup VPS
+
+Deux guides selon vos besoins :
+
+---
+
+## 🚀 [Guide Rapide](vps-setup-rapide.md) (30-50 min)
+
+**Pour ceux qui veulent :**
+- Démarrer rapidement
+- Configuration fonctionnelle sans détails
+- Checklist actionnable
+
+**Contenu :**
+- Connexion SSH et sécurité
+- Pare-feu (UFW) et Fail2ban
+- Apache + SSL (Let's Encrypt)
+- Mises à jour automatiques
+
+👉 **[Commencer le setup rapide](vps-setup-rapide.md)**
+
+---
+
+## 📚 [Guide Complet](vps-setup-complet.md) (1-2h)
+
+**Pour ceux qui veulent :**
+- Comprendre chaque étape en profondeur
+- Explications du "pourquoi"
+- Troubleshooting détaillé
+- Guide de référence
+
+**Contenu :**
+- Tout le guide rapide +
+- Explications détaillées
+- Cas d'usage multiples (Type A / Type B)
+- Sections troubleshooting
+- Optimisations avancées
+
+👉 **[Voir le guide complet](vps-setup-complet.md)**
+
+---
+
+## 📦 Après le setup : Déployer votre site
+
+### Kirby CMS
+👉 **[Guide Kirby](kirby-vps-deploy.md)** - Déployer un ou plusieurs sites Kirby
+
+### Autre projet
+- Site statique : utilisez rsync
+- Application Node.js : configurez un reverse proxy
+- Forgejo : voir [forgejo/](forgejo/)
+
+---
+
+## 🆘 Problèmes ?
+
+- **SSH ne fonctionne plus** → [Guide complet - Troubleshooting SSH](vps-setup-complet.md#impossible-de-se-connecter-en-ssh)
+- **Apache ne démarre pas** → [Guide complet - Troubleshooting Apache](vps-setup-complet.md#apache-ne-démarre-pas)
+- **Disque plein** → [Diagnostic espace disque](linux-essentials/diagnostic-espace-disque.md)
+- **Bots qui attaquent** → [Analyse logs et Fail2ban](linux-essentials/analyse-logs-detection-bots.md)
+
+---
+
+## 📖 Guides complémentaires
+
+- **[Vim (éditeur)](linux-essentials/vim-guide-essentiel.md)** - Essentiel pour éditer les configs
+- **[Architecture Linux](linux-essentials/architecture-filesystem.md)** - Comprendre /etc, /var, /lib
+- **[Commandes find/du](linux-essentials/comprendre-commandes-find-du.md)** - Recherche et diagnostic