lxc-manager/Readme.md

# 🐳 Gestionnaire LXC Proxmox VE

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Bash](https://img.shields.io/badge/Bash-5.0+-green.svg)](https://www.gnu.org/software/bash/)
[![Proxmox](https://img.shields.io/badge/Proxmox-VE%207%2B-orange.svg)](https://www.proxmox.com/)

Script Bash professionnel et sécurisé pour gérer les conteneurs LXC sur Proxmox VE via l'interface en ligne de commande.

![Screenshot](https://git.h3campus.fr/Johnny/lxc-manager/raw/branch/main/screenshots/menu-principal.png)

## ✨ Fonctionnalités

### 🚀 Gestion des conteneurs
- ✅ **Création** de conteneurs avec configuration complète (CPU, RAM, disque, réseau)
- ▶️ **Démarrage** / ⏹️ **Arrêt** (normal ou forcé)
- 🔄 **Redémarrage** de conteneurs
- 🗑️ **Suppression** avec confirmation de sécurité
- 🔓 **Déverrouillage** de conteneurs bloqués
- 📊 **Affichage** des informations détaillées
- 🖥️ **Connexion** directe au shell du conteneur
- 📋 **Clonage** avec gestion des conteneurs actifs

### 💾 Sauvegarde et restauration
- 💿 **Sauvegarde** avec choix de compression (gzip, lzo, zstd)
- 🔄 **Modes de backup** : snapshot, stop, suspend
- 📂 **Sélection** du stockage de destination
- 🔙 **Restauration** avec sélection numérotée des sauvegardes
- 🗄️ **Support** de tous les stockages connectés (NFS, CIFS, local, etc.)

### 🔒 Sécurité et protection
- 🛡️ **Protection par conteneur** (activation/désactivation)
- 🔐 **Mode protection global** (confirmations renforcées)
- ✅ **Validation stricte** de toutes les entrées utilisateur
- 🚨 **Détection automatique** de la protection lors de la suppression
- 📝 **Confirmations** pour toutes les opérations critiques

### 🎨 Interface utilisateur
- 🌈 **Interface colorée** et intuitive
- 📋 **Sélection numérotée** pour tous les choix
- 📊 **Affichage clair** des informations
- ⚡ **Navigation rapide** dans les menus

## 📋 Prérequis

- **Proxmox VE** 7.0 ou supérieur
- **Bash** 5.0 ou supérieur
- Accès **root** au serveur Proxmox
- Commande `pct` disponible (installée par défaut sur Proxmox)

## 📥 Installation

### Installation rapide

```bash
# Télécharger le script
wget https://git.h3campus.fr/Johnny/lxc-manager/raw/branch/main/lxc-manager.sh

# Rendre le script exécutable
chmod +x lxc-manager.sh

# Lancer le script
./lxc-manager.sh
```

### Installation avec Git

```bash
# Cloner le dépôt
git clone https://git.h3campus.fr/Johnny/lxc-manager.git

# Accéder au répertoire
cd lxc-manager

# Rendre le script exécutable
chmod +x lxc-manager.sh

# Lancer le script
./lxc-manager.sh
```

### Installation système (optionnel)

```bash
# Copier dans /usr/local/bin
sudo cp lxc-manager.sh /usr/local/bin/lxc-manager

# Rendre exécutable
sudo chmod +x /usr/local/bin/lxc-manager

# Lancer de n'importe où
lxc-manager
```

## 🎮 Utilisation

### Lancement

```bash
./lxc-manager.sh
```

Le script doit être exécuté en tant que **root** ou avec **sudo**.

### Menu principal

```
╔═══════════════════════════════════════════════╗
║     GESTIONNAIRE LXC PROXMOX VE              ║
║     Version 2.1 - Sécurisé                   ║
╚═══════════════════════════════════════════════╝

🔒 Mode protection: ACTIVÉ

Menu Principal:

1)  Lister les conteneurs
2)  Créer un conteneur
3)  Démarrer un conteneur
4)  Arrêter un conteneur
5)  Redémarrer un conteneur
6)  Supprimer un conteneur
7)  Déverrouiller un conteneur
8)  Sauvegarder un conteneur
9)  Restaurer une sauvegarde
10) Afficher les informations
11) Entrer dans un conteneur
12) Cloner un conteneur
13) Gérer la protection d'un conteneur
14) Mode protection global (ACTIVÉ)
0)  Quitter
```

## 📖 Guide des fonctionnalités

### 🆕 Création d'un conteneur

Le script vous guide à travers toutes les étapes :

1. **VMID** : Numéro unique du conteneur (100-999999999)
2. **Nom d'hôte** : Nom du conteneur (lettres, chiffres, tirets)
3. **Mot de passe root** : Minimum 8 caractères avec confirmation
4. **Stockage** : Sélection numérotée du stockage
5. **Template** : Choix du système d'exploitation
6. **Ressources** : RAM, Swap, Disque, CPU
7. **Réseau** : Configuration DHCP ou IP statique
8. **Options** : Démarrage automatique, protection

### 💾 Sauvegarde d'un conteneur

Choix disponibles :

**Compression :**
- `gzip` : Rapide, compression moyenne (recommandé)
- `lzo` : Très rapide, faible compression
- `zstd` : Bon compromis vitesse/compression

**Mode de sauvegarde :**
- `snapshot` : Plus rapide, nécessite ZFS/LVM (recommandé)
- `stop` : Arrêt complet du conteneur
- `suspend` : Suspension temporaire

### 🔙 Restauration d'une sauvegarde

Le script vous permet de :

1. Sélectionner le **stockage source** contenant les sauvegardes
2. Choisir la **sauvegarde** à partir d'une liste numérotée avec VMID et date
3. Définir le **nouveau VMID** pour le conteneur restauré
4. Sélectionner le **stockage de destination**

### 📋 Clonage d'un conteneur

Pour les conteneurs en cours d'exécution, 3 options :

1. **Arrêter** le conteneur avant le clonage (recommandé)
2. **Créer un snapshot** et cloner (plus rapide, nécessite ZFS/LVM)
3. **Annuler** l'opération

Le conteneur source est automatiquement redémarré après le clonage si nécessaire.

### 🔒 Protection des conteneurs

**Protection par conteneur :**
- Empêche la suppression accidentelle
- Peut être activée/désactivée individuellement
- Détectée automatiquement lors de la suppression

**Mode protection global :**
- 🔒 **ACTIVÉ** : Confirmations renforcées (taper "SUPPRIMER")
- 🔓 **DÉSACTIVÉ** : Confirmations simples (o/n)

## 🔧 Configuration avancée

### Validation des entrées

Le script valide strictement :

- **VMID** : Format numérique (100-999999999)
- **Nom d'hôte** : RFC 952/1123 (lettres, chiffres, tirets)
- **Adresses IP** : Format CIDR (ex: 192.168.1.100/24)
- **Nombres** : Valeurs positives pour RAM, CPU, disque

### Mode strict Bash

Le script utilise `set -euo pipefail` pour :

- `-e` : Arrêter en cas d'erreur
- `-u` : Détecter les variables non définies
- `-o pipefail` : Détecter les erreurs dans les pipes

## 🐛 Dépannage

### Le script ne démarre pas

```bash
# Vérifier que vous êtes root
whoami

# Si non root, utiliser sudo
sudo ./lxc-manager.sh

# Vérifier que le script est exécutable
ls -l lxc-manager.sh
chmod +x lxc-manager.sh
```

### Erreur "pct: command not found"

Le script doit être exécuté sur un serveur Proxmox VE, pas sur une machine distante.

### Erreur lors de la sauvegarde "wrong content type"

Le stockage sélectionné n'est pas configuré pour accepter les backups. Le script filtre maintenant automatiquement les stockages appropriés.

### Erreur sendmail lors des sauvegardes

C'est une erreur de notification email qui n'empêche pas la sauvegarde de fonctionner. Pour la corriger, configurez `msmtp` sur votre serveur Proxmox.

### Impossible de cloner un conteneur en cours d'exécution

Utilisez l'option 1 du menu de clonage pour arrêter le conteneur avant le clonage, ou l'option 2 si votre stockage supporte les snapshots (ZFS/LVM).

## 🤝 Contribution

Les contributions sont les bienvenues ! Pour contribuer :

1. **Fork** le projet sur Gitea
2. Créez une **branche** pour votre fonctionnalité (`git checkout -b feature/AmazingFeature`)
3. **Commit** vos changements (`git commit -m 'Add some AmazingFeature'`)
4. **Push** vers la branche (`git push origin feature/AmazingFeature`)
5. Ouvrez une **Pull Request** sur https://git.h3campus.fr/Johnny/lxc-manager

### Standards de code

- Utiliser `shellcheck` pour valider le code
- Suivre les conventions de nommage existantes
- Commenter les fonctions complexes
- Tester sur Proxmox VE 7 et 8

## 📝 Changelog

### Version 2.1 (2025-01-30)

#### Ajouté
- Protection par conteneur (activation/désactivation)
- Mode protection global avec confirmations renforcées
- Sélection numérotée pour tous les stockages
- Filtrage intelligent des stockages pour backups
- Gestion des conteneurs actifs lors du clonage
- Extraction automatique du VMID et date pour les sauvegardes

#### Amélioré
- Validation stricte de toutes les entrées
- Gestion d'erreurs avec mode strict Bash
- Interface utilisateur plus intuitive
- Messages d'erreur plus clairs

#### Corrigé
- Affichage des codes couleur dans tous les menus
- Gestion des stockages incompatibles avec les backups
- Clonage des conteneurs en cours d'exécution

### Version 2.0 (2025-01-29)

#### Ajouté
- Sécurité renforcée avec `set -euo pipefail`
- Validation de toutes les entrées utilisateur
- Fonctions de validation (VMID, hostname, IP, nombres)
- Gestion centralisée des erreurs

### Version 1.0 (2025-01-28)

- Version initiale avec fonctionnalités de base

## 📄 Licence

Ce projet est sous licence MIT - voir le fichier [LICENSE](https://git.h3campus.fr/Johnny/lxc-manager/src/branch/main/LICENSE) pour plus de détails.

## 👨‍💻 Auteur

**Johnny** - [Profil Gitea](https://git.h3campus.fr/Johnny)

Développé avec l'assistance de **Claude** - Assistant IA d'Anthropic

## 🙏 Remerciements

- Proxmox VE pour leur excellent système de virtualisation
- La communauté H3 Campus pour leur soutien
- La communauté open source pour leurs contributions
- Tous les utilisateurs qui testent et améliorent ce script

## 📞 Support

- 🐛 **Issues** : [Signaler un bug](https://git.h3campus.fr/Johnny/lxc-manager/issues)
- 💬 **Discussions** : Contactez-moi sur H3 Campus
- 📖 **Wiki** : [Documentation complète](https://git.h3campus.fr/Johnny/lxc-manager/wiki)

## ⭐ Star le projet

Si ce projet vous est utile, n'hésitez pas à lui donner une étoile sur Gitea ! ⭐

---

**Note** : Ce script est fourni "tel quel", sans garantie d'aucune sorte. Testez toujours sur un environnement de test avant de l'utiliser en production.

**Hébergé sur** : [git.h3campus.fr](https://git.h3campus.fr/Johnny/lxc-manager)