HashCore Docs
Устранение неполадок

Проблемы при запуске

Решение типичных проблем при запуске HashCore Proxy: ошибки монтирования volume на WSL, конфликты портов, проблемы с разрешениями.

Ошибка монтирования volume на WSL

Симптом. При запуске docker compose up -d ошибка:

Error response from daemon: error while mounting volume...
failed to mount local volume: no such file or directory

Решение:

  1. В Docker Desktop → Containers → проект proxy → удалите hashcore-stratum-proxy и hashcore-proxy-configurator.
  2. Перейдите в Volumes → удалите proxy_proxy_configs.
  3. Перезапустите WSL в PowerShell от администратора:
    wsl --shutdown
    
  4. Дождитесь статуса "Engine running" в Docker Desktop.
  5. Запустите сервисы заново:
    docker compose up -d
    

Конфликты портов

Симптом. Контейнеры не запускаются, в логах сообщение о том, что порт уже занят.

Решение. Измените занятые порты в файле docker-compose.yml.

⚠️ Порты указаны в формате "ВНЕШНИЙ_ПОРТ:ВНУТРЕННИЙ_ПОРТ". Изменяйте только левое значение — правое (внутренний порт контейнера) менять нельзя.

Примеры:

  • Конфигуратор: 5001:50015002:5001
  • Grafana: 5000:30005050:3000
  • Proxy API: 5010:50105020:5010

Проблемы с разрешениями (Linux)

Симптом. Docker не запускается из-за прав доступа.

Решение. Добавьте текущего пользователя в группу docker:

sudo usermod -aG docker $USER

После выполнения команды перелогиньтесь, чтобы изменения вступили в силу.

Мониторинг не работает после обновления

Симптом. После docker compose pull Grafana или Prometheus не запускаются.

Причина. При мажорном обновлении формат хранения данных в volumes может оказаться несовместим с ранее накопленными данными.

Решение А — удалить данные мониторинга (данные будут потеряны):

  1. Docker Desktop → Containers → удалите контейнеры grafana и prometheus.
  2. Volumes → удалите proxy_grafana_data и proxy_prometheus_data.
  3. docker compose up -d

Решение Б — зафиксировать версии образов (данные сохранятся): Зафиксируйте версии в docker-compose.yml (см. раздел «Обновление»).

© 2026 HashCore. All rights reserved.