ProxMenux/web/messages/fr/docs/storage-share/host-local-shared.json

{
  "meta": {
    "title": "Hôte : ajouter un répertoire partagé | Documentation ProxMenux",
    "description": "Créez un répertoire hôte prêt pour les bind mounts LXC, avec des permissions adaptées aux conteneurs privilégiés et non privilégiés. Sticky bit, rwx pour tous et ACL par défaut pour l’héritage.",
    "ogTitle": "Hôte : ajouter un répertoire partagé | Documentation ProxMenux",
    "ogDescription": "Préparer un répertoire hôte pour les bind mounts LXC avec des permissions compatibles avec des CT privilégiés et non privilégiés."
  },
  "header": {
    "title": "Host : Ajouter un répertoire partagé sur Host",
    "description": "Créer un répertoire hôte conçu pour être monté sur un ou plusieurs conteneurs LXC. ProxMenux applique un ensemble de permissions qui fonctionne à la fois pour les CT privilégiés et non privilégiés à la fois — pas de maux de tête UID décalés, pas de chowns par conteneur — et enregistre le répertoire afin que le gestionnaire de montage LXC puisse le récupérer plus tard.",
    "section": "Stockage et partage · Hôte"
  },
  "intro": {
    "title": "Ce que c'est (et n'est PAS)",
    "body": "Cet outil n'enregistre <strong>pas</strong> quoi que ce soit dans Proxmox (pas de <code>pvesm add</code> ici). Il prépare simplement un répertoire sur l'hôte — <code>/mnt/shared</code>, par défaut — avec des autorisations que tout conteneur LXC peut lire et écrire, que le CT soit privilégié ou non. L'étape suivante habituelle consiste à le monter en liaison dans chaque CT avec le <mountLink>LXC Mount Manager</mountLink>."
  },
  "why": {
    "heading": "Pourquoi un outil dédié à cette tâche",
    "intro": "Lorsque vous liez un répertoire hôte dans un conteneur LXC, les permissions dépendent de :",
    "items": [
      "Si le CT est <strong>privilégié</strong> (UID 0 du CT = UID 0 de l’hôte) ou <strong>non privilégié</strong> (UID 0 du CT = UID 100000 de l’hôte — tout est décalé de +100000).",
      "Le propriétaire du répertoire hôte (un fichier appartenant à l’UID 1000 sur l’hôte relève des permissions « autres » pour un CT non privilégié, car aucun utilisateur du CT ne correspond à cet UID hôte).",
      "Indique si plusieurs CT partagent le même répertoire (différents CT peuvent avoir des plages UID différentes)."
    ],
    "outro": "ProxMenux choisit ici une solution pratique : <strong>donner accès à tout le monde</strong> au niveau du système de fichiers, avec rwx pour tous, le sticky bit et des ACL pour l’héritage des permissions. Tout UID mappé peut lire et écrire ; aucun alignement des UID/GID n’est nécessaire."
  },
  "howRuns": {
    "heading": "Comment fonctionne le script",
    "body": "Le script n'a pas de menu principal — il exécute une seule action, <strong>Créer répertoire partagé</strong>. Phase 1 recueille le chemin cible; Phase 2 crée le répertoire et applique les permissions."
  },
  "bits": {
    "heading": "Ce que chaque bit de permission fait",
    "intro": "Le numéro <strong>1777</strong> n'est pas arbitraire — c'est le même mode que Linux utilise pour <code>/tmp</code>. Trois propriétés combinées:",
    "headerBit": "Bit",
    "headerEffect": "Effet",
    "headerWhy": "Pourquoi c'est important ici",
    "rows": [
      {
        "bit": "1 (sticky bit)",
        "effect": "Seuls le propriétaire du fichier, celui du répertoire ou un processus suffisamment privilégié peuvent supprimer ou renommer le fichier.",
        "why": "Limite la suppression des fichiers d’autres utilisateurs ayant des UID mappés différents. N’isole pas les CT partageant un UID mappé ou un accès root privilégié."
      },
      {
        "bit": "777 (rwx-rwx-rwx)",
        "effect": "Tout le monde peut lire, écrire et traverser.",
        "why": "Les UIDs CT non privilégiés (100000+) apparaissent comme des \"autres\" de l'hôte, de sorte que world-rwx leur donne accès."
      },
      {
        "bit": "ACL (par défaut)",
        "effect": "Hérité sur chaque fichier / sous-dir nouvellement créé.",
        "why": "Le nouveau contenu hérite des ACL par défaut sans réexécuter le script. Les applications peuvent toutefois demander des modes restrictifs ou modifier les permissions ensuite."
      }
    ],
    "privTitle": "Les CT privilégiés voient la même chose, juste sans le changement",
    "privBody": "Pour un CT privilégié, UID 0 dans le CT est UID 0 sur l'hôte, de sorte que <code>root</code> à l'intérieur du CT peut lire / écrire le répertoire hôte directement. Le <code>1777</code> est toujours bien — cela signifie simplement que les utilisateurs non root à l'intérieur du CT peuvent également utiliser le répertoire. Les mêmes autorisations couvrent les deux cas."
  },
  "where": {
    "heading": "Où mettre le répertoire partagé",
    "intro": "Le localisateur offre quatre options :",
    "opt1Title": "1. Créer un nouveau dossier dans /mnt",
    "opt1Body": "Le choix habituel. Le ProxMenux suggère automatiquement la première dénomination libre (<code>shared</code>, <code>shared2</code>, <code>shared3</code>, ...). Il suffit de confirmer ou de taper un nom différent.",
    "opt2Title": "2. Saisissez le chemin personnalisé",
    "opt2Body": "Pour les répertoires hors <code>/mnt</code>. Tout chemin absolu fonctionne (par exemple : <code>/srv/media</code>, <code>/data/family</code>). Le script applique les mêmes permissions.",
    "opt3Title": "3. Afficher les dossiers existants dans /mnt",
    "opt3Body": "Diagnostic en lecture seule : liste chaque répertoire sous <code>/mnt</code> avec ses permissions, son propriétaire et son espace disponible. Utile avant de créer un nouveau pour éviter les collisions de noms.",
    "opt4Title": "4. Annuler",
    "opt4Body": "Quitte sans rien créer, comme la touche <kbd>Esc</kbd>.",
    "tipTitle": "Où vit /mnt ?",
    "tipBody": "Par défaut, <code>/mnt</code> se trouve sur le système de fichiers racine Proxmox. Si vous voulez le répertoire partagé sur un disque différent (un disque de données, un pool ZFS), montez ce disque sous <code>/mnt/&lt;name&gt;</code> d'abord (Disk Manager ou <diskLink>Ajouter le disque local comme stockage Proxmox</diskLink>), puis créez le répertoire partagé comme sous-dossier à l'intérieur — ou choisissez \"Entrer le chemin personnalisé\" ici et pointez sur le disque monté."
  },
  "manual": {
    "heading": "Équivalent manuel",
    "body": "Tout le flux peut être rejoué à la main:"
  },
  "next": {
    "heading": "Étape suivante : bind mount dans les conteneurs",
    "body": "La création du répertoire ne fait que le préparer — aucun conteneur ne le voit encore. Pour le rendre visible à l'intérieur d'un ou plusieurs LXC, utilisez le <mountLink>LXC Mount Manager</mountLink> pour lier le montage de <code>/mnt/&lt;name&gt;</code> dans les CT. Étant donné que les autorisations sont déjà ouvertes, Mount Manager <strong>ne proposera pas</strong> de les modifier : le répertoire est prêt à être utilisé tel quel."
  },
  "troubleshoot": {
    "heading": "Dépannage",
    "mkdirTitle": "\"Failed to create directory\"",
    "mkdirBody": "Habituellement un problème de système de fichiers: <code>/mnt</code> est sur un système de fichiers en lecture seule, le chemin contient un composant qui n'est pas un répertoire (par exemple, vous avez tapé <code>/etc/passwd/sub</code>), ou le disque est plein. Vérifiez avec <code>df -h /mnt</code> et <code>mount | grep /mnt</code>.",
    "writeTitle": "Conteneur ne peut pas écrire malgré les autorisations ouvertes",
    "writeBody": "Vérifiez que le CT utilise bien le bind mount (<code>pct config &lt;ctid&gt; | grep ^mp</code>). À l'intérieur du CT, exécutez <code>touch /mnt/data/test-$(date +%s)</code> — si cela échoue avec la permission refusée, le montage peut être sur un système de fichiers hôte qui n'honore pas les ACL (certaines anciennes <code>ext3</code> ou <code>vfat</code> montures). Déplacez le répertoire partagé vers un support ext4 / xfs / btrfs / zfs.",
    "aclTitle": "ACL commande silencieusement indisponible",
    "aclBody": "Sur une installation Proxmox minimale <code>setfacl</code> / <code>getfacl</code> peuvent ne pas être installés. Le script tombe gracieusement (contrôle <code>command -v setfacl</code>) et n'applique que les permissions POSIX — ce qui est souvent suffisant, mais les nouveaux fichiers n'hériteront pas automatiquement du profil permissif. Installez <code>acl</code> avec <code>apt-get install -y acl</code> et réexécutez le script dans le répertoire."
  },
  "related": {
    "heading": "Autres",
    "items": [
      {
        "href": "/docs/storage-share/lxc-mount-points",
        "label": "Gestionnaire de montage LXC",
        "tail": "— l'étape suivante naturelle: lier ce répertoire dans un ou plusieurs conteneurs."
      },
      {
        "href": "/docs/storage-share/host-local-disk",
        "label": "Ajouter le disque local comme stockage Proxmox",
        "tailRich": "— si vous voulez le répertoire partagé sur un disque dédié, préparez le disque d'abord, montez-le sous <code>/mnt</code>, puis créez le sous-dossier partagé ici."
      }
    ]
  }
}