ssh配置（代理）

本页定位：在新电脑上配置 GitHub SSH，必要时通过本地代理转发，并用 ssh -T 与一次测试推送验收。GitHub/GitLab 的通用提交流程见代码托管与版本控制；本页只保留 SSH 特有步骤。

1. 安装基础工具

在新电脑上，首先需要安装 Git 客户端。

  • 下载地址：git-scm.com
  • 验证安装：打开 PowerShell，输入 git --version。

2. 生成 SSH 密钥对

SSH 密钥由“私钥”（保存在本地）和“公钥”（上传到 GitHub）组成。

  1. 在 PowerShell 中运行以下命令：
ssh-keygen -t ed25519 -C "你的GitHub注册邮箱"
  1. 操作提示：一路点击回车（Enter）即可，无需设置密码。
  2. 结果：密钥对会生成在 C:\Users\用户名\.ssh\ 目录下。

3. 将公钥添加到 GitHub

  1. 获取公钥内容：在终端运行以下命令并复制输出的长字符串：
Get-Content $env:USERPROFILE\.ssh\id_ed25519.pub
  1. 前往 GitHub：
    • 登录 GitHub，进入 Settings（设置）。
    • 点击左侧栏的 SSH and GPG keys。
    • 点击 New SSH key。
    • Title 随便起（如 "My-New-PC"），Key 粘贴刚才复制的内容，点击 Add SSH key。

4. 配置 SSH 代理 (解决网络连接问题)

在国内网络环境下，SSH 往往需要配合代理软件（如端口为 7897 的 Clash）才能稳定连接。

  1. 创建并编辑 SSH 配置文件：
notepad $env:USERPROFILE\.ssh\config
  1. 在记事本中粘贴以下配置（假设代理端口为 7897）：
Host github.com
  HostName github.com
  User git
  # 关键：通过本地代理端口转发 SSH 流量
  ProxyCommand connect -H 127.0.0.1:7897 %h %p
  1. 保存并关闭。

ProxyCommand connect -H ... 依赖 connect.exe 已安装并在 PATH 中；如果命令不存在，先安装对应工具或改用代理软件提供的 SSH 转发方式，不要把不存在的命令当作 SSH 本身故障。

5. 验证连接状态

在推送代码前，必须先测试隧道是否通畅：

  • 运行命令：ssh -T git@github.com
  • 预期结果：如果看到 Hi [你的用户名]! You've successfully authenticated...，说明配置完全成功。

6. 初始化仓库并上传

对于一个新项目，按照以下标准流程操作：

  1. 本地初始化：PowerShell
git init
git add .
git commit -m "initial commit"
  1. 关联远程地址 (必须使用 SSH 格式)：PowerShell
# 格式为 git@github.com:用户名/仓库名.git
git remote add origin git@github.com:你的用户名/仓库名.git
  1. 推送到 GitHub：PowerShell
git branch -M main
git push -u origin main

💡 Notion 贴士

  • 代码块：在 Notion 中输入 /code 并选择 Bash 或 PowerShell 语言，可以让这些命令显示得更漂亮。
  • 复选框：你可以使用 /todo 为每个步骤创建一个复选框，确保换新电脑时不会漏掉任何环节。
  • 环境说明：考虑到你经常在 MSI Claw 等不同硬件上操作，建议在 Notion 页面顶部标注该配置适用的代理端口（如 7897）。

7. 验证与边界

完成后按“git --version → ssh -T git@github.com → 测试仓库 git push”顺序验收。看到 GitHub 的认证成功提示只证明密钥和隧道可用；仓库权限、分支保护或代理策略仍可能让推送失败，应分别检查。私钥始终留在本机，绝不上传仓库或写入笔记。