前言
作为开发者，我们经常需要在本地使用Cursor编辑器连接远程服务器进行开发。每次输入密码不仅繁琐，还存在安全隐患。本文将详细介绍如何配置SSH免密登录，让你的Cursor能够安全、便捷地连接远程服务器。
什么是SSH免密登录？
SSH免密登录基于非对称加密技术，通过公钥私钥对进行身份验证：
私钥：保存在本地，用于签名验证身份
公钥：存储在服务器，用于验证签名
原理：客户端用私钥对随机挑战进行签名，服务器用公钥验证签名有效性
这种方式比密码更安全，因为私钥从不离开你的本地机器。
环境说明
客户端：Windows 10/11，Cursor编辑器
服务器：CentOS 7，IP：XXX.XXX.XXX.XXX
用户：XXXX
配置步骤
1. 生成SSH密钥对（如果没有）
在本地Windows PowerShell中：
ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
按回车使用默认路径：C:\Users\用户名\.ssh\id_rsa
可以设置密码短语（推荐）
2. 配置SSH客户端
编辑本地SSH配置文件 C:\Users\用户名\.ssh\config：
Host 252XXXX
HostName XXX.XXX.XXX.XXX
User XXXX
Port 22
ServerAliveInterval 60
ServerAliveCountMax 3
TCPKeepAlive yes
IdentityFile C:\Users\XXXXX\.ssh\id_rsa
3. 将公钥添加到服务器
查看本地公钥：
type C:\Users\用户名\.ssh\id_rsa.pub
将输出的公钥内容添加到服务器的 ~/.ssh/authorized_keys 文件中。
4. 测试连接
ssh XXXX
如果一切正常，应该能直接登录而不需要密码。
常见问题及解决方案
问题1：仍然要求输入密码
症状：配置完成后，SSH连接仍然要求输入密码
诊断方法：
ssh -v XXXX
查看详细日志，重点关注：
debug1: Offering public key:
debug1: Server accepts key: 或拒绝信息
可能原因及解决方案：
原因1：公钥格式错误
检查服务器上的公钥是否正确：
cat ~/.ssh/authorized_keys
原因2：文件权限问题
SSH对文件权限要求严格：
# 检查权限
ls -la ~/.ssh/
ls -ld ~
# 修复权限
chmod 700 ~/.ssh
chmod 600 ~/.ssh/authorized_keys
chmod g-w ~ # 重要！移除home目录的组写权限
关键点：home目录不能有组写权限，否则SSH会拒绝公钥认证！
原因3：SELinux安全上下文问题
在启用SELinux的系统中，文件需要正确的安全上下文：
# 检查SELinux状态
getenforce
# 修复安全上下文
restorecon -R ~/.ssh/
# 验证上下文
ls -Z ~/.ssh/authorized_keys
正确的上下文应该包含 ssh_home_t 类型。
问题2：Cursor无法连接
确保Cursor使用正确的SSH配置：
按 Ctrl+Shift+P
选择 "Remote-SSH: Connect to Host"
选择配置的主机名（如 252XXXX）
Cursor会自动读取SSH配置文件并使用对应的私钥。
安全最佳实践
1. 私钥安全
私钥文件设置强密码短语
定期轮换密钥对
备份私钥到安全位置
2. 服务器配置
编辑 /etc/ssh/sshd_config：
# 启用公钥认证
PubkeyAuthentication yes
# 可选：禁用密码登录（确认密钥登录正常后）
PasswordAuthentication no
# 限制root登录
PermitRootLogin no
3. 网络安全
使用非标准SSH端口
配置防火墙限制SSH访问
启用fail2ban防止暴力破解
原理深入解析
非对称加密验证流程
1. 客户端发起连接请求
2. 服务器发送随机挑战数据
3. 客户端用私钥对挑战进行数字签名
4. 服务器用公钥验证签名
5. 验证通过则建立连接
SELinux的作用
SELinux提供强制访问控制（MAC），为SSH文件分配特定的安全上下文：
unconfined_u:object_r:ssh_home_t:s0
↓ ↓ ↓ ↓
用户类型 角色类型 文件类型 安全级别
只有具有适当权限的进程才能访问 ssh_home_t 类型的文件，提供额外的安全保护。
总结
SSH免密登录配置看似简单，但细节决定成败。本文遇到的主要问题：
公钥格式错误：缺少 's' 字符
文件权限问题：home目录组写权限
SELinux上下文：安全标签不正确
通过系统性的诊断和修复，最终实现了Cursor与远程服务器的免密连接。这不仅提高了开发效率，也增强了连接安全性。
记住：安全配置无小事，每个细节都可能影响最终结果。希望这篇文章能帮助你顺利配置SSH免密登录，享受更高效的远程开发体验！
