MiroFish Netzwerkfehler beheben 2026: VITE_API_BASE_URL für VPS & Remote-Zugriff

MiroFish Network Error auf dem VPS bedeutet meist: Der Browser ruft localhost:5001 auf. Dieser Leitfaden erklärt VITE_API_BASE_URL und die Ports 3000/5001 — mit Links zu SSH-Fernzugriff, OpenClaw-Bereitstellung und Kurzzeitmiete-Nodes.

Hinweis: Cloud-Mac-Miete von VpsGona. MiroFish ist unabhängiges OSS.

Neuinstallation? Zuerst den MiroFish Docker Bereitstellungsguide (.env und compose) durchgehen.

Warum Network Error

UI auf :3000 lädt, API scheitert bei falscher axios-URL (#511).

Localhost-Falle

localhost im Browser-JS ist Ihr PC, nicht der Server. Vite-Proxy gilt nur lokal.

VITE_API_BASE_URL

VITE_-Variablen werden beim Build eingebettet (Vite-Doku). Docker: --build nach .env-Änderung.

VITE_API_BASE_URL=http://ÖFFENTLICHE_IP:5001

Fix-Checkliste

1. .env bearbeiten
2. Ports 3000/5001 mappen
3. docker compose up --build -d
4. Browser hart neu laden

Ports & Firewall

Cloud-SG und ufw für 3000 und 5001 öffnen. Extern curl testen.

Backend prüfen

1. curl http://IP:5001/ vom Laptop
2. DevTools: XHR-Host = öffentliche IP
3. Frontend nach Env-Änderung neu bauen

Cloud-Mac-Option

Kurzpilot: Mac mini M4 ab $20.7/Tag — SSH vs VNC, Node-Auswahl.

FAQ

404 auf http://IP:5001/ = Ausfall?

Nicht zwingend—Root evtl. undefiniert. Timeout → FW/Docker.

localhost trotz .env?

Frontend-Rebuild nötig (Docker --build).

HTTPS möglich?

Ja, mit Reverse Proxy und passender VITE_API_BASE_URL.

LLM-Keys?

Network Error ohne Antwort → meist Host. Zuerst Netzwerk.

LAN ok, Handy nicht?

LAN-IP in env, Port 5001 öffnen.