使用 SSH 替代 HTTPS 连接 Git

直接一直习惯使用 HTTPS 连接到远程 Git 仓库，偶尔会遇到 SSL 问题，比如这样：

LibreSSL SSL_connect: SSL_ERROR_SYSCALL in connection to codeberg.org:443

可能是网络环境导致的，但既然是 SSL 问题，那不用 HTTPS 协议不就不会遇到这个问题了吗？改用 SSH 连接至远程仓库可能是更稳定的选择。

一般来说，HTTPS 协议的远程仓库 URL 是这样的：

https://codeberg.org/eltrac/essayer.git

对应的 SSH 链接就是这样：

ssh://[email protected]/eltrac/essayer.Git

Codeberg（Forgejo）和 GitHub 都支持通过 SSH 连接。

设置远程仓库 URL：

git remote set-url origin [email protected]:eltrac/essayer.git

直接 pull 或者 push 会遇到认证问题，需要配置 SSH 密钥进行认证。在 Codeberg/Forgejo/GitHub 的设置中找到「SSH / GPG keys」，添加自己的 SSH 公钥。¹

接下来要配置本地的 SSH 在连接至 Codeberg/Forgejo/GitHub 时使用相应的密钥进行认证，编辑 SSH 配置文件（macOS 的在 ~/.ssh/config）。

添加这一段配置

Host codeberg.org
    HostName codeberg.org
    User git
    ProxyCommand nc -X 5 -x 127.0.0.1:7890 %h %p
    IdentityFile ~/.ssh/id_ed25519
    TCPKeepAlive yes

根据自己的情况修改 Host、HostName、ProxyCommand 和 IdentityFile。比如，如果你要通过 SSH 连接到 GitHub 而非 Codeberg，就把 codeberg.org 改为 github.com；如果你不使用代理，可以把 ProxyCommand 删掉，如果代理的端口不在 7890，也要手动修改；如果你用来跟远程服务器认证的 SSH 密钥名字不叫 id_ed25519，也请自行修改。

然后尝试 git pull 或者 git push，应该能够正常通过 SSH 连接到远程仓库了。

2026-03-05