« ssh: connect to host github.com port 22: Connection refused » sur Mac

La connexion au port 22 a été refusée : un coupe-feu ou une règle du réseau bloque très probablement SSH. GitHub documente SSH sur le port HTTPS comme moyen de contournement.

Réglez-le avec votre agentCopie un prompt pour Claude Code, Codex ou tout agent capable d’utiliser Terminal.

Mon Mac a ce problème : « ssh: connect to host github.com port 22: Connection refused » sur Mac. Lis https://kilobat.app/fr/guides/ssh-github-port-22-connection-refused.md et résous-le avec moi. Installe la CLI Kilobat si elle manque : brew install seifip/kilobat/kilobat. Lance toi-même les vérifications Terminal et kilobat du guide et dis-moi ce que tu trouves. Liste les étapes que moi seul peux faire. Demande-moi avant de modifier un réglage.

S’applique à : git et OpenSSH sur toutes les versions actuelles de macOS.Vérifié le 29 octobre 2026

Symptômes

  • git clone, git pull ou git push affiche ssh: connect to host github.com port 22: Connection refused.
  • Les URL HTTPS du même dépôt peuvent fonctionner.
  • Cela arrive sur les réseaux d’hôtel, d’école et d’entreprise.

Causes probables

  • Un coupe-feu qui bloque le port 22. Certains réseaux refusent SSH. GitHub indique que certains coupe-feu refusent complètement les connexions SSH.
  • Un proxy ou un VPN. Un VPN ou un proxy peut bloquer le port 22 sortant.
  • Un nom d’hôte incorrect. Une faute de frappe dans l’URL distante pointe vers un hôte sans SSH.
  • Une app de sécurité locale. Une app de sécurité peut bloquer SSH.

Comment vérifier

  1. Affichez l’URL distante.

    git remote -v
  2. Testez le port 22.

    nc -vz github.com 22
  3. Testez SSH sur le port 443.

    ssh -T -p 443 git@ssh.github.com
  4. Lisez le journal SSH de l’échec.

    ssh -vT git@github.com

Comment corriger

  1. Ajoutez ce bloc à ~/.ssh/config. Il fait passer le trafic GitHub par le port 443.

    Host github.com
        Hostname ssh.github.com
        Port 443
        User git
  2. Testez de nouveau.

    ssh -T git@github.com
  3. Ou passez le dépôt distant en HTTPS.

    git remote set-url origin https://github.com/OWNER/REPO.git
  4. Si le port 443 échoue aussi, désactivez le VPN pour un court test. Réactivez-le ensuite.

Avec Kilobat

  1. Le diagnostic de connexion de Kilobat teste l’adresse couche par couche : réseau, proxy, DNS, règles, IPv4, IPv6, TLS et serveur. Il nomme la couche qui a échoué.

    kilobat why github.com
  2. Ces vérifications Kilobat sont gratuites. Les agents IA les lancent via MCP avec diagnose_connection et diagnose_network. Consultez Trouver pourquoi un site ou une API ne se connecte pas.

Questions

Que doit afficher un bon test ?

GitHub indique que vous voyez « Hi USERNAME! You’ve successfully authenticated, but GitHub does not provide shell access. »

En quoi est-ce différent de « Operation timed out » ?

Ici, la connexion est refusée immédiatement. Un délai dépassé signifie aucune réponse. Voir ssh: connect to host port 22: Operation timed out sur Mac.

Sources

Vérifié le 29 octobre 2026.