Проблемы при запуске
Решение типичных проблем при запуске 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
Решение:
- В Docker Desktop → Containers → проект
proxy→ удалитеhashcore-stratum-proxyиhashcore-proxy-configurator. - Перейдите в Volumes → удалите
proxy_proxy_configs. - Перезапустите WSL в PowerShell от администратора:
wsl --shutdown - Дождитесь статуса "Engine running" в Docker Desktop.
- Запустите сервисы заново:
docker compose up -d
Конфликты портов
Симптом. Контейнеры не запускаются, в логах сообщение о том, что порт уже занят.
Решение. Измените занятые порты в файле docker-compose.yml.
⚠️ Порты указаны в формате
"ВНЕШНИЙ_ПОРТ:ВНУТРЕННИЙ_ПОРТ". Изменяйте только левое значение — правое (внутренний порт контейнера) менять нельзя.
Примеры:
- Конфигуратор:
5001:5001→5002:5001 - Grafana:
5000:3000→5050:3000 - Proxy API:
5010:5010→5020:5010
Проблемы с разрешениями (Linux)
Симптом. Docker не запускается из-за прав доступа.
Решение. Добавьте текущего пользователя в группу docker:
sudo usermod -aG docker $USER
После выполнения команды перелогиньтесь, чтобы изменения вступили в силу.
Мониторинг не работает после обновления
Симптом. После docker compose pull Grafana или Prometheus не запускаются.
Причина. При мажорном обновлении формат хранения данных в volumes может оказаться несовместим с ранее накопленными данными.
Решение А — удалить данные мониторинга (данные будут потеряны):
- Docker Desktop → Containers → удалите контейнеры
grafanaиprometheus. - Volumes → удалите
proxy_grafana_dataиproxy_prometheus_data. docker compose up -d
Решение Б — зафиксировать версии образов (данные сохранятся):
Зафиксируйте версии в docker-compose.yml (см. раздел «Обновление»).