Skip to content

Instantly share code, notes, and snippets.

@stephdl
Last active January 15, 2026 11:03
Show Gist options
  • Select an option

  • Save stephdl/7c6d873036b6ebf5c72dee96b5f7d649 to your computer and use it in GitHub Desktop.

Select an option

Save stephdl/7c6d873036b6ebf5c72dee96b5f7d649 to your computer and use it in GitHub Desktop.
Guide d'intégration TrueNAS et Proxmox

Guide d'intégration TrueNAS et Proxmox

Table des matières

  1. Architecture générale
  2. Configuration NFS
  3. Configuration iSCSI simple
  4. Comparaison des deux approches

Architecture générale

TrueNAS complète Proxmox en fournissant des capacités de stockage et de partage de fichiers, créant ainsi un système global de virtualisation et stockage. Il existe deux approches principales pour stocker les disques des machines virtuelles :

  • NFS : Approche la plus simple et courante, partage de fichiers
  • iSCSI simple : Approche bloc directe et facile à configurer

Configuration NFS

Vue d'ensemble

NFS permet de monter un périphérique de stockage TrueNAS dans Proxmox et le rendre accessible aux machines virtuelles sur d'autres nœuds.

Étapes sur TrueNAS

  1. Créer un dataset

    • Va dans Storage > Datasets
    • Crée un nouveau dataset dédié pour Proxmox : data/nfs
    • Note le chemin complet (ex: data/nfs)
  2. Configurer le partage NFS

    • Va dans Shares > NFS
    • Crée un nouvel export NFS
    • Sélectionne le dataset créé
    • Configure les options avancées :
      • Mapall User : root
      • Mapall Group : wheel
    • Ajoute l'IP de Proxmox dans les permissions d'accès
  3. Vérifier la configuration

    • Note l'IP du serveur TrueNAS
    • Vérifie que NFSv4 est activé (recommandé)

Étapes sur Proxmox

  1. Ajouter le stockage NFS

    • Va dans Datacenter > Storage > Add > NFS
    • Remplis les champs :
      • Server : IP du TrueNAS
      • Export : /mnt/data/nfs (chemin d'export)
      • Content : VZDump backup file, Disk image, Container, ISO image
  2. Tester la connexion

    • Proxmox doit pouvoir accéder au stockage
    • Utilise les VMs pour vérifier le fonctionnement

Format des disques VM

Trois options s'offrent à toi :

Format Avantages Inconvénients
QCOW2 Snapshots via Proxmox, flexibilité Légèrement moins performant
RAW Meilleures performances Pas de snapshots Proxmox
RAW avec snapshots NFS Très bonnes perfs + snapshots natifs (Proxmox 9+) Nécessite Proxmox 9 en bêta

Note : À partir de Proxmox 9 (en bêta), les snapshots sont supportés nativement sur NFS pour les disques RAW, ce qui offre le meilleur des deux mondes : performance et snapshots.


Configuration iSCSI simple

Vue d'ensemble

iSCSI simple expose un volume en tant que périphérique bloc. C'est l'approche la plus directe et facile à configurer, sans plugin supplémentaire.

Étapes sur TrueNAS

1. Créer un ZVol

  • Va dans Storage > Datasets
  • Crée un dataset parent si nécessaire : data
  • Crée un ZVol enfant : data/iscsi
  • Configure la taille souhaitée (elle peut être ajustée ultérieurement)

2. Configurer iSCSI avec le wizard

  • Va dans Shares > Block (iSCSI)
  • Clique sur "Create iSCSI Share Wizard"
  • Suis les étapes du wizard :
    • Sélectionne ton ZVol data/iscsi
    • Configure le nom du partage (ex: proxmox-iscsi)
    • Ajoute le réseau Proxmox dans les autorisations (ex: 192.168.1.0/24)
    • Valide

Le wizard se charge de configurer automatiquement les portals et les initiators. Une fois terminé, note l'IQN (Initiator Qualifier Name) généré (ex: iqn.2024-01.mxl.freenas:proxmox-iscsi) - tu en auras besoin pour Proxmox.

Étapes sur Proxmox

1. Ajouter le stockage dans Proxmox

  • Va dans Datacenter > Storage > Add > iSCSI
  • Remplis les champs :
    • ID : Nom du stockage (ex: truenas-iscsi)
    • Portal : IP du TrueNAS
    • Target : Sélectionne ou colle l'IQN complet (ex: iqn.2024-01.mxl.freenas:proxmox-iscsi)
    • Content : VZDump backup file, Disk image, Container
    • Nodes : Sélectionne les nœuds Proxmox qui utilisent ce stockage

2. Vérifier la connexion

Une fois ajouté, Proxmox devrait découvrir automatiquement le stockage iSCSI. Vérifie que le stockage apparaît dans la liste et que tu peux créer des VMs dessus.


Comparaison des deux approches

Critère NFS iSCSI simple
Complexité Faible Très faible
Performance Bonne Très bonne
Snapshots Via QCOW2 uniquement Via TrueNAS
Thin provisioning Non Non
Scalabilité Bonne Excellente
Facilité de setup ✅✅
Plugin supplémentaire Non Non
Clés SSH requises Non Non

Quand choisir NFS ?

  • Besoin de partager des fichiers génériques
  • Préfère la simplicité
  • Configuration multi-protocoles

Quand choisir iSCSI simple ?

  • Veut une performance optimale pour les VMs
  • Besoin d'une configuration rapide
  • Volume de stockage dédié aux VMs
  • Veut éviter les complications de plugins

Dépannage courant

Problèmes NFS

  • Erreur de permission : Vérifier les paramètres Mapall User/Group
  • Pas d'accès : Vérifier les règles de firewall entre Proxmox et TrueNAS
  • Lenteur : Activer NFSv4, vérifier la bande passante réseau

Problèmes iSCSI

  • Cible non trouvée : Vérifier la connectivité réseau entre Proxmox et TrueNAS
  • Montage échoué : Vérifier que le réseau autorisé dans le wizard correspond au réseau de Proxmox
  • Performance faible : Vérifier la bande passante réseau et la charge du TrueNAS
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment