173 lines
3.2 KiB
Markdown
173 lines
3.2 KiB
Markdown
# 配置ssh密钥快速指南
|
||
|
||
配置密钥可以实现快速登录就是了
|
||
|
||
# 快速指南：生成 SSH 密钥对用于 Git
|
||
|
||
## 1. 检查现有 SSH 密钥
|
||
|
||
### Linux / macOS
|
||
|
||
```bash
|
||
ls -al ~/.ssh
|
||
```
|
||
|
||
### Windows（PowerShell / Git Bash）
|
||
|
||
```powershell
|
||
# PowerShell
|
||
Get-ChildItem -Path $env:USERPROFILE\.ssh
|
||
# Git Bash
|
||
ls -al /c/Users/YourUserName/.ssh
|
||
```
|
||
|
||
常见文件：
|
||
|
||
- `id_rsa` / `id_rsa.pub`（RSA 密钥对）
|
||
- `id_ed25519` / `id_ed25519.pub`（ED25519 密钥对）
|
||
|
||
> ⚠️ 注意：如果已有密钥且希望复用，可跳过生成步骤。
|
||
|
||
---
|
||
|
||
## 2. 生成新的 SSH 密钥对
|
||
|
||
### 2.1 使用 ED25519（推荐，安全且快速）
|
||
|
||
### Linux / macOS
|
||
|
||
```bash
|
||
ssh-keygen -t ed25519 -C "your_email@example.com"
|
||
```
|
||
|
||
### Windows（PowerShell / Git Bash）
|
||
|
||
```powershell
|
||
# Git Bash / PowerShell
|
||
ssh-keygen -t ed25519 -C "your_email@example.com"
|
||
```
|
||
|
||
- `-C` 用于添加备注（通常填写邮箱）
|
||
- 系统会提示：
|
||
- **文件名**（默认 `~/.ssh/id_ed25519` 或 `C:\Users\YourUserName\.ssh\id_ed25519`）
|
||
- **密码短语**（可选，用于额外保护私钥）
|
||
|
||
### 2.2 使用 RSA（兼容性更好，但略旧）
|
||
|
||
### Linux / macOS
|
||
|
||
```bash
|
||
ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
|
||
```
|
||
|
||
### Windows（PowerShell / Git Bash）
|
||
|
||
```powershell
|
||
ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
|
||
```
|
||
|
||
- `-b 4096` 指定密钥长度，推荐 4096 位
|
||
|
||
---
|
||
|
||
## 3. 添加 SSH 私钥到 SSH Agent
|
||
|
||
### Linux / macOS
|
||
|
||
1. 启动 ssh-agent：
|
||
|
||
```bash
|
||
eval "$(ssh-agent -s)"
|
||
```
|
||
|
||
2. 添加私钥：
|
||
|
||
```bash
|
||
ssh-add ~/.ssh/id_ed25519
|
||
# 或者 RSA 私钥
|
||
ssh-add ~/.ssh/id_rsa
|
||
```
|
||
|
||
### Windows（PowerShell / Git Bash）
|
||
|
||
1. 启动 ssh-agent 服务：
|
||
|
||
```powershell
|
||
# PowerShell
|
||
Start-Service ssh-agent
|
||
|
||
# 设置为开机自启（可选）
|
||
Set-Service -Name ssh-agent -StartupType Automatic
|
||
```
|
||
|
||
2. 添加私钥：
|
||
|
||
```powershell
|
||
ssh-add C:\Users\YourUserName\.ssh\id_ed25519
|
||
# 或者 RSA 私钥
|
||
ssh-add C:\Users\YourUserName\.ssh\id_rsa
|
||
```
|
||
|
||
> 🔑 如果你设置了密码短语，需要在此步骤输入一次。
|
||
|
||
---
|
||
|
||
## 4. 将公钥添加到 Git 账号
|
||
|
||
### Linux / macOS
|
||
|
||
```bash
|
||
cat ~/.ssh/id_ed25519.pub
|
||
```
|
||
|
||
### Windows（PowerShell / Git Bash）
|
||
|
||
```powershell
|
||
# PowerShell
|
||
Get-Content C:\Users\YourUserName\.ssh\id_ed25519.pub
|
||
# Git Bash
|
||
cat /c/Users/YourUserName/.ssh/id_ed25519.pub
|
||
```
|
||
|
||
然后登录 Git 平台（GitHub、GitLab、Gitee 等）添加公钥。
|
||
|
||
---
|
||
|
||
## 5. 测试连接
|
||
|
||
### Linux / macOS / Windows
|
||
|
||
```bash
|
||
ssh -T git@github.com
|
||
```
|
||
|
||
- 第一次连接可能提示是否继续，输入 `yes`
|
||
- 成功提示示例：
|
||
|
||
```
|
||
Hi username! You've successfully authenticated, but GitHub does not provide shell access.
|
||
```
|
||
|
||
---
|
||
|
||
## 6. 配置 Git 使用 SSH
|
||
|
||
### Linux / macOS / Windows
|
||
|
||
```bash
|
||
git config --global user.name "Your Name"
|
||
git config --global user.email "your_email@example.com"
|
||
git remote set-url origin git@github.com:username/repo.git
|
||
```
|
||
|
||
- 确保远程仓库使用 **SSH 地址** 而不是 HTTPS
|
||
|
||
---
|
||
|
||
## ✅ 小贴士
|
||
|
||
- **ED25519 优先**：更安全、更短更快
|
||
- **私钥妥善保管**：不要上传到任何平台
|
||
- **不同机器不同密钥**：每台设备建议生成独立密钥
|
||
- **密码短语保护**：防止密钥泄露被直接使用
|