+++
date = '2026-03-05T12:41:33+08:00'
draft = false
title = '使用 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://git@codeberg.org/eltrac/essayer.Git
```

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

设置远程仓库 URL：

```shell
git remote set-url origin git@codeberg.org:eltrac/essayer.git
```

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

接下来要配置本地的 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 连接到远程仓库了。

[^1]: 如果没有 SSH 公钥，使用 `ssh-keygen -t ed25519` 生成。