Исправление ошибки сети MiroFish 2026: VITE_API_BASE_URL для VPS и удалённого доступа

Network Error в MiroFish на VPS обычно означает, что браузер обращается к localhost:5001. Разбираем VITE_API_BASE_URL, порты 3000/5001; ссылки: SSH-доступ, развёртывание OpenClaw, краткосрочная аренда узла.

Раскрытие: облачный Mac от VpsGona. MiroFish — независимый OSS.

Впервые разворачиваете? Сначала полное руководство по развёртыванию MiroFish Docker (.env и compose).

Почему Network Error

UI на :3000 открывается, но API падает при неверном хосте axios (#511).

Ловушка localhost

В JS браузера localhost — это ваш ПК, не VPS. Прокси Vite только для локальной разработки.

VITE_API_BASE_URL

Переменные VITE_ вшиваются при сборке (документация Vite). После правки .env нужен docker compose up --build.

VITE_API_BASE_URL=http://ПУБЛИЧНЫЙ_IP:5001

Чеклист исправления

1. Правка .env
2. Проброс портов 3000 и 5001
3. docker compose up --build -d
4. Жёсткое обновление браузера

Порты и firewall

Откройте 3000 и 5001 в security group. Проверьте curl с ноутбука.

Проверка бэкенда

1. curl http://IP:5001/ — отказ = сеть/Docker
2. DevTools: XHR на публичный IP
3. Пересборка фронтенда после env

Облачный Mac

Короткий пилот: Mac mini M4 от $20.7/день — SSH vs VNC, выбор узла (SG / US East).

FAQ

404 на http://IP:5001/ — это падение?

Не обязательно—корень может быть не определён. Таймаут → FW/Docker.

localhost после .env?

Нужна пересборка фронтенда (--build).

HTTPS?

Да, с reverse proxy и тем же URL в env.

Ключи LLM?

Network Error без ответа — чаще хост. Сначала сеть.

LAN работает, телефон нет?

Укажите LAN IP, доступный телефону.