> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/knowledge-base/fr/virtual-machines/vm-advanced-options.md).

# Options avancées des VM

Guide pour configurer les options avancées des VM afin d’ajuster les performances, l’émulation matérielle et le comportement des périphériques dans VergeOS, y compris le threading CPU, le SMBIOS, l’optimisation des NIC et les paramètres de machine QEMU.

## Vue d’ensemble

Le champ Options avancées de la VM permet aux utilisateurs avancés d'affiner les paramètres de la machine virtuelle au-delà de ce qui est disponible dans l'interface utilisateur standard. Ces options offrent un contrôle granulaire sur les fonctionnalités du CPU, l'émulation matérielle et le comportement des périphériques.

{% hint style="warning" %}
**À utiliser avec prudence**

Les options avancées peuvent avoir un impact important sur les performances et la stabilité de la VM. Ne modifiez ces paramètres que si vous en comprenez les implications. Des valeurs incorrectes peuvent empêcher le démarrage de votre VM.
{% endhint %}

## Format

Les options avancées utilisent un format simple clé-valeur, avec une option par ligne :

```
option1=value1
option2=value2
option3=value3
```

## Options disponibles

### CPU et mémoire

#### Threads CPU

```
cpu.threads=2
```

Définit le nombre de threads CPU par cœur. La valeur par défaut est 1.

**Cas d’utilisation :** Activation du SMT (Simultaneous Multi-Threading) pour les applications qui tirent parti du multithreading simultané.

#### Préallocation de la mémoire

```
mem-prealloc=1
```

Préalloue toute la mémoire de la VM au démarrage au lieu de l'allouer à la demande.

**Cas d’utilisation :** Réduit la latence d'allocation mémoire pour les charges de travail critiques en termes de performances. Utile pour les applications en temps réel ou lors de l'utilisation de hugepages.

### Configuration de l'UUID

Vous pouvez personnaliser l'UUID (Identifiant Unique Universel) de la VM afin de répondre à des exigences spécifiques, comme la licence logicielle ou des scénarios de migration.

#### UUID système

```
smbios.type1.uuid=550e8400-e29b-41d4-a716-446655440000
```

Définit l'UUID système présenté au système d'exploitation invité. Il s'agit de l'UUID principal que la plupart des logiciels vérifient.

**Cas d'utilisation :**

* Migration de VM depuis d'autres plateformes tout en préservant la licence
* Logiciels qui valident un UUID spécifique
* Clonage de VM nécessitant des identifiants uniques

{% hint style="warning" %}
**Format de l'UUID**

Les UUID doivent être au format standard : `xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx` (8-4-4-4-12 caractères hexadécimaux). Les formats invalides empêcheront le démarrage de la VM.
{% endhint %}

{% hint style="success" %}
**Génération des UUID**

Sous Linux : `uuidgen` Sous Windows PowerShell : `[guid]::NewGuid()` En ligne : utilisez un outil de génération d'UUID
{% endhint %}

### Personnalisation SMBIOS

Les options SMBIOS (System Management BIOS) permettent de personnaliser les informations matérielles présentées au système d'exploitation invité.

#### Type 0 - Informations BIOS

```
smbios.type0.vendor=American Megatrends Inc.
smbios.type0.version=2.0
smbios.type0.date=01/01/2023
```

#### Type 1 - Informations système

```
smbios.type1.product=Serveur personnalisé
smbios.type1.version=1.0
smbios.type1.sku=SKU123
smbios.type1.family=Famille serveur
```

#### Type 2 - Informations de carte mère

```
smbios.type2.manufacturer=Fabricant personnalisé
smbios.type2.product=Carte personnalisée
smbios.type2.version=1.0
```

#### Type 3 - Informations de boîtier

```
smbios.type3.manufacturer=Châssis personnalisé
smbios.type3.version=1.0
smbios.type3.sku=CHASSIS123
```

#### Type 4 - Informations sur le processeur

```
smbios.type4.version=Intel(R) Xeon(R) CPU E5-2680 v4
smbios.type4.manufacturer=Intel
```

**Cas d'utilisation de SMBIOS :**

* Licences logicielles qui vérifient les signatures matérielles
* Applications attendant des configurations matérielles spécifiques
* Scénarios de test nécessitant une identification système spécifique

### Ajustement de l'interface réseau

Pour chaque NIC, vous pouvez ajuster les paramètres des files d'attente à l'aide de l'ID de l'actif de la NIC :

```
nic1.txqueuelen=2000
nic1.numtxqueues=4
nic1.numrxqueues=4
```

**Cas d'utilisation :**

* Applications réseau à haut débit
* Réduction de la latence réseau
* Optimisation pour des charges de travail réseau spécifiques

### Paramètres spécifiques à la machine

Personnalisez les paramètres de la machine QEMU :

```
machine.cap-cfpc=broken
machine.cap-sbbc=broken
machine.cap-ibs=broken
```

**Cas d'utilisation :**

* Contournement des problèmes liés à l'atténuation de sécurité du CPU
* Compatibilité avec des systèmes d'exploitation invités spécifiques
* Optimisation des performances pour les environnements de confiance

### Options RTC (horloge temps réel)

```
rtc.drift-fix=slew
```

**Cas d'utilisation :**

* Correction des problèmes de dérive de l'heure dans les VM
* Exigences de synchronisation pour les applications sensibles au temps

## Options spécifiques aux périphériques

Vous pouvez définir des paramètres pour n'importe quel périphérique à l'aide de son ID d'actif :

```
device1.guest-reset=true
device1.guest-resets-all=false
```

Pour les disques :

```
drive1.cache=writeback
drive1.detect-zeroes=on
```

## Cas d'utilisation courants

### Calcul haute performance

```
cpu.threads=2
mem-prealloc=1
nic1.numtxqueues=8
nic1.numrxqueues=8
```

### Conformité des licences Windows

```
smbios.type1.manufacturer=Dell Inc.
smbios.type1.product=PowerEdge R740
smbios.type1.serial=ABC123
```

### Préserver l'UUID après la migration

```
smbios.type1.uuid=550e8400-e29b-41d4-a716-446655440000
```

À utiliser lors de la migration d'une VM depuis une autre plateforme et lorsque le système d'exploitation invité contient un logiciel lié à l'UUID d'origine.

### Optimisation du réseau

```
nic1.txqueuelen=5000
nic1.numtxqueues=4
nic1.numrxqueues=4
```

## Bonnes pratiques

{% hint style="success" %}
**Recommandations de test**

1. Testez d'abord les options avancées dans un environnement hors production
2. Documentez toute option avancée que vous utilisez pour référence future
3. N'ajoutez que les options qui résolvent des problèmes ou des exigences spécifiques
4. Surveillez les performances de la VM après l'application des options avancées
   {% endhint %}

## Dépannage

Si votre VM ne démarre pas après l'ajout d'options avancées :

1. Supprimez toutes les options avancées et essayez de démarrer la VM
2. Réajoutez les options une par une pour identifier le paramètre problématique
3. Consultez les journaux de la VM pour des messages d'erreur spécifiques
4. Vérifiez la syntaxe - assurez-vous que chaque option se trouve sur sa propre ligne sans espaces supplémentaires

{% hint style="info" %}
**Compatibilité des versions**

Certaines options avancées peuvent ne pas être disponibles dans toutes les versions de VergeOS. Les options sont traitées dynamiquement, donc les options non prises en charge sont généralement ignorées plutôt que de provoquer des erreurs.
{% endhint %}

{% hint style="info" %}
**Informations sur le document**

* Dernière mise à jour : 2026-01-24
* Version de VergeOS : 26.1
  {% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.verge.io/knowledge-base/fr/virtual-machines/vm-advanced-options.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.