Corriger l'erreur réseau MiroFish 2026 : VITE_API_BASE_URL pour VPS et accès distant

L'erreur réseau MiroFish sur VPS signifie souvent que le navigateur appelle localhost:5001. Ce guide explique VITE_API_BASE_URL, les ports 3000/5001, avec liens vers accès SSH distant, déploiement OpenClaw et choix de nœud courte durée.

Divulgation : location Mac cloud par VpsGona. MiroFish est un projet open source indépendant.

Première installation ? Suivez d'abord le guide de déploiement MiroFish Docker (.env et compose).

Pourquoi « Network Error »

L'UI charge sur :3000 mais les appels API échouent si axios vise le mauvais hôte (#511).

Piège localhost

Depuis votre PC, localhost dans le JS désigne votre machine, pas le VPS. Le proxy Vite ne s'applique qu'en dev local.

Rôle de VITE_API_BASE_URL

Variables VITE_ injectées au build (doc Vite). Rebuild Docker obligatoire après .env.

VITE_API_BASE_URL=http://IP_PUBLIQUE:5001

Checklist correctif

1. Éditer .env
2. Publier ports 3000 et 5001
3. docker compose up --build -d
4. Rafraîchissement forcé du navigateur

Ports et pare-feu

Ouvrez 3000 et 5001 dans le groupe de sécurité cloud. Testez avec curl depuis votre poste.

Vérifier l'API

1. curl vers IP:5001
2. DevTools : hôte XHR = IP publique
3. Rebuild frontend après changement d'env

Option Mac cloud

Pilotes courts : Mac mini M4 dès $20.7/jour — voir SSH vs VNC et sélection de nœud.

FAQ

404 sur http://IP:5001/ = panne ?

Pas forcément—la racine peut être absente. Un timeout indique FW/Docker.

localhost persiste après .env ?

Rebuild frontend requis (--build Docker).

HTTPS possible ?

Oui, avec reverse proxy et la même URL dans VITE_API_BASE_URL.

Lié aux clés LLM ?

Network Error sans réponse = souvent mauvais hôte. Réseau d'abord.

LAN OK, téléphone non ?

Mettre l'IP LAN joignable par le téléphone dans l'env.