MacBook Air 2025（M4）SSH 密钥配置指南#

0️⃣ 前置检查#

1
ssh -V
2
git --version

1️⃣ 生成专用于云效 Codeup 的 Ed25519 密钥对#

💡 建议为每个平台单独生成一套密钥，避免与 GitHub / GitLab 等平台互相干扰。

1
mkdir -p ~/.ssh
2
chmod 700 ~/.ssh
3

4
ssh-keygen -t ed25519 -C "your_email@example.com" -f ~/.ssh/id_ed25519_codeup

出现 passphrase 提示时直接按两次回车留空，后续使用无需输入任何密码：

1
Enter passphrase (empty for no passphrase): ← 直接回车
2
Enter same passphrase again: ← 直接回车

🔒 不设 passphrase 的安全性说明：macOS 本身有登录密码 + FileVault 磁盘加密保护，个人开发机已经够用。

生成结果：

2️⃣ 固定 Codeup 使用该私钥#

创建 / 编辑 ~/.ssh/config：

1
touch ~/.ssh/config
2
chmod 600 ~/.ssh/config

写入（或追加）以下内容：

1
Host codeup.aliyun.com
2
  HostName codeup.aliyun.com
3
  User git
4
  Port 22
5
  IdentityFile ~/.ssh/id_ed25519_codeup

💡 本机有多把密钥时，这一步确保访问 Codeup 时始终使用正确的密钥，不会”随机挑一把”导致认证失败。

3️⃣ 拷贝公钥到剪贴板#

1
tr -d '\n' < ~/.ssh/id_ed25519_codeup.pub | pbcopy

也可直接打开 .pub 文件全选复制，要求从 ssh- 开头一直到邮箱注释结尾完整复制。

4️⃣ 在云效（Codeup）添加 SSH 公钥#

1. 登录 云效
2. 页面右上角头像 → 个人设置
3. 左侧选择 SSH 公钥
4. 粘贴公钥内容，填写标题，设置作用范围（读写 / 只读）与过期时间
5. 点击 添加 保存

5️⃣ 验证 SSH 认证#

1
ssh -v git@codeup.aliyun.com

✅ 成功时会看到认证通过（publickey）及 Welcome to Codeup, <用户名>! 提示。Codeup 不提供 shell 登录，提示后主动断开连接属于正常现象。

6️⃣ 使用 SSH 地址 clone 仓库#

在 Codeup 仓库页面 → 克隆/下载 → 选择 SSH，地址格式如下：

1
git clone git@codeup.aliyun.com:namespace/repo.git

7️⃣ 常见故障快速定位#

📎 参考链接#

• GitHub Docs - 生成新 SSH 密钥并添加到 ssh-agent
• 阿里云 - 在 Codeup 中配置和使用 SSH 密钥
• 阿里云 - 配置 Git 仓库的 SSH 和 HTTPS 认证方式