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

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

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

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

Error response from daemon: error while mounting volume '/var/lib/docker/volumes/proxy_proxy_configs/_data': 
failed to mount local volume: mount /run/desktop/mnt/host/wsl/docker-desktop-bind-mounts/Ubuntu/...
: no such file or directory

Решение.

Удалить volume можно только после удаления контейнеров, к которым он примонтирован. Данные мониторинга (Grafana, Prometheus) при этом сохраняются.

  1. В Docker Desktop перейдите в раздел Containers, откройте проект proxy.
  2. Удалите контейнеры hashcore-stratum-proxy и hashcore-proxy-configurator.
  3. Перейдите в раздел Volumes и удалите proxy_proxy_configs.
  4. Перезапустите WSL (в PowerShell от имени администратора): powershell wsl --shutdown
  5. Дождитесь, пока Docker Engine перезапустится и статус изменится на "Engine running".
  6. Запустите все сервисы заново — Docker пересоздаст контейнеры и volume автоматически: bash docker compose up -d
  7. Убедитесь, что все контейнеры запущены: bash docker ps

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

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

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

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

Примеры правильной замены:

  • Конфигуратор: 5001:50015002:5001 (меняем только левую часть)
  • Grafana: 5000:30005050:3000 (внутренний порт 3000 оставляем неизменным)
  • Proxy API: 5010:50105020:5010

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

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

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

sudo usermod -aG docker $USER

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

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

Симптом. После выполнения docker compose pull Grafana или Prometheus не запускаются или отображают ошибки.

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

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

  1. Откройте Docker Desktop.
  2. Перейдите в раздел Containers и найдите проект proxy.
  3. Удалите контейнеры grafana и prometheus. > ⚠️ Этот шаг удалит все накопленные данные мониторинга безвозвратно. Если данные важны — сначала сделайте резервную копию volumes.
  4. Перейдите в раздел Volumes и удалите: - proxy_grafana_data
- `proxy_prometheus_data`
  1. В терминале выполните: bash docker compose up -d
Система заново создаст volumes и запустит мониторинг с чистыми данными.

Решение Б — зафиксировать версии образов (данные сохранятся):

Чтобы эта ситуация не повторилась при следующем обновлении — зафиксируйте версии образов в docker-compose.yml. Подробнее см. раздел 3.4.

Если после Решения А проблема сохраняется — обратитесь в поддержку.

© 2026 HashCore. All rights reserved.