Proxmox 9¶

Dans cet article

• Fonctionnalités de déploiement
• Proxmox 9. Installation
• Première connexion et vérification de base
• Réseau : Bridge vmbr0
• Disques et stockage
• Chargement d'images ISO
• Créer la première VM (Ubuntu 25.10)
• Installation de Windows (pour les nœuds plus puissants)
• Conteneurs LXC : Démarrage rapide
• Profils VM typiques
• Connecter les VM et LXC sur un seul réseau
• Sauvegardes et modèles
• Problèmes courants et solutions
• Diagnostics : Aide-mémoire
• Mini-FAQ
• Checklist de préparation du système
• Commander un serveur avec Proxmox 9 via API

Fonctionnalités de déploiement¶

Proxmox 9. Installation¶

Après l'installation du serveur, dans un délai de 15 à 20 minutes, l'installation du service Proxmox VE est effectuée. Un e-mail sera envoyé à l'adresse liée au compte, vous informant de l'installation du serveur et fournissant un lien au format https://proxmox<ID_server>.hostkey.in, auquel vous devrez accéder pour entrer dans 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://proxmox{Server_ID}.hostkey.in et saisissez les identifiants :

   

2. Naviguez vers : Datacenter > Node > Summary - vérifiez le CPU, la RAM, les disques et l'uptime.

   

3. Désactivez le dépôt enterprise 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 : Bridge vmbr0¶

Le bridge vmbr0 est un "switch" virtuel auquel les VM sont connectées. Il est lié à une interface physique (ex: ens18/eno1).

Via l'interface Web¶

1. Node > System > Network.

   

2. Vérifiez que vmbr0 existe. S'il n'existe pas ou s'il 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 saisir si vous utilisez DHCP) ;
   • Bridge ports: votre interface physique, par exemple ens1;
   • Save > Apply configuration :

   

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

Exemple de /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 mal spécifiés (mauvaise interface physique) > le réseau "disparaît". Corrigez l'interface et exécutez ifreload -a.
• Mauvaise passerelle ou sous-réseau saisi > la connexion locale existe mais pas d'accès Internet.

Disques et stockage¶

Ajouter un second disque pour le stockage VM¶

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

   

2. Option A - LVM-Thin (pratique pour les snapshots) :

   • Disks > LVM-Thin > Create : sélectionnez le disque > spécifiez le nom du VG (ex: pve2) et le thin-pool (ex: 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 d'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, ex: 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;
• (Optionnellement) activez le 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 le Ballooning (ex: Min 1024, Max 4096) :

Network :

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

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

Installation de l'OS :¶

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

   

2. L'installateur :

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

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 vous démarrez sur 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 RAM. Sur un VPS peu puissant, Windows peut fonctionner de manière instable.

1. ISO : Téléchargez les ISOs 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 second CD avec les 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 elle 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 second ISO - virtio-win.iso :

   

9. Installateur Windows : Lors de l'étape de sélection du disque, cliquez sur Load Driver > spécifiez le CD avec VirtIO (vioscsi/viostor). Après l'installation - configurez les pilotes réseau dans le Gestionnaire de périphériques (NetKVM) :

   

10. Guest Agent (optionnel) : Installez Qemu Guest Agent pour Windows en utilisant l'ISO virtio-win :

    

Dépannage Windows :¶

• Écran noir/ne démarre pas : Changez OVMF > SeaBIOS, désactivez EFI/TPM.
• Pas de réseau : Assurez-vous que la 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éconfigurés avec un logiciel minimal sont disponibles dans le stockage de modèles (templates).

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 l'ID/Name, Unprivileged container = Enabled (plus sûr par défaut). Définissez le mot de passe root ou une clé SSH.

   

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

   

   • Disks : Stockage/Taille (par exemple, 8–20 Go).

   

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

   

   • Network : Bridge vmbr0, IPv4 = DHCP (ou statique si nécessaire). VLAN Tag si besoin.

   

Astuce Réseau : Si vous utilisez le NAT sur vmbr1, configurez-le et spécifiez l'IP statique.

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

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

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

  apt update && apt -y upgrade
  

  

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

Profils VM typiques¶

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

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

Connecter les VM et LXC sur un seul réseau¶

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

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

En cas de sous-réseaux différents :¶

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

Activez le forwarding :

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 une planification vzdump (stockage, heure, mode snapshot/stop) :

  

• VM Template : Après la configuration de base d'une VM > Convert to Template. Créer de nouvelles VM via Clone permet de gagner du temps et d'éviter les erreurs :

  

Problèmes courants et solutions¶

"L'interface Web a disparu" (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

Perte de réseau après modification du Bridge¶

Connectez-vous via console (via le 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 dans la VM.
• Vérifiez que le Bridge de l'adaptateur réseau de la VM est bien vmbr0 (ou nat/vmbr1).
• Si un VLAN est utilisé - spécifiez le VLAN Tag dans les paramètres NIC de la VM (Hardware > Network Device > VLAN Tag), et autorisez ce VLAN sur l'uplink du switch.

L'ISO ne démarre pas / L'installateur n'est pas visible¶

• Vérifiez l'ordre de démarrage (Options > Boot Order) et assurez-vous que l'ISO correct est connecté.
• Pour UEFI, vérifiez si le Secure Boot dans l'OS invité n'est pas activé si l'ISO ne le supporte pas.

Charge élevée / "Saturation" du disque¶

• Utilisez VirtIO SCSI et activez les IO Threads pour une utilisation intensive du disque.
• Ne stockez pas les sauvegardes sur le même thin-pool que celui qui contient les disques opérationnels - il est préférable d'avoir un stockage séparé.

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

• Pour le passthrough USB, utilisez Hardware > USB Device. Si le périphérique ne répond plus - faites Stop/Start sur la 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

Diagnostics : 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: Peut-on renommer vmbr0 ? R: Oui, mais ce n'est pas recommandé sur un nœud de production - il est plus simple de laisser vmbr0 et d'ajouter des bridges 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 classique pour l'ISO, les modèles de conteneurs, etc. local-lvm - LVM-Thin pour les disques de VM/conteneurs avec snapshots.

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

Q: Comment augmenter la CPU/RAM d'une VM en toute sécurité ? R: Éteignez la VM et modifiez les ressources ; pour Linux, certains paramètres peuvent être modifiés "à la volée", mais il est préférable de planifier l'opération.

Checklist de préparation du système¶

• L'accès à https://<server_IP>:8006 est opérationnel ;
• vmbr0 est configuré et Internet fonctionne sur le nœud ;
• Les ISO sont chargés dans le stockage ;
• La première VM est créée et installée ;
• Le Qemu Guest Agent est activé ;
• La sauvegarde est configurée (vzdump schedule) ;
• Les mises à jour ont été vérifiées.

Commander un serveur avec Proxmox 9 via API¶

Pour installer ce logiciel en utilisant l'API, suivez ces instructions.