Mac 上的「ssh: connect to host github.com port 22: Connection refused」

連接埠 22 的連線被拒絕,因此很可能是防火牆或網路政策阻擋了 SSH。GitHub 的說明文件提供了使用 HTTPS 連接埠跑 SSH 的繞過方法。

讓你的代理程式來解決拷貝一則提示詞,適用於 Claude Code、Codex 或任何能使用終端機的代理程式。

我的 Mac 出現了這個問題:Mac 上的「ssh: connect to host github.com port 22: Connection refused」。請閱讀 https://kilobat.app/zh-hant/guides/ssh-github-port-22-connection-refused.md,並和我一起逐步處理。如果缺少 Kilobat CLI,請安裝:brew install seifip/kilobat/kilobat。請你自己執行指南中的終端機和 kilobat 檢查,並告訴我發現了什麼。列出只有我才能完成的步驟。變更任何設定之前先問我。

適用於:所有目前 macOS 版本上的 git 和 OpenSSH。檢查日期:2026年10月29日

症狀

  • git clone、git pull 或 git push 印出 ssh: connect to host github.com port 22: Connection refused。
  • 同一個儲存庫的 HTTPS 網址可能可以使用。
  • 會發生在飯店、學校和公司的網路上。

可能原因

  • 防火牆阻擋連接埠 22。有些網路會拒絕 SSH。GitHub 指出,有些防火牆會完全拒絕 SSH 連線。
  • 代理伺服器或 VPN。VPN 或代理伺服器可能阻擋對外的連接埠 22。
  • 主機名稱錯誤。遠端網址打錯字,指向了沒有 SSH 的主機。
  • 本機資安 App。資安 App 可能阻擋 SSH。

如何檢查

  1. 顯示遠端網址。

    git remote -v
  2. 測試連接埠 22。

    nc -vz github.com 22
  3. 測試連接埠 443 上的 SSH。

    ssh -T -p 443 git@ssh.github.com
  4. 讀取失敗時的 SSH 記錄。

    ssh -vT git@github.com

如何修正

  1. 把這個區塊加到 ~/.ssh/config。它會讓 GitHub 的流量改走連接埠 443。

    Host github.com
        Hostname ssh.github.com
        Port 443
        User git
  2. 再測試一次。

    ssh -T git@github.com
  3. 或者把遠端改為 HTTPS。

    git remote set-url origin https://github.com/OWNER/REPO.git
  4. 如果連接埠 443 也失敗,請暫時關閉 VPN 來測試,之後再重新開啟。

使用 Kilobat

  1. Kilobat 的連線診斷會逐層測試位址:網路、代理伺服器、DNS、規則、IPv4、IPv6、TLS 和伺服器。它會指出失敗的那一層。

    kilobat why github.com
  2. 這些 Kilobat 檢查都是免費的。AI 代理程式可透過 MCP 以 diagnose_connection 和 diagnose_network 執行。請參閱找出某個網站或 API 連不上的原因。

常見問題

正常的測試應該印出什麼?

GitHub 指出,你會看到「Hi USERNAME! You've successfully authenticated, but GitHub does not provide shell access.」

這和「Operation timed out」有什麼不同?

這裡的連線會立刻被拒絕。逾時則表示沒有回應。請參閱 Mac 上的 ssh: connect to host port 22: Operation timed out。

資料來源

查核日期:2026 年 10 月 29 日。