Problemas al iniciar

Error de montaje de volume en WSL

Síntoma. Al ejecutar docker compose up -d ocurre un error:

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

Solución.

Solo se puede eliminar un volume después de eliminar los contenedores a los que está montado. Los datos de monitoreo (Grafana, Prometheus) se conservan.

1. En Docker Desktop, vaya a la sección Containers y abra el proyecto proxy.
2. Elimine los contenedores hashcore-stratum-proxy y hashcore-proxy-configurator.
3. Vaya a la sección Volumes y elimine proxy_proxy_configs.
4. Reinicie WSL (en PowerShell como administrador):

   wsl --shutdown
   

5. Espere a que Docker Engine se reinicie y el estado cambie a "Engine running".
6. Inicie todos los servicios de nuevo — Docker recreará los contenedores y el volume automáticamente:

   docker compose up -d
   

7. Verifique que todos los contenedores estén en ejecución:

   docker ps
   

Conflictos de puertos

Síntoma. Los contenedores no se inician, los registros muestran un mensaje de que el puerto ya está en uso.

Solución. Cambie los puertos ocupados en el archivo docker-compose.yml.

⚠️ Los puertos se especifican en el formato "PUERTO_EXTERNO:PUERTO_INTERNO". Cambie solo el valor de la izquierda (el puerto disponible en su PC). El valor de la derecha (el puerto interno del contenedor) no debe modificarse.

Ejemplos de reemplazo correcto:

• Configurador: 5001:5001 → 5002:5001 (cambiamos solo la parte izquierda)
• Grafana: 5000:3000 → 5050:3000 (el puerto interno 3000 se mantiene sin cambios)
• Proxy API: 5010:5010 → 5020:5010

Problemas de permisos (Linux)

Síntoma. Docker no se inicia debido a problemas de permisos.

Solución. Agregue el usuario actual al grupo docker:

sudo usermod -aG docker $USER

Después de ejecutar el comando, cierre y vuelva a iniciar sesión para que los cambios surtan efecto.

El monitoreo no funciona después de una actualización

Síntoma. Después de ejecutar docker compose pull, Grafana o Prometheus no se inician o muestran errores.

Causa. Al actualizar los servicios a una nueva versión mayor, el formato de almacenamiento de datos en los volumes puede cambiar y volverse incompatible con los datos de monitoreo previamente acumulados.

Solución A — eliminar los datos de monitoreo (los datos se perderán):

1. Abra Docker Desktop.
2. Vaya a la sección Containers y encuentre el proyecto proxy.
3. Elimine los contenedores grafana y prometheus.

⚠️ Este paso eliminará todos los datos de monitoreo acumulados de forma irreversible. Si los datos son importantes, primero haga una copia de seguridad de los volumes.

4. Vaya a la sección Volumes y elimine:

• proxy_grafana_data
• proxy_prometheus_data

5. En la terminal, ejecute:

   docker compose up -d
   

El sistema recreará los volumes y reiniciará el monitoreo con datos limpios.

Solución B — fijar las versiones de las imágenes (los datos se conservarán):

Para evitar que esta situación se repita en la próxima actualización, fije las versiones de las imágenes en docker-compose.yml. Para más detalles, consulte la sección 3.4.

Si el problema persiste después de la Solución A, póngase en contacto con el soporte técnico.