> For the complete documentation index, see [llms.txt](https://unsloth.ai/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://unsloth.ai/docs/fr/notions-de-base/lan.md).

# Comment servir des modèles d'IA locaux depuis n'importe quel appareil de votre réseau avec l'accès LAN Unsloth

Vous pouvez exécuter des modèles d’IA locaux sur n’importe quel appareil de votre domicile ou de votre bureau disposant d’un accès LAN en utilisant [Unsloth](https://github.com/unslothai/unsloth). Avec cette option activée, les modèles locaux peuvent être accessibles depuis un téléphone, un ordinateur portable ou un autre ordinateur sur le même réseau Wi‑Fi ou filaire, sans rien envoyer vers le cloud. Aucune URL publique ni connexion Internet n’est nécessaire — votre IA reste sur votre machine et votre réseau.

{% columns %}
{% column %}
L’accès LAN est le moyen le plus rapide d’utiliser un modèle local depuis un autre appareil. Le trafic ne quitte jamais votre réseau, donc la latence est faible.

Activez l’accès LAN et Unsloth répond à l’adresse réseau de votre machine, par exemple `http://192.168.1.42:8888`. Ouvrez-la sur votre téléphone, votre ordinateur portable ou tout appareil du même réseau.

C’est gratuit et cela fonctionne hors ligne. Rien ne quitte votre réseau et vous ne touchez jamais à votre routeur ou à votre pare-feu. Pour un accès depuis l’extérieur de votre réseau, utilisez [l’accès distant](/docs/fr/notions-de-base/comment-servir-des-llm-locaux-partout-acces-distant-securise-avec-cloudflare-et-unsloth.md) à la place.
{% endcolumn %}

{% column %}

<figure><img src="https://3215535692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FD2v8S0MkS1xAeEVersl2%2Fmobile_studio1.gif?alt=media&#x26;token=7cd8a534-d82f-4f05-8d5a-9b7277f7eac0" alt="" width="180"><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

Deux façons de l’activer :

* **Lorsque vous lancez Unsloth :** ajoutez `-H 0.0.0.0` à votre `unsloth studio` commande
* **Pendant qu’Unsloth est en cours d’exécution :** allez dans Paramètres → API → **Distant et LAN**, trouvez la carte **Accès LAN** et appuyez sur **Démarrer**

### ⚡ Démarrage rapide

Tout d’abord, nous allons devoir télécharger l’application [Unsloth Desktop](https://unsloth.ai/download) .

1. Installez l’application pour [macOS](https://unsloth.ai/download/mac), Windows ou [Linux](https://unsloth.ai/download/linux)
2. Lancez l’application
3. Puis allez dans Paramètres → API → **Distant et LAN**.

<div data-with-frame="true"><figure><img src="https://3215535692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FcMQ75NHKaf3xosAL87cq%2Fremote-lan-settings2.png?alt=media" alt=""><figcaption></figcaption></figure></div>

À utiliser lorsque Unsloth est déjà en cours d’exécution et que vous voulez l’avoir sur un autre appareil du même bâtiment. Appuyez sur **Démarrer** sur la **Accès LAN** carte. `En ligne` signifie que l’adresse répond déjà, et pas seulement qu’elle a été demandée.

#### Démarrer automatiquement

Le **Démarrer automatiquement** interrupteur sous la carte d’accès LAN met Unsloth sur le réseau à chaque démarrage. Arrêter maintenant l’accès LAN ne désactivera pas cette option ; l’interrupteur est une préférence distincte de l’état d’exécution.

### CLI : méthode LAN

Après avoir installé Unsloth manuellement, exécutez dans votre terminal :

```bash
unsloth studio -H 0.0.0.0 -p 8888
```

Unsloth se lie à toutes les interfaces, donc le port brut est accessible depuis votre réseau. Aucune URL publique Cloudflare n’est publiée, `-H 0.0.0.0` à elle seule vous maintient sur le LAN. La première ligne affichée est l’adresse utilisée par les autres appareils :

```
Démarrage d’Unsloth Studio sur http://[<adresse réseau de votre machine>]:8888
```

L’adresse peut être en IPv6, entre crochets comme ci-dessus. Copiez l’URL complète, y compris les crochets.

#### CLI : LAN plus un lien public

```bash
unsloth studio -H 0.0.0.0 --cloudflare -p 8888
```

Le port brut reste accessible sur votre réseau *et* une URL publique Cloudflare est publiée. La bannière vous avertit précisément de cela, car c’est le mode le moins privé. La [page d’accès distant](/docs/fr/notions-de-base/comment-servir-des-llm-locaux-partout-acces-distant-securise-avec-cloudflare-et-unsloth.md) le couvre.

#### UI : mettre sur le réseau un serveur déjà en cours d’exécution

1. Ouvrez **Paramètres → API → Distant et LAN**.
2. Trouvez le **Accès LAN** carte.
3. Cliquez sur **Démarrer**.
4. Lorsque le statut indique **En ligne**, ouvrez l’adresse affichée depuis n’importe quel appareil du même réseau.

#### Ce que chaque lancement expose réellement

<table><thead><tr><th width="391">Lancer</th><th>Accessible depuis</th></tr></thead><tbody><tr><td><code>unsloth studio</code></td><td>cette machine uniquement</td></tr><tr><td><code>unsloth studio -H 0.0.0.0</code></td><td>votre réseau</td></tr><tr><td><code>unsloth studio -H 0.0.0.0 --cloudflare</code></td><td>votre réseau, plus une URL publique Cloudflare</td></tr><tr><td><code>unsloth studio --secure</code></td><td>une URL publique Cloudflare uniquement, le LAN reste fermé</td></tr></tbody></table>

`--secure` et l’accès LAN sont opposés : `--secure` force une liaison en loopback, donc rien sur votre réseau ne peut atteindre le port brut.

### 🔒 Sécurité

Mettre Unsloth sur le réseau signifie que chaque appareil de ce réseau peut le voir.

* **La connexion n’est pas chiffrée.** Le trafic LAN est en HTTP clair. Toute personne sur le même segment réseau peut le lire. Sur un réseau que vous ne contrôlez pas, utilisez [l’accès distant](/docs/fr/notions-de-base/comment-servir-des-llm-locaux-partout-acces-distant-securise-avec-cloudflare-et-unsloth.md) à la place, le lien Cloudflare est en HTTPS.
* **Les outils côté serveur s’exécutent avec votre utilisateur.** La recherche web, Python et l’exécution dans le terminal sont activés par défaut, donc toute personne accédant au serveur avec votre clé API peut exécuter du code sur cette machine. Passez `--disable-tools` lorsque vous exposez Unsloth, et gardez la clé API privée. Chaque lancement accessible sur le réseau l’indique dans la bannière.
* **Unsloth vérifie si le port fuit au-delà de votre routeur.** Sur une liaison générique, une vérification d’accessibilité teste si le port brut est accidentellement accessible depuis Internet, et la bannière de démarrage le signale si c’est le cas. Cette vérification contacte `ifconfig.me` et `check-host.net`; définissez `UNSLOTH_STUDIO_DISABLE_PUBLIC_CHECK=1` pour ignorer les deux.

### ❔ Dépannage

* **`Erreur : Unsloth Studio est déjà en cours d’exécution sur le port 8888 (PID ...)`.** Une autre instance occupe le port. Exécutez `unsloth studio stop` d’abord, ou démarrez celle-ci sur un autre `--port`.
* **L’adresse ne répond pas depuis un autre appareil.** Les deux appareils doivent être sur le même réseau. Le Wi‑Fi invité, l’isolation client ("AP isolation") et les VPN sont généralement en cause. Vérifiez aussi que le pare-feu de la machine autorise les connexions entrantes sur le port.
* **L’adresse a changé.** Les IP du LAN sont attribuées par votre routeur et peuvent changer. Donnez à la machine une adresse IP statique ou une réservation DHCP dans les paramètres de votre routeur pour une adresse stable.
* **Démarrer est grisé dans l’interface.** Lisez le message sous la carte, il indique la raison du blocage.

### 🌱 Variables d’environnement

| Variable                              | Objectif                                                                                    |
| ------------------------------------- | ------------------------------------------------------------------------------------------- |
| `UNSLOTH_STUDIO_DISABLE_PUBLIC_CHECK` | `1` ignore la vérification tierce d’accessibilité du port brut sur les liaisons génériques. |
| `UNSLOTH_STUDIO_TRUST_FORWARDED`      | `1` respecte `X-Forwarded-For` derrière votre propre proxy inverse.                         |

### 🌐 API HTTP

Les quatre nécessitent une **session UI,** une clé API est rejetée. Une opération refusée renvoie `409` avec la raison du blocage comme détail.

<table><thead><tr><th width="100">Méthode</th><th>Chemin</th><th>Objectif</th></tr></thead><tbody><tr><td><code>GET</code></td><td><code>/api/settings/lan-access</code></td><td>État actuel, adresse, <code>can_start</code> / <code>can_stop</code>, <code>block_reason</code>.</td></tr><tr><td><code>POST</code></td><td><code>/api/settings/lan-access/start</code></td><td>Planifie un démarrage géré par les paramètres. Idempotent.</td></tr><tr><td><code>POST</code></td><td><code>/api/settings/lan-access/stop</code></td><td>Planifie un arrêt géré par les paramètres. Ne modifie pas la préférence de démarrage automatique.</td></tr><tr><td><code>PUT</code></td><td><code>/api/settings/lan-access/auto-start</code></td><td><code>{"enabled": true|false}</code>.</td></tr></tbody></table>


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://unsloth.ai/docs/fr/notions-de-base/lan.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
