Fixed gluetun version

The pinned nuxt ^3.14.159 never resolved a fuse.js version satisfying
@vueuse/integrations' optional peer dependency (fuse.js ^7), used by
Docus's search component. A clean install would crash rendering any
page. Matching main's nuxt version pulls in @nuxt/cli's own fuse.js
^7.4.2, which npm hoists and that satisfies the peer.

Co-Authored-By: Claude Sonnet 5 <[email protected]>

app.config.ts

@@ -25,7 +25,7 @@ export default defineAppConfig({
   docus: {
     title: 'Docudjeex',
     description: 'La doc de mes expériences',
-    url: 'http://docus.dev',
+    url: 'https://docu.djeex.fr/fr',
     image: '/img/social.png',
     socials: {
       github:'',

content/0.index.md

@@ -1,5 +1,6 @@
 ---
 title: Accueil
+description: Documentation homelab par Djeex — guides d'auto-hébergement pour Debian, Docker, réseau, stockage et bien plus.
 navigation: false
 layout: page
 main:

content/1.apropos/1.bienvenue.md

@@ -1,6 +1,7 @@
 ---
 icon: lucide:home
 title: Bienvenue
+description: Introduction à Docudjeex — un site de documentation personnelle sur les services auto-hébergés, Debian et l'infrastructure Docker.
 main:
   fluid: false
 ---

content/2.generalites/1.reseau/1.nat.md

@@ -1,6 +1,7 @@
 ---
 navigation: true
 title: NAT & DHCP
+description: Comprendre le NAT, la redirection de ports et le DHCP sur un routeur domestique. Configurer des baux IP fixes et exposer des services locaux.
 main:
   fluid: false
 ---

content/2.generalites/1.reseau/2.dns.md

@@ -1,6 +1,7 @@
 ---
 navigation: true
 title: Zone DNS
+description: Comprendre le fonctionnement du DNS, lire et éditer une zone DNS, et configurer des noms de domaine pour vos services auto-hébergés.
 main:
   fluid: false
 ---

content/2.generalites/1.reseau/3.samba.md

@@ -1,6 +1,7 @@
 ---
 navigation: true
 title: Samba
+description: Configurer Samba sur Debian pour partager des dossiers sur votre réseau local et y accéder depuis Windows, macOS ou Linux.
 main:
   fluid: false
 ---

content/2.generalites/2.stockage/1.raid.md

@@ -1,6 +1,7 @@
 ---
 navigation: true
 title: RAID
+description: Comprendre le RAID — matériel vs logiciel, niveaux RAID, et comment mettre en place des grappes de disques redondants pour votre homelab.
 main:
   fluid: false
 ---

content/2.generalites/2.stockage/2.zfs.md

@@ -1,6 +1,7 @@
 ---
 navigation: true
 title: ZFS
+description: Introduction à ZFS — système de fichiers et gestionnaire de volumes combinés avec snapshots, checksums et redondance intégrée pour un stockage fiable.
 main:
   fluid: false
 ---

content/2.generalites/3.hardware/1.bases.md

@@ -1,6 +1,7 @@
 ---
 navigation: true
 title: Les bases
+description: Les fondamentaux du matériel serveur — CPU, RAM, stockage et facteurs de forme pour bien démarrer votre homelab.
 main:
   fluid: false
 ---

content/2.generalites/3.hardware/2.reseau.md

@@ -1,6 +1,7 @@
 ---
 navigation: true
 title: Réseau
+description: Aperçu du matériel réseau pour homelab — switches, cartes réseau, câbles et comment connecter efficacement vos serveurs.
 main:
   fluid: false
 ---

content/2.generalites/3.hardware/3.prolonas.md

@@ -1,6 +1,7 @@
 ---
 navigation: true
 title: Le ProloNAS
+description: Construire un serveur domestique performant avec un mini PC Intel N100 — guide pratique pour démarrer l'auto-hébergement pour moins de 130 €.
 fluid: false
 ---
 :ellipsis{left=0px width=40rem top=10rem blur=140px}

content/3.serveex/1.introduction.md

@@ -2,6 +2,7 @@
 icon: lucide:bookmark
 navigation: true
 title: Introduction
+description: Introduction à Serveex — un projet homelab pour auto-héberger ses services du quotidien avec Debian et Docker, sans dépendre de Google, Apple ou Netflix.
 main:
   fluid: false
 ---

content/3.serveex/2.coeur/1.installation.md

@@ -1,6 +1,7 @@
 ---
 navigation: true
 title: Debian 13
+description: Guide pas à pas pour installer Debian 13 sur un serveur et configurer l'accès SSH, les paquets essentiels et un système de base prêt à l'emploi.
 main:
   fluid: false
 ---

content/3.serveex/2.coeur/2.docker.md

@@ -1,6 +1,7 @@
 ---
 navigation: true
 title: Docker
+description: Installer Docker et Dockge sur Debian pour déployer et gérer des services auto-hébergés avec de simples stacks de conteneurs.
 main:
   fluid: false
 ---

content/3.serveex/2.coeur/3.swag.md

@@ -1,6 +1,7 @@
 ---
 navigation: true
 title: SWAG
+description: Configurer SWAG comme reverse proxy avec SSL automatique, exposer vos services en toute sécurité et activer le blocage géographique sur votre homelab.
 main:
   fluid: false
 ---

content/3.serveex/3.securite/1.wireguard.md

@@ -1,6 +1,7 @@
 ---
 navigation: true
 title: Wireguard
+description: Installer et configurer WireGuard VPN pour accéder à votre homelab de n'importe où et connecter tous vos appareils à votre réseau privé.
 main:
   fluid: false
 ---

content/3.serveex/3.securite/2.authentik.md

@@ -1,6 +1,7 @@
 ---
 navigation: true
 title: Authentik
+description: Installer Authentik comme fournisseur d'identité auto-hébergé — configurer le MFA et protéger vos services avec du SSO et l'authentification via reverse proxy.
 main:
   fluid: false
 ---

content/3.serveex/3.securite/3.cloudflare.md

@@ -1,6 +1,7 @@
 ---
 navigation: true
 title: Cloudflare Zero Trust
+description: Utiliser les tunnels Cloudflare et Zero Trust pour exposer des services sans ouvrir de ports — configurer SWAG et gérer plusieurs tunnels.
 main:
   fluid: false
 ---

content/3.serveex/4.monitoring/1.uptime-kuma.md

@@ -1,6 +1,7 @@
 ---
 navigation: true
 title: Uptime-Kuma
+description: Installer Uptime-Kuma pour surveiller la disponibilité de vos services auto-hébergés, configurer des alertes et protéger le tableau de bord avec Authentik.
 main:
   fluid: false
 ---

content/3.serveex/4.monitoring/2.dozzle.md

@@ -1,6 +1,7 @@
 ---
 navigation: true
 title: Dozzle
+description: Installer Dozzle pour surveiller les logs des conteneurs Docker en temps réel depuis une interface web épurée, exposée via SWAG.
 main:
   fluid: false
 ---

content/3.serveex/4.monitoring/3.speedtest-tracker.md

@@ -1,6 +1,7 @@
 ---
 navigation: true
 title: Speedtest Tracker
+description: Installer Speedtest Tracker pour mesurer et enregistrer automatiquement la vitesse de votre connexion internet dans le temps, exposé avec SWAG.
 main:
   fluid: false
 ---

content/3.serveex/4.monitoring/4.beszel.md

@@ -1,6 +1,7 @@
 ---
 navigation: true
 title: Beszel
+description: Installer Beszel pour surveiller CPU, RAM, disques et réseau de vos serveurs — y compris à distance — via un tableau de bord web léger.
 main:
   fluid: false
 ---

content/3.serveex/4.monitoring/5.upsnap.md

@@ -1,6 +1,7 @@
 ---
 navigation: true
 title: UpSnap
+description: Installer UpSnap pour allumer à distance des machines de votre réseau local via Wake-on-LAN, exposé avec SWAG.
 main:
   fluid: false
 ---

content/3.serveex/5.media/1.plex.md

@@ -1,6 +1,7 @@
 ---
 navigation: true
 title: Plex
+description: Installer Plex Media Server avec Tautulli sur votre homelab pour streamer films et séries depuis n'importe où sur tous vos appareils.
 main:
   fluid: false
 ---

content/3.serveex/5.media/2.qbittorrent.md

@@ -1,6 +1,7 @@
 ---
 navigation: true
 title: Qbittorrent
+description: Installer qBittorrent avec Gluetun et ProtonVPN pour télécharger des torrents de manière sécurisée derrière un VPN sur votre serveur auto-hébergé.
 main:
   fluid: false
 ---
@@ -80,7 +81,7 @@ services:
       - gluetun
 
   gluetun:
-    image: qmcgaw/gluetun:v3.40.1
+    image: qmcgaw/gluetun:v3.41.3
     container_name: gluetun
     restart: unless-stopped
     mem_limit: 4g
@@ -150,7 +151,7 @@ Entrez en modification en tapant `i` et éditez le comme suit en ajoutant la cl
 ```toml
 [[roles]]
 name = "t-anc/GSP-Qbittorent-Gluetun-sync-port-mod"
-routes = ["GET /v1/openvpn/portforwarded"]
+routes = ["GET /v1/portforward"]
 auth = "apikey"
 apikey = "votre_clée" # clée que vous avez générée précédemment
 ```

content/3.serveex/5.media/3.servarr.md

@@ -1,6 +1,7 @@
 ---
 navigation: true
 title: Automatisation
+description: Automatiser les téléchargements de médias avec la suite Servarr — Radarr, Sonarr, Bazarr, Prowlarr et Overseerr pour films et séries.
 main:
   fluid: false
 ---

content/3.serveex/6.cloud/1.immich.md

@@ -1,6 +1,7 @@
 ---
 navigation: true
 title: Immich
+description: Installer Immich, une alternative auto-hébergée à Google Photos et iCloud avec reconnaissance faciale, géolocalisation et synchronisation multi-appareils.
 main:
   fluid: false
 ---

content/3.serveex/6.cloud/2.nextcloud.md

@@ -1,6 +1,7 @@
 ---
 navigation: true
 title: Nextcloud
+description: Installer Nextcloud pour auto-héberger vos fichiers, photos et agenda — une alternative respectueuse de la vie privée à Google Drive, OneDrive et iCloud.
 main:
   fluid: false
 ---

content/3.serveex/7.files/1.file-browser.md

@@ -1,6 +1,7 @@
 ---
 navigation: true
 title: File Browser
+description: Installer File Browser pour parcourir et gérer les fichiers de votre serveur depuis une interface web, exposée de manière sécurisée avec SWAG.
 main:
   fluid: false
 ---

content/3.serveex/7.files/2.pingvin.md

@@ -1,6 +1,7 @@
 ---
 navigation: true
 title: Pingvin
+description: Installer Pingvin Share, une plateforme d'envoi de fichiers auto-hébergée pour partager des fichiers de façon sécurisée sans WeTransfer ni Google Drive.
 main:
   fluid: false
 ---

content/3.serveex/8.development/1.code-server.md

@@ -1,6 +1,7 @@
 ---
 navigation: true
 title: Code-Serveur
+description: Installer code-server pour utiliser VS Code dans votre navigateur depuis votre homelab — montez des dossiers et exposez-le de manière sécurisée avec SWAG.
 main:
   fluid: false
 ---

content/3.serveex/8.development/2.gitea.md

@@ -1,6 +1,7 @@
 ---
 navigation: true
 title: Gitea
+description: Installer Gitea, un service Git auto-hébergé léger pour gérer vos dépôts de code de façon privée sur votre propre serveur.
 main:
   fluid: false
 ---

content/3.serveex/8.development/3.it-tools.md

@@ -1,6 +1,7 @@
 ---
 navigation: true
 title: IT-Tools
+description: Installer IT Tools, une collection auto-hébergée d'utilitaires pratiques pour développeurs — convertisseurs, encodeurs, formateurs et plus encore.
 main:
   fluid: false
 ---

content/3.serveex/9.apps/1.adguard.md

@@ -1,6 +1,7 @@
 ---
 navigation: true
 title: Adguard Home
+description: Installer AdGuard Home pour bloquer publicités et trackers à l'échelle du réseau avec DNS-over-HTTPS, gestion des clients et règles de filtrage personnalisées.
 main:
   fluid: false
 ---

content/3.serveex/9.apps/2.vaultwarden.md

@@ -1,6 +1,7 @@
 ---
 navigation: true
 title: Vaultwarden
+description: Installer Vaultwarden, un gestionnaire de mots de passe auto-hébergé compatible Bitwarden pour remplacer les gestionnaires Google ou Apple sur tous vos appareils.
 main:
   fluid: false
 ---

content/4.stockeex/1.introduction.md

@@ -2,6 +2,7 @@
 icon: lucide:bookmark
 navigation: true
 title: Introduction
+description: Introduction à Stockeex — un projet personnel de gestion de stock et d'inventaire. Documentation en cours de rédaction.
 main:
   fluid: false
 ---

content/5.betises/1.python/1.nvidia-stock-bot.md

@@ -1,6 +1,7 @@
 ---
 navigation: true
 title: Nvidia Stock Bot
+description: Un bot Python qui surveille la disponibilité des GPU en temps réel et envoie des alertes Discord — créé lors de la pénurie de la série RTX 5000.
 main:
   fluid: false
 ---

content/5.betises/1.python/2.adguard-cidre.md

@@ -1,6 +1,7 @@
 ---
 navigation: true
 title: Adguard CIDRE
+description: Un script Python pour synchroniser automatiquement les listes CIDR d'AdGuard Home et sécuriser votre serveur DNS auto-hébergé exposé sur internet.
 main:
   fluid: false
 ---

content/5.betises/1.python/3.lumeex.md

@@ -1,6 +1,7 @@
 ---
 navigation: true
 title: Lumeex
+description: Lumeex est un générateur de galerie photo statique en Python — minimaliste, léger et entièrement personnalisable sans CMS.
 main:
   fluid: false
 ---

content/5.betises/1.python/4.instameex.md

@@ -1,6 +1,7 @@
 ---
 navigation: true
 title: Instameex
+description: Instameex est un outil Docker pour fusionner des exports SDR et HDR en un JPEG avec gain map prêt pour l'upload HDR sur Instagram.
 main:
   fluid: false
 ---

content/5.betises/2.bash/1.servarr-doublons.md

@@ -1,6 +1,7 @@
 ---
 navigation: true
 title: Doublons servarr
+description: Un script bash pour détecter et corriger les fichiers médias en double dans les bibliothèques Sonarr et Radarr en remplaçant les copies par des hardlinks.
 main:
   fluid: false
 ---

content/5.betises/2.bash/2.luks-backup.md

@@ -1,6 +1,7 @@
 ---
 navigation: true
 title: Luks backup
+description: Un script bash pour extraire automatiquement les headers LUKS de tous les disques chiffrés, les identifier par numéro de série et les archiver de façon chiffrée.
 main:
   fluid: false
 ---

content/5.betises/2.bash/3.socat-proxy.md

@@ -1,6 +1,7 @@
 ---
 navigation: true
 title: Socat Proxy
+description: Utiliser socat pour proxifier le socket Docker via Docker Socket Proxy, permettant à Beszel de collecter les stats des conteneurs sans exposer le socket complet.
 main:
   fluid: false
 ---

content/5.betises/2.bash/4.hotdisk.md

@@ -1,6 +1,7 @@
 ---
 navigation: true
 title: HotDisk
+description: Un script bash qui surveille la température des disques durs et éteint automatiquement le serveur lorsqu'ils dépassent un seuil de sécurité trop longtemps.
 main:
   fluid: false
 ---

content/5.betises/2.bash/5.backrest-docker-stop.md

@@ -1,6 +1,7 @@
 ---
 navigation: true
 title: Backrest Docker Stop
+description: Un script bash qui arrête les conteneurs Docker avant une sauvegarde Backrest et les redémarre après — pour des sauvegardes de bases de données sans dump complexe.
 main:
   fluid: false
 ---

content/6.Poubelle/1.obsolete/1.wireguard-14.md

@@ -1,6 +1,7 @@
 ---
 navigation: true
 title: Wireguard 14
+description: Ancien guide WireGuard 14 conservé à titre archivé — voir le guide WireGuard à jour pour une installation actuelle.
 main:
   fluid: false
 ---

nuxt.config.ts

@@ -39,10 +39,16 @@ export default defineNuxtConfig({
         { rel: 'manifest', href: '/img/favicon/site.webmanifest' }
       ],
       meta: [
-        { name: 'darkreader-lock' },
+        { name: 'darkreader-lock', content: 'true' },
       ]
     }
   },
 
+  nitro: {
+    prerender: {
+      routes: ['/sitemap.xml']
+    }
+  },
+
   compatibilityDate: '2024-10-24'
 })

package.json

@@ -17,6 +17,6 @@
     "@nuxtjs/plausible": "^1.0.3",
     "@types/node": "^22.9.0",
     "eslint": "^9.14.0",
-    "nuxt": "^3.14.159"
+    "nuxt": "^3.21.11"
   }
 }

plugins/canonical.ts

@@ -0,0 +1,14 @@
+export default defineNuxtPlugin(() => {
+  const route = useRoute()
+  const { docus } = useAppConfig()
+  const canonicalUrl = computed(() => `${docus.url}${route.path}`)
+
+  useHead({
+    link: [
+      { rel: 'canonical', href: canonicalUrl }
+    ],
+    meta: [
+      { property: 'og:url', content: canonicalUrl }
+    ]
+  })
+})

server/routes/sitemap.xml.ts

@@ -0,0 +1,23 @@
+import { serverQueryContent } from '#content/server'
+
+// generates /fr/sitemap.xml without @nuxtjs/sitemap (incompatible with baseURL /fr/)
+export default defineEventHandler(async (event) => {
+  const docs = await serverQueryContent(event).find()
+
+  const urls = docs
+    .filter((doc: any) =>
+      doc._path &&
+      !doc._path.startsWith('/_') &&
+      !doc._path.endsWith('/_dir')
+    )
+    .map((doc: any) => `  <url><loc>https://docu.djeex.fr/fr${doc._path}</loc></url>`)
+    .join('\n')
+
+  const sitemap = `<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+${urls}
+</urlset>`
+
+  setHeader(event, 'Content-Type', 'application/xml')
+  return sitemap
+})