diff options
| -rw-r--r-- | content/notes/ssh-to-git-instead-of-http.md | 54 |
1 files changed, 54 insertions, 0 deletions
diff --git a/content/notes/ssh-to-git-instead-of-http.md b/content/notes/ssh-to-git-instead-of-http.md new file mode 100644 index 0000000..7222b79 --- /dev/null +++ b/content/notes/ssh-to-git-instead-of-http.md @@ -0,0 +1,54 @@ ++++ +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` 生成。 |