Build

ERROR: failed to solve: failed to forward ssh agent: no ssh agent running. – Docker BUILDKIT_SSH_FAIL

BUILDKIT_SSH_FAIL

L'accesso a repository Git privati con `RUN --mount=type=ssh` fallisce perché il client non trova un demone `ssh-agent` in ascolto o l'argomento `--ssh default` è omesso.

Categoria: DockerGruppo: BuildConfidenza: altaUltimo aggiornamento: 19-08-2026Letto 1 volta

Cosa significa questo errore?

L'accesso a repository Git privati con `RUN --mount=type=ssh` fallisce perché il client non trova un demone `ssh-agent` in ascolto o l'argomento `--ssh default` è omesso.

Messaggio originale

ERROR: failed to solve: failed to forward ssh agent: no ssh agent running.

Contesto e parole chiave

Alias

  • BUILDKIT_SSH_FAIL
  • failed to forward ssh agent

Messaggi alternativi

  • inoltro ssh agent fallito demone ssh non attivo

Prodotti

  • Docker Engine / Docker Compose / BuildKit / containerd

Piattaforme

  • Docker Desktop su macOS
  • Docker Desktop su Windows
  • Linux

Parole chiave

  • Build
  • BUILDKIT_SSH_FAIL
  • compose
  • container
  • docker
  • docker.build.ssh-forward-failed
  • errore-docker-buildkit-ssh-forward-failed

Cause possibili

Origine del problema per Docker BuildKit: inoltro dell'agente SSH non riuscito

L'accesso a repository Git privati con `RUN --mount=type=ssh` fallisce perché il client non trova un demone `ssh-agent` in ascolto o l'argomento `--ssh default` è omesso.

molto comune

Diagnosi

Diagnostica container e log per Docker BuildKit: inoltro dell'agente SSH non riuscito

Eseguire comandi di ispezione dei container e controllare i log del demone Docker con journalctl o docker logs.

Come leggere il risultato. Mostra le eccezioni a runtime dell'applicazione, segnali di terminazione o errori di rete interna.

docker
docker logs --tail 50 <container_id>

Risoluzione

Procedura di risoluzione per Docker BuildKit: inoltro dell'agente SSH non riuscito

Difficoltà: mediaRischio: basso

Applicare la configurazione raccomandata nelle specifiche ufficiali Docker e BuildKit.

  1. Ispezionare i parametri di avvio nel file Dockerfile o docker-compose.yml
  2. Verificare i vincoli di memoria, permessi e compatibilità delle porte
  3. Riavviare il container o eseguire una compilazione pulita senza cache

Domande frequenti

Come risolvere il problema BUILDKIT_SSH_FAIL in Docker?

L'accesso a repository Git privati con `RUN --mount=type=ssh` fallisce perché il client non trova un demone `ssh-agent` in ascolto o l'argomento `--ssh default` è omesso.

Approfondimenti

Schede correlate