SSH Connection

一、先把树莓派 SSH 打开（必须做）

新系统默认关闭 SSH，必须手动开。下面三种方法，选一种最方便的。

方法 A：还没烧系统 / 准备重刷（最推荐，无显示器）

1. 电脑安装 Raspberry Pi Imager（官网下载）：https://www.raspberrypi.org/downloads/raspbian/

2. 选择系统 → 选中SD卡 → 点击右下角【齿轮（设置）】

2.1 进入 Remote Access 配置项

• 勾选 Enable SSH
• 选择 Use password authentication（密码登录，小白首选）

2.2 再进入 Set username and password

• 用户名：自定义，示例：pi
• 密码：自行设置并妥善保存（务必记住！）

3. 确认配置后写入SD卡 → SD卡插入树莓派 → 通电上电。 开机后SSH自动启用，电脑局域网内可直接SSH连接。

方法 B：已经有系统、有显示器键盘

1. 树莓派桌面点左上角菜单 → Preferences → Raspberry Pi Configuration
2. 切到 Interfaces → 把 SSH 设为 Enabled
3. 点 OK → 重启（会提示）。

方法 C：已经有系统、无显示器（用 SD 卡开 SSH）

适用场景：树莓派已经烧好系统 SD 卡、没有显示屏、没有键盘鼠标，只用电脑 + SD 读卡器开启远程 SSH 连接。

步骤 1：把 SD 卡从树莓派拔下，插到电脑上

1. 先把树莓派断电关机，拔出机身里的 SD 小存储卡；
2. SD 卡装进读卡器，读卡器插在 Windows 电脑 USB 口上，电脑会弹出新的磁盘分区。

步骤 2：找到 boot 启动分区（关键：能看见 config.txt 文件的盘）

1. 打开电脑「此电脑」，找到新出现的磁盘盘符（比如 D 盘 / E 盘，名字一般是boot）；
2. 点开这个盘，只要里面能看到config.txt这个文件，就是找对分区了；

❌ 误区：不要进容量很大的另一个分区（ext 格式 Windows 打不开不用管）。

步骤 3：新建空白文件，严格命名为【ssh】（重中之重，最容易出错）

ssh

1. 在boot盘空白处右键→新建→文本文档，生成新建文本文档.txt；
2. 修改文件名：删掉全部名字 + 后缀.txt，只输入小写字母：ssh
   • ✅ 正确：文件名只有 ssh，没有任何后缀、没有.txt
   • ❌ 错误：ssh.txt、SSH、ssh.doc 全都不行
3. 文件不用打开写任何内容，里面保持空白，直接保存关闭。

Windows 默认隐藏后缀处理：电脑顶部查看→勾选【文件扩展名】，能看见.txt 后缀再改名。

步骤 4：安全弹出 SD 卡，装回树莓派开机

1. 电脑右下角右键 SD 磁盘→安全删除硬件，拔出读卡器里的 SD 卡；
2. SD 卡插回树莓派卡槽，给树莓派插上电源通电开机；
3. 树莓派启动后系统自动识别ssh空文件，自动打开 SSH 远程服务。

补充常见问题（客户高频踩坑备注）

1. 改名后还是带.txt：就是电脑没打开「显示文件扩展名」，一定要先开扩展名再改名；
2. 找不到 boot 盘：确认 SD 卡插好，系统镜像正常烧录；
3. 开机连不上 SSH：确认文件名称无误，树莓派和电脑连同一个路由器局域网。

---

二、找到树莓派的 IP 地址（关键）

树莓派要和电脑连同一个路由器 / WiFi。

情况 1：树莓派有显示器

打开终端，输入：

hostname -I

会显示类似：

192.168.3.14

这个就是 IP，记下来。

情况 2：无显示器（Windows 找 IP）

1. 下载 Advanced IP Scanner（免费）
2. 打开 → 点 Scan
3. 找名字含 raspberrypi、或厂商是 Raspberry Pi 的那一行，IP 就是它。

情况 3：无显示器（手机找 IP）

手机连同一个 WiFi，装 Fing → 扫描设备 → 找 raspberrypi。

---

三、电脑连接 SSH（Windows /macOS）

Windows 10/11（自带 SSH，不用装软件）

1. 按 Win + R → 输入 powershell → 回车
2. 输入命令：

ssh 用户名@树莓派IP

例如：

ssh pi@192.168.3.14

1. 第一次连接会问：

Are you sure you want to continue connecting (yes/no)?

输入 yes → 回车 4. 输入你之前设置的树莓派密码（输入时屏幕不显示，正常）

→ 回车，成功进入树莓派！

Windows 7 / 想用图形工具（PuTTY）

1. 下载 PuTTY
2. 打开 → Host Name 填：用户名@IP 或直接填 IP
3. Port：22 → 点 Open
4. 选 yes → 输入用户名密码。

macOS / Linux

直接打开「终端」，输入：

ssh 用户名@树莓派IP

后续和 Windows 一样。

---

四、常用命令（小白够用）

# 看当前目录
 pwd
 # 列出文件
 ls
 # 新建文件夹
 mkdir test
 # 进入文件夹
 cd test
 # 返回上一级
 cd ..
 # 关机
 sudo shutdown now
 # 重启
 sudo reboot

---

五、常见错误（直接对照解决）

1. Connection refused → SSH 没开！回到第一步重新开 SSH，重启树莓派。
2. Connection timed out

• 树莓派和电脑不在同一个 WiFi / 路由器
• IP 写错
• 网线没插好（有线的情况）

1. Permission denied, please try again → 用户名或密码输错！回想你在 Imager 里设的账号密码。