Skip to content

SSH秘钥管理指南

约 850 字大约 3 分钟

手册其他

2025-05-02

——本地生成密钥对、访问 Linux 服务器及 GitHub


1. 生成 SSH 密钥对(Windows/Linux/macOS)

1.1 生成 RSA 密钥对(建议)

ssh-keygen -t rsa -C "your_email@example.com"
  • -t rsa:指定密钥类型为 RSA。
  • -C "your_email@example.com":注释(可选,用于标识密钥)。

执行后:

  1. 默认保存路径:
    • Windows: C:\Users\<用户名>\.ssh\id_rsa
    • Linux/macOS: ~/.ssh/id_rsa
  2. 建议不设置密码(直接回车两次),否则每次使用 SSH 需输入密码。

Snipaste_2025-05-02_11-37-00

1.2 可选:生成 Ed25519 密钥(更安全)

ssh-keygen -t ed25519 -C "your_email@example.com"
  • Ed25519 比 RSA 更安全且更快,但部分旧系统可能不支持。

2. 配置 SSH 免密登录 Linux 服务器

2.1 将公钥上传到 Linux 服务器

方法 1:使用 ssh-copy-id(推荐)

username:对应远程服务器的用户。

server_ip:对应远程服务器的IP地址。

ssh-copy-id -i ~/.ssh/id_rsa.pub username@server_ip

输入服务器密码后,公钥会自动添加到 ~/.ssh/authorized_keys

方法 2:手动复制(适用于 Windows)

  1. 查看公钥
    cat ~/.ssh/id_rsa.pub
  2. 登录服务器,将公钥追加到 authorized_keys
    mkdir -p ~/.ssh
    echo "粘贴你的公钥" >> ~/.ssh/authorized_keys
    chmod 700 ~/.ssh
    chmod 600 ~/.ssh/authorized_keys

2.2 测试 SSH 登录

username:对应远程服务器的用户。

server_ip:对应远程服务器的IP地址。

ssh username@server_ip

如果服务器使用的不是22端口,则可以使用 -p 端口

ssh username@server_ip -p 10010

如果配置正确,应直接登录,无需密码。


2.3 可选:禁用密码登录(增强安全)

编辑 /etc/ssh/sshd_config

sudo nano /etc/ssh/sshd_config

修改:

PasswordAuthentication no
PubkeyAuthentication yes

重启 SSH 服务:

sudo systemctl restart sshd

3. 使用 SSH 密钥连接 GitHub

3.1 添加公钥到 GitHub

  1. 复制公钥
    cat ~/.ssh/id_rsa.pub
  2. 登录 GitHub → Settings → SSH and GPG keys → New SSH key
    • Title: 自定义名称(如 My Laptop
    • Key: 粘贴 id_rsa.pub 内容

3.2 测试 GitHub 连接

ssh -T git@github.com

成功会显示:

Hi username! You've successfully authenticated...

3.3 使用 SSH 克隆仓库

git clone git@github.com:username/repo.git

(替换 HTTPS 方式,避免每次输入密码)


4. 高级配置(可选)

4.1 管理多个 SSH 密钥

编辑 ~/.ssh/config

# GitHub
Host github.com
    HostName github.com
    User git
    IdentityFile ~/.ssh/id_rsa_github

# 公司服务器
Host company-server
    HostName server_ip
    User deploy
    IdentityFile ~/.ssh/id_rsa_company
  • 使用方式
    ssh company-server  # 代替 ssh deploy@server_ip
    git clone git@github.com:user/repo.git  # 自动使用指定密钥

4.2 密钥加密(增加密码保护)

生成密钥时设置密码:

ssh-keygen -t rsa -C "your_email@example.com"

后续可使用 ssh-add 缓存密码(临时免输入):

eval $(ssh-agent)  # 启动 agent
ssh-add ~/.ssh/id_rsa  # 添加密钥(需输入密码)

5. 常见问题排查

5.1 权限问题

  • .ssh 目录权限必须为 700
    chmod 700 ~/.ssh
  • authorized_keys 权限必须为 600
    chmod 600 ~/.ssh/authorized_keys

5.2 连接失败

  • 检查 SSH 服务状态
    sudo systemctl status sshd
  • 查看详细错误
    ssh -v username@server_ip

5.3 GitHub 认证失败

  • 确认公钥已正确添加
  • 测试连接
    ssh -T git@github.com

6. 总结

场景操作
生成密钥对ssh-keygen -t rsa -b 4096
上传公钥到服务器ssh-copy-id 或手动复制
GitHub SSH 连接添加公钥到 GitHub → 测试 ssh -T
多密钥管理配置 ~/.ssh/config
增强安全性禁用密码登录 + 使用 Ed25519

通过 SSH 密钥认证,可实现:

  • 免密登录 Linux 服务器
  • 安全访问 Git Hub
  • 避免密码泄露风险

建议定期更换密钥(如每年一次),并妥善保管私钥!