Guardian Eye sur Linux : Guide d'installation complet

Introduction

Guardian Eye fonctionne nativement sur Linux, offrant les mêmes fonctionnalités puissantes de surveillance vidéo que sur Windows - mais avec avantages stabilité, sécurité et performance de Linux.

Ce guide couvre tout nécessaire pour installer Guardian Eye sur distributions Linux populaires, configurer caméras et faire fonctionner votre système surveillance.

Pourquoi choisir Linux pour surveillance ?

• Stabilité rock-solid - Serveurs Linux peuvent fonctionner mois/années sans redémarrage
• Meilleure performance - Utilisation ressources moindre signifie plus caméras sur même matériel
• Gratuit et open-source - Pas coûts licence système d'exploitation
• Accès distant intégré - SSH pour gestion serveur headless facile
• Automatisation avancée - Services systemd, tâches cron, scripts personnalisés
• Parfait pour NAS/serveurs - Fonctionne sur infrastructure serveur domestique existante

Configuration requise

Configuration minimale

Distributions supportées

• Ubuntu - 20.04 LTS, 22.04 LTS, 24.04 LTS (recommandé débutants)
• Debian - 11 (Bullseye), 12 (Bookworm)
• Fedora - 38, 39, 40
• Arch Linux - Rolling release (utilisateurs avancés)
• Autres - Toute distribution avec support runtime .NET 8.0

Méthodes d'installation

Méthode 1 : Paquet DEB (Ubuntu/Debian)

Méthode la plus simple pour distributions basées Debian avec résolution dépendances automatique.

1. Télécharger paquet .deb :
   wget https://getguardianeye.com/downloads/linux/GuardianEye-1.0.0-linux-x64.deb
2. Installer avec apt :
   sudo apt install ./GuardianEye-1.0.0-linux-x64.deb

   Installe automatiquement runtime .NET et autres dépendances.

3. Vérifier installation :
   guardianeye --version
4. Démarrer service :
   sudo systemctl start guardianeye
   sudo systemctl enable guardianeye # Démarrage auto au boot

Méthode 2 : Tarball (Toutes distributions)

Installation manuelle pour Fedora, Arch ou autres distributions non-Debian.

1. Installer .NET 8.0 Runtime :
   # Ubuntu/Debian
   sudo apt install dotnet-runtime-8.0
   
   # Fedora
   sudo dnf install dotnet-runtime-8.0
   
   # Arch
   sudo pacman -S dotnet-runtime-8.0
2. Télécharger et extraire tarball :
   wget https://getguardianeye.com/downloads/linux/GuardianEye-1.0.0-linux-x64.tar.gz
   sudo mkdir -p /opt/guardianeye
   sudo tar -xzf GuardianEye-1.0.0-linux-x64.tar.gz -C /opt/guardianeye
3. Définir permissions :
   sudo chmod +x /opt/guardianeye/GuardianEye
   sudo chown -R $USER:$USER /opt/guardianeye

Configurer service systemd (Démarrage auto)

Faire démarrer Guardian Eye automatiquement au boot avec systemd.

1. Créer fichier service :
   sudo nano /etc/systemd/system/guardianeye.service
2. Ajouter configuration service :
   [Unit]
   Description=Guardian Eye Surveillance System
   After=network.target
   
   [Service]
   Type=notify
   User=guardianeye
   WorkingDirectory=/opt/guardianeye
   ExecStart=/opt/guardianeye/GuardianEye
   Restart=on-failure
   RestartSec=10
   
   [Install]
   WantedBy=multi-user.target
3. Créer utilisateur dédié (bonne pratique sécurité) :
   sudo useradd -r -s /bin/false guardianeye
   sudo chown -R guardianeye:guardianeye /opt/guardianeye
4. Activer et démarrer service :
   sudo systemctl daemon-reload
   sudo systemctl enable guardianeye
   sudo systemctl start guardianeye

Accès à Guardian Eye

Accès GUI (Environnements bureau)

Si vous utilisez distribution Linux bureau (Ubuntu Desktop, Linux Mint, etc.) :

1. Lancer depuis menu applications : Applications → Multimédia → Guardian Eye
2. Ou depuis terminal : guardianeye

Accès interface web (Serveurs headless)

Pour serveurs sans GUI, Guardian Eye fournit interface web :

1. Guardian Eye lance serveur web sur http://localhost:5000 par défaut
2. Accès depuis autre ordinateur : http://server-ip:5000
3. Configurer pare-feu pour autoriser port 5000 :
   sudo ufw allow 5000/tcp # UFW (Ubuntu)
   sudo firewall-cmd --add-port=5000/tcp --permanent # firewalld (Fedora)

Configurer caméras sur Linux

Détection webcam USB

Guardian Eye utilise V4L2 (Video4Linux2) pour webcams USB.

1. Lister webcams disponibles :
   v4l2-ctl --list-devices
2. Vérifier permissions périphérique :
   sudo usermod -aG video $USER
   # Déconnexion et reconnexion nécessaires
3. Dans Guardian Eye : Paramètres → Caméras → Ajouter caméra → Webcam USB → Sélectionner /dev/video0

Configuration caméra IP (RTSP)

Comme sur Windows - Guardian Eye utilise protocole RTSP standard.

Configuration stockage

Disque enregistrements dédié

1. Monter disque en permanence :
   sudo mkdir -p /mnt/surveillance
   sudo blkid # Trouver UUID de votre disque
   sudo nano /etc/fstab
   
   # Ajouter ligne (remplacer UUID par le vôtre) :
   UUID=YOUR-UUID-HERE /mnt/surveillance ext4 defaults 0 2
   
   sudo mount -a
2. Définir permissions :
   sudo chown -R guardianeye:guardianeye /mnt/surveillance
3. Configurer dans Guardian Eye : Paramètres → Enregistrement → Chemin sortie → /mnt/surveillance/recordings

Problèmes courants & dépannage

❌ Problème : "GuardianEye: commande introuvable"

Solutions :

• Créer symlink : sudo ln -s /opt/guardianeye/GuardianEye /usr/local/bin/guardianeye
• Exécuter directement : /opt/guardianeye/GuardianEye

❌ Problème : Webcam USB non détectée

Solutions :

• Vérifier si périphérique reconnu : lsusb et v4l2-ctl --list-devices
• Installer v4l-utils : sudo apt install v4l-utils
• Ajouter utilisateur au groupe video : sudo usermod -aG video $USER

❌ Problème : Utilisation CPU/mémoire élevée

Solutions :

• Réduire résolution/FPS caméra dans paramètres
• Utiliser accélération matérielle H.264 si disponible
• Surveiller ressources : htop ou systemctl status guardianeye

Optimisation performance

1. Utiliser SSD pour OS et base données

Installer Guardian Eye sur SSD pour démarrage rapide. Utiliser HDD seulement pour enregistrements.

2. Ajuster swappiness (Serveurs RAM limitée)

3. Désactiver GUI sur serveurs

Bonnes pratiques sécurité

• Exécuter en tant qu'utilisateur non-root - Toujours utiliser utilisateur dédié guardianeye
• Configuration pare-feu - Autoriser port 5000 uniquement depuis IPs fiables
• Utiliser reverse proxy avec HTTPS - Configurer nginx avec SSL Let's Encrypt
• Isoler caméras dans VLAN - Empêcher accès caméras à Internet/réseau principal
• Mises à jour régulières - Maintenir Guardian Eye et paquets système à jour

Conclusion

Guardian Eye sur Linux offre solution surveillance puissante, flexible et économique. Que ce soit serveur domestique, NAS ou système sécurité dédié, stabilité et performance Linux en font excellent choix pour enregistrement 24/7.

Récapitulatif :

1. Installation via paquet .deb (Ubuntu/Debian) ou tarball (autres)
2. Configurer service systemd pour démarrage auto
3. Configurer webcams USB via V4L2 ou caméras IP RTSP
4. Utiliser disque dédié pour enregistrements avec bonnes permissions
5. Accès via GUI (bureau) ou interface web (serveurs headless)
6. Optimisation : accélération matérielle, FPS bas, swappiness
7. Sécurisation : utilisateur non-root, pare-feu, reverse proxy HTTPS