Comment servir des modèles d'IA locaux depuis n'importe quel appareil de votre réseau avec l'accès LAN d'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. 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.

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 à la place.

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 .

1. Installez l’application pour macOS, Windows ou Linux

2. Lancez l’application

3. Puis allez dans Paramètres → API → Distant et LAN.

À 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 :

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

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 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

Lancer	Accessible depuis
unsloth studio	cette machine uniquement
unsloth studio -H 0.0.0.0	votre réseau
unsloth studio -H 0.0.0.0 --cloudflare	votre réseau, plus une URL publique Cloudflare
unsloth studio --secure	une URL publique Cloudflare uniquement, le LAN reste fermé

--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 à 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.

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