当前位置：首页 > news >正文

告别密码！用VScode+SSH一键连接树莓派，再也不用每次输密码了

news 2026/5/12 20:55:42

VScode+SSH全自动连接树莓派开发环境配置指南

每次输入SSH密码连接树莓派是否让你感到繁琐？作为开发者，我们追求的是高效与自动化。本文将带你彻底告别手动输入密码的时代，通过VScode与SSH密钥的完美结合，实现一键秒连树莓派的流畅体验。

1. 开发环境准备与基础配置

在开始免密连接配置前，我们需要确保本地和树莓派两端的基础环境已经就绪。首先在本地计算机上安装最新版的VScode，这是我们的主要开发工具。安装完成后，打开扩展市场搜索并安装"Remote - SSH"扩展，这个扩展将为我们提供远程连接的核心功能。

对于树莓派端，确保已经启用SSH服务。可以通过以下命令检查：

sudo systemctl status ssh

如果服务未运行，使用以下命令启用：

sudo systemctl enable --now ssh

提示：现代树莓派系统默认禁用SSH，首次使用时需要在SD卡根目录创建一个名为"ssh"的空文件来启用服务。

2. SSH密钥生成与配置全流程

免密连接的核心在于SSH密钥对的生成与配置。我们将详细讲解这一过程，确保即使是没有相关经验的开发者也能一次成功。

2.1 本地密钥生成

打开本地计算机的命令行工具（Windows用户使用cmd或PowerShell，macOS/Linux用户使用终端），输入以下命令生成密钥对：

ssh-keygen -t rsa -b 4096

执行后会询问保存位置，直接回车使用默认路径即可。接着会提示输入密码短语（passphrase），这里可以留空以实现完全免密，或者设置一个额外的安全层。

生成完成后，在用户目录下的.ssh文件夹中会出现两个关键文件：

id_rsa：私钥文件，必须妥善保管，切勿泄露
id_rsa.pub：公钥文件，将上传到树莓派

2.2 公钥上传与配置

将公钥文件内容添加到树莓派的authorized_keys文件中是免密连接的关键步骤。以下是详细操作流程：

首先确保树莓派上存在.ssh目录和authorized_keys文件。可以通过SSH连接到树莓派后执行：

mkdir -p ~/.ssh touch ~/.ssh/authorized_keys chmod 700 ~/.ssh chmod 600 ~/.ssh/authorized_keys

将本地公钥内容复制到树莓派的authorized_keys文件中。有几种常用方法：
- 使用scp命令直接复制文件：
```
scp ~/.ssh/id_rsa.pub pi@树莓派IP:~/.ssh/authorized_keys
```
- 手动复制粘贴内容（适合不熟悉命令行的用户）
权限设置至关重要，错误的权限会导致免密登录失败。确保：
- .ssh目录权限为700
- authorized_keys文件权限为600
- 用户家目录权限不能过于开放（建议755）

3. VScode远程连接配置优化

有了密钥配置基础后，我们来优化VScode的远程连接体验。打开VScode，按下Ctrl+Shift+P调出命令面板，输入"Remote-SSH: Open Configuration File"，选择你的SSH配置文件（通常是~/.ssh/config）。

在配置文件中添加以下内容：

Host RaspberryPi HostName 树莓派IP地址 User pi IdentityFile ~/.ssh/id_rsa Port 22

配置完成后，VScode左侧的远程资源管理器会显示你的树莓派设备。点击连接，如果一切配置正确，将直接进入远程环境而无需输入密码。

注意：首次连接时可能会提示确认主机密钥，选择"Continue"即可。这是SSH的安全特性，用于防止中间人攻击。

4. 常见问题排查与解决方案

即使按照步骤操作，有时仍可能遇到连接问题。以下是几个常见问题及其解决方法：

4.1 连接被拒绝或超时

检查树莓派IP地址是否正确
确认树莓派和本地计算机在同一网络
验证树莓派SSH服务是否正常运行
检查防火墙设置，确保22端口未被阻止

4.2 仍需输入密码

确认公钥已正确添加到树莓派的authorized_keys文件中
检查文件权限设置是否正确
查看SSH连接日志获取详细错误信息：
```
ssh -v pi@树莓派IP
```

4.3 连接缓慢

SSH连接缓慢可能是DNS解析问题导致，可以尝试在SSH配置中添加：

Host RaspberryPi ... GSSAPIAuthentication no StrictHostKeyChecking no UserKnownHostsFile /dev/null

5. 高级功能扩展：图形界面与文件传输

基础连接配置完成后，我们可以进一步扩展开发环境的功能性。通过X11转发和SFTP集成，实现完整的远程开发体验。

5.1 图形界面支持

要在本地显示树莓派的图形界面，需要配置X11转发：

在树莓派上安装必要的X11组件：

sudo apt install xauth x11-apps

修改SSH配置，启用X11转发：

Host RaspberryPi ... ForwardX11 yes ForwardX11Trusted yes

连接后测试图形功能：

xclock

5.2 无缝文件传输

VScode的Remote - SSH扩展已经内置了文件管理功能。此外，可以安装"SFTP"扩展实现更强大的文件同步能力。配置示例：

{ "name": "RaspberryPi", "host": "树莓派IP", "protocol": "sftp", "port": 22, "username": "pi", "privateKeyPath": "C:/Users/用户名/.ssh/id_rsa", "remotePath": "/home/pi/projects", "uploadOnSave": true }

6. 安全增强与最佳实践

虽然免密连接带来了便利，但安全 considerations 同样重要。以下是几个提升SSH安全性的建议：

禁用密码登录（配置免密连接后）：在树莓派上编辑/etc/ssh/sshd_config：
```
PasswordAuthentication no
```
然后重启SSH服务：
```
sudo systemctl restart ssh
```
更改默认SSH端口：修改sshd_config中的Port指令，使用非标准端口（如2222）
定期轮换密钥：每隔一段时间生成新的密钥对并更新authorized_keys文件
使用强密码保护私钥：虽然本文演示了完全免密，但在生产环境中建议为密钥设置密码短语

在实际项目中使用这套配置几个月后，我发现最常遇到的问题往往是权限设置不正确。特别是在多用户环境下，确保.ssh目录和密钥文件的权限严格符合要求可以避免大部分连接问题。另一个实用技巧是在VScode中保存多个SSH配置，方便快速切换不同的开发环境。

查看全文

http://www.jsqmd.com/news/515531/