From 42f28ddaac3b196a5d9a41aa0ffadb3a0df798fa Mon Sep 17 00:00:00 2001
From: eltrac <hi@eltr.ac>
Date: Thu, 5 Mar 2026 14:31:49 +0800
Subject: docs: new note

---
 content/notes/ssh-to-git-instead-of-http.md | 54 +++++++++++++++++++++++++++++
 1 file changed, 54 insertions(+)
 create mode 100644 content/notes/ssh-to-git-instead-of-http.md

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` 生成。
-- 
cgit v1.2.3