Proxmox 9¶

Fonctionnalités de déploiement¶

Installation de Proxmox 9¶

Après l'installation du serveur, l'installation du service Proxmox VE est effectuée dans un délai de 15 à 20 minutes. Un e-mail sera envoyé à la boîte de messagerie liée au compte, vous informant du serveur installé et fournissant un lien au format https://proxmox<ID_serveur>.hostkey.in, que vous devez utiliser pour accéder à l'interface de gestion web de Proxmox VE :

• Login - root ;
• Password - mot de passe système.

Première connexion et vérification de base¶

1. Ouvrez votre navigateur > https://<IP_serveur>:8006 et entrez les identifiants :

   

2. Naviguez vers : Datacenter > Node > Summary - vérifiez le CPU, la RAM, les disques, le temps d'activité.

   

3. Désactivez le dépôt entreprise s'il n'y a pas d'abonnement :

Node > Repositories > pve-enterprise > Disable. Conservez pve-no-subscription :

Commandes Terminal :

sed -i 's/^deb/#deb/g' /etc/apt/sources.list.d/pve-enterprise.list || true

apt update

Réseau : Pont vmbr0¶

Le pont vmbr0 est un "commutateur" virtuel auquel les VM sont connectées. Il est lié à une interface physique (par exemple, ens18/eno1).

Via l'interface web¶

1. Node > System > Network.

   

2. Vérifiez que vmbr0 existe. S'il n'existe pas ou n'est pas configuré - Create > Linux Bridge :

   • Name : vmbr0
   • IPv4/CIDR : spécifiez votre IP statique au format X.X.X.X/YY (laissez vide si vous utilisez DHCP) ;
   • Gateway (IPv4) : passerelle par défaut (généralement X.X.X.1) (ne pas entrer si vous utilisez DHCP) ;
   • Bridge ports : votre interface physique, par exemple ens1 ;
   • Save > Apply configuration :

   

Via CLI (si l'accès web est perdu)¶

Exemple /etc/network/interfaces (ifupdown2) :

auto lo
iface lo inet loopback
auto ens18
iface ens18 inet manual
auto vmbr0
iface vmbr0 inet static
    address 192.0.2.10/24
    gateway 192.0.2.1
    bridge-ports ens18
    bridge-stp off
    bridge-fd 0

ifreload -a

Erreurs courantes :

• Bridge ports spécifiés incorrectement (mauvaise interface physique) > le réseau "disparaît". Corrigez l'interface et exécutez ifreload -a.
• Passerelle ou sous-réseau incorrects entrés > la connexion locale existe mais pas d'accès Internet.

Disques et Stockage¶

Ajouter un deuxième disque pour le stockage VM¶

1. Node > Disks : assurez-vous que le nouveau disque est visible (par exemple, sdb).

   

2. Option A - LVM-Thin (pratique pour les instantanés) :

   • Disks > LVM-Thin > Create : sélectionnez le disque > spécifiez le nom VG (par exemple, pve2) et thin-pool (par exemple, data2).

   

   • Le stockage apparaîtra dans Datacenter > Storage.

   

3. Option B - Directory :

   • Créez un système de fichiers (Disks > ZFS ou manuellement mkfs.ext4), montez sur /mnt/...

   

   • Datacenter > Storage > Add > Directory > chemin /mnt/... > activez Disk image, ISO image (selon les besoins).

Chargement des images ISO¶

Les images ISO peuvent être chargées de deux manières.

A. Via l'interface web¶

1. Datacenter > Storage > (sélectionnez storage de type ISO, par exemple, local) > Content.
2. Upload > sélectionnez le fichier local ubuntu-25.10-live-server-amd64.iso > attendez la fin du téléchargement.

B. Via le nœud (CLI)¶

Exemple de téléchargement de l'ISO Ubuntu 25.10 vers le stockage local :

cd /var/lib/vz/template/iso

wget https://releases.ubuntu.com/25.10/ubuntu-25.10-live-server-amd64.iso

Créer la première VM (Ubuntu 25.10)¶

Exemple : Ubuntu Server 25.10 (VPS avec 2 vCPU)

Cliquez sur Create VM (en haut à droite) :

General : Laissez l'ID par défaut, Name - ubuntu2510 (ou le vôtre) :

OS : sélectionnez l'ISO ubuntu-25.10-live-server-amd64.iso, Type : Linux :

System :

• Graphics card : Default ;
• BIOS : OVMF (UEFI) ;
• Machine : q35 ;
• SCSI Controller : VirtIO SCSI single ;
• (En option) activez Qemu Agent dans Options après la création de la VM (voir ci-dessous) :

Disks :

• Bus/Device : SCSI ;
• SCSI Controller : VirtIO SCSI single ;
• Storage : votre LVM-Thin/Directory ;
• Size : 20–40 Go (minimum 10-15 Go pour les tests) ;
• Discard (TRIM) : activez sur un thin-pool :

CPU :

• Sockets : 1 ;
• Cores : 2 (selon votre VPS) ;
• Type : host (meilleures performances) :

Memory :

• 2048–4096 Mo. Vous pouvez activer Ballooning (par exemple, Min 1024, Max 4096) :

Network :

• Model : VirtIO (paravirtualisé) ;
• Bridge : vmbr0 ;
• Si VLAN est nécessaire : VLAN Tag :

Confirm : vérifiez les paramètres, cochez Start after created et cliquez sur Finish :

Installation du système d'exploitation :¶

1. Démarrez la VM > Console (noVNC) > Try or Install Ubuntu :

   

2. Installateur :

   • IP DHCP/statique selon les besoins ;
   • Disk : Use entire disk ;
   • Profile : utilisateur/mot de passe ;
   • OpenSSH server : activer.

3. Redémarrez et connectez-vous via console/SSH.

Post-installation :¶

sudo apt update && sudo apt -y full-upgrade

sudo apt -y install qemu-guest-agent

sudo systemctl enable --now qemu-guest-agent

Boot Order : si démarrage depuis l'ISO - Options > Boot Order > déplacez scsi0 au-dessus de cdrom.

Installation de Windows (pour les nœuds plus puissants)¶

Convient aux nœuds avec ≥4 vCPU/8 Go de RAM. Sur les VDS faibles, Windows peut fonctionner de manière instable.

1. ISO : Téléchargez les ISO de Windows Server (2019/2022/2025) et virtio-win.iso (pilotes) dans Storage > Content :

   

2. Create VM > OS : Microsoft Windows, sélectionnez l'image ISO d'installation. L'option Add additional drive for VirtIO drivers vous permet d'ajouter un deuxième CD avec des pilotes :

   

3. System : BIOS OVMF (UEFI) ;

   • Machine : q35 ;
   • Si nécessaire, activez Add EFI Disk et Add TPM (pour les nouvelles versions de Windows). Si cela ne démarre pas - essayez SeaBIOS et désactivez EFI/TPM :

   

4. Disks :

   • Bus : SCSI ;
   • Controller : VirtIO SCSI ;
   • Size : 40–80 Go ;
   • Activez IO Threads :

   

5. CPU : 2–4 vCPUs ;

   • Type : host :

   

6. Memory : 4–8 Go :

   

7. Network : Model VirtIO (paravirtualisé), Bridge vmbr0 :

   

8. Confirm : Terminez la création de la VM en cliquant sur Create, puis dans Hardware > CD/DVD Drive, attachez un deuxième ISO - virtio-win.iso :

   

9. Installateur Windows : À l'étape de sélection du disque, cliquez sur Load Driver > spécifiez le CD avec VirtIO (vioscsi/viostor). Après l'installation - définissez les pilotes réseau dans le Device Manager (NetKVM) :

   

10. Agent invité (facultatif) : Installez Qemu Guest Agent pour Windows en utilisant virtio-win ISO :

    

Dépannage Windows :¶

• Écran noir/ne démarre pas : Changez OVMF > SeaBIOS, désactivez EFI/TPM.
• Pas de réseau : Assurez-vous que NIC = VirtIO et que le pilote NetKVM est installé.
• Ralentissements du disque : Assurez-vous que le disque = SCSI + pilote virtio.

Conteneurs LXC : Démarrage rapide¶

Des modèles préfabriqués avec un logiciel minimal sont disponibles dans le stockage de modèles.

1. Datacenter > Storage > (sélectionnez storage de type Templates)> **Content** > **Templates**. Téléchargez, par exemple :ubuntu-25.04-standard_*.tar.zst` ou un autre modèle nécessaire :

   

2. Cliquez sur Create CT :

   • General : Spécifiez ID/Name, Unprivileged container = Enabled (plus sûr par défaut). Définissez le mot de passe root ou la clé SSH.

   

   • Template : Sélectionnez le modèle téléchargé.

   

   • Disks : Storage/Size (par exemple, 8–20 Go).

   

   • CPU/RAM : Selon la tâche (par exemple, 1 vCPU, 1–2 Go de RAM).

   

   • Network : Bridge vmbr0, IPv4 = DHCP (ou Statique si nécessaire). VLAN Tag selon les besoins.

   

Conseil pour le réseau : Si vous utilisez NAT sur vmbr1, définissez-le et spécifiez l'IP statique.

- **DNS** : Par défaut de l'hôte ou le vôtre.

- **Features** : Activez éventuellement `nesting`, `fuse`, `keyctl` (dépend des applications dans le conteneur).

• Start at boot/Start after created : selon les souhaits.
• Après le démarrage : connectez-vous via SSH et installez le logiciel depuis le modèle ou les packages :

  apt update && apt -y upgrade
  

  

Dans LXC, Qemu Guest Agent n'est pas nécessaire. Le montage des répertoires hôtes se fait via MP (Points de montage).

Profils VM typiques¶

• Ubuntu/Debian (Web/DB/Utilitaire) : SCSI + VirtIO, UEFI (OVMF), 1–2 vCPUs, 2–4 Go de RAM, disque 20–60 Go ; activez Qemu Guest Agent.
• Services légers (DNS/DHCP/Proxy) : 1 vCPU, 1–2 Go de RAM, disque 8–20 Go.
• Hôtes de conteneurs (Docker/Podman) : 2–4 vCPUs, 4–8 Go de RAM ; disque/pool séparé pour les données.

Alternative à l'ISO : Vous pouvez utiliser les images Cloud-Init Ubuntu 25.10 pour un clonage rapide avec réseau/SSH auto-configuré. Convient si vous prévoyez d'avoir de nombreuses VM similaires.

Connecter les VM et LXC dans un même réseau¶

Variante de base (Un sous-réseau) :¶

1. Assurez-vous que toutes les VM/conteneurs ont Bridge = vmbr0 (ou vmbr1).
2. Si vous utilisez un réseau DHCP - les adresses sont attribuées automatiquement, si statique - spécifiez les IP dans un sous-réseau (par exemple, 10.10.0.2/24, 10.10.0.3/24) et passerelle commune 10.10.0.1.
3. En option. VLAN : Spécifiez VLAN Tag dans les paramètres de la carte réseau des VM/CT et assurez-vous que l'uplink du commutateur autorise ce VLAN.
4. À l'intérieur du système d'exploitation, vérifiez que le pare-feu local ne bloque pas ICMP/SSH/HTTP.
5. Test : Depuis la VM Ubuntu ping <IP-LXC> et vice versa ; ip route, traceroute aideront en cas de problèmes.

Lorsque différents sous-réseaux :¶

• Proxmox lui-même ne fait pas de routage entre les ponts. Un routeur (VM séparée avec Linux/pfSense) ou NAT sur l'hôte est nécessaire.
• NAT simple sur l'hôte (exemple) :

Activer le transfert :

sysctl -w net.ipv4.ip_forward=1

iptables -t nat -A POSTROUTING -o vmbr0 -j MASQUERADE

EXT_IF=vmbr0


iptables -t nat -C POSTROUTING -s 10.10.0.0/24 -o $EXT_IF -j MASQUERADE 2>/dev/null || \
iptables -t nat -A POSTROUTING -s 10.10.0.0/24 -o $EXT_IF -j MASQUERADE


iptables -C FORWARD -i vmbr1 -o $EXT_IF -j ACCEPT 2>/dev/null || \
iptables -A FORWARD -i vmbr1 -o $EXT_IF -j ACCEPT


iptables -C FORWARD -i $EXT_IF -o vmbr1 -m state --state RELATED,ESTABLISHED -j ACCEPT 2>/dev/null || \
iptables -A FORWARD -i $EXT_IF -o vmbr1 -m state --state RELATED,ESTABLISHED -j ACCEPT

Sauvegardes et Modèles¶

• Backup : Datacenter > Backup ou Node > Backup - configurez l'horaire vzdump (stockage, heure, mode instantané/stop) :

  

• Modèle VM : Après la configuration de base de la VM > Convert to Template. La création de nouvelles VM via Clone fait gagner du temps et élimine les erreurs :

Problèmes courants et solutions¶

"Interface web disparue" (GUI ne s'ouvre pas)¶

Vérifiez si le nœud est accessible via SSH. Sur le nœud, exécutez :

systemctl status pveproxy pvedaemon pve-cluster

journalctl -u pveproxy --no-pager -n 100

systemctl restart pveproxy pvedaemon

Réseau perdu après modification du pont¶

Connectez-vous via console (via fournisseur/VNC/IPMI). Vérifiez /etc/network/interfaces et appliquez :

ifreload -a

ip a

ip r

La VM ne se connecte pas à Internet¶

• Assurez-vous que les IP/masque/passerelle/DNS corrects sont spécifiés à l'intérieur de la VM.
• Vérifiez que le Pont de l'adaptateur réseau de la VM est - vmbr0 (ou nat/vmbr1).
• Si VLAN est utilisé - spécifiez VLAN Tag dans les paramètres NIC VM (Hardware > Network Device > VLAN Tag), et sur l'uplink du commutateur, autorisez ce VLAN.

L'ISO ne démarre pas / Installateur non visible¶

• Vérifiez l'ordre de démarrage (Options > Boot Order) et que l'ISO correcte est connectée.
• Pour UEFI, vérifiez si le Secure Boot dans le système d'exploitation invité n'est pas activé si l'ISO ne le prend pas en charge.

Charge élevée/Disque engorgé¶

• Utilisez VirtIO SCSI et activez IO Threads pour une utilisation intensive du disque.
• Ne stockez pas les sauvegardes sur le même thin-pool qui contient les disques opérationnels - mieux vaut avoir un stockage séparé.

Webcam/Périphérique USB "déconnecté" dans la VM¶

• Pour le transfert USB, utilisez Hardware > USB Device. Si l'appareil cesse de répondre - Stop/Start VM ou reconnectez l'USB sur l'hôte. Parfois, désactiver Use USB3 aide pour la compatibilité.

Mises à jour et Redémarrage¶

apt update && apt full-upgrade -y

reboot

Diagnostic : Aide-mémoire¶

Réseau du nœud :

ip a; ip r; ping -c3 1.1.1.1; ping -c3 google.com

systemctl status pveproxy pvedaemon pvestatd pve-cluster

journalctl -u pveproxy -n 200 --no-pager

df -h | sort -k5 -h
lvs; vgs; pvs

cat /etc/pve/storage.cfg

qm list; qm config <VMID>; qm status <VMID>

qm stop <VMID> --skiplock; sleep 2; qm start <VMID>

Mini-FAQ¶

Q : vmbr0 peut-il être renommé ? R : Oui, mais ce n'est pas recommandé sur un nœud de production - il est plus facile de laisser vmbr0 et d'ajouter des ponts supplémentaires (vmbr1) selon les besoins.

Q : Où se trouvent les ISO par défaut ? R : Dans le stockage local : /var/lib/vz/template/iso.

Q : Quelle est la différence entre local et local-lvm ? R : Local - un répertoire régulier pour ISO, modèles de conteneurs, etc. local-lvm - LVM-Thin pour les disques VM/conteneur avec instantanés.

Q : Comment cloner rapidement une VM ? R : Transformez une VM exemplaire en Modèle, puis Clone > Full/Linked.

Q : Comment redimensionner en toute sécurité le CPU/RAM d'une VM ? R : Éteignez la VM et modifiez les ressources ; pour Linux, certains paramètres peuvent être modifiés "à la volée", mais mieux vaut planifier.

Liste de contrôle de préparation du système¶

• L'accès à https://<IP_serveur>:8006 existe ;
• vmbr0 est configuré et Internet depuis le nœud ;
• Les ISO sont chargés dans le stockage ;
• La première VM est créée et installée ;
• Qemu Guest Agent est activé ;
• La sauvegarde est configurée (horaire vzdump) ;
• Les mises à jour sont vérifiées.

Commander un serveur avec Proxmox 9 via l'API¶