# SSH远程终端

***Copyright © Quectel Wireless Solutions Co., Ltd. 2026. All rights reserved.***

---

**SSH（安全外壳协议，Secure Shell Protocol）** 是一种加密网络协议，用于在不安全的网络（如互联网）上安全地远程访问和管理计算机。它通过在客户端和服务器之间建立 **加密隧道** 来保护通信安全，防止窃听和篡改。

> **前提条件：设备已通过有线或Wi-Fi连接网络，Quectel Pi H1智能主控板会自动通过DHCP协议获取IP地址。**

**系统默认禁用SSH服务器。可通过以下任一方式启用SSH。**

# 在智能主控板桌面上操作

## **在系统应用中打开终端**

```{image} images/image_VBm8b4xLWodgknxVDvyctxvPnjL.webp
:width: 1674px
:height: 939px
```

## **安装ssh-server服务**

```bash
sudo apt install openssh-server
```

- 若遇到如下提示，请输入“**Y+Enter**”。

```{image} images/image_MM7HbvBltodarsxxcQvcYCPDnAe.webp
:width: 957px
:height: 634px
```

- 后续若出现其他选项，直接按 *Enter* 即可。

```{image} images/image_Lda9b6SAVoghBLxkAYScsTjDnFg.webp
:width: 727px
:height: 465px
```

## **启动ssh-server服务**

```bash
# 使能开启自启动
sudo systemctl enable ssh
# 开启服务
sudo systemctl start ssh
# 查看服务状态
sudo systemctl status ssh
```

若服务状态显示为“active (running)”，则表示服务已成功启动，可继续下一步。

```{image} images/image_AzUXbtK6joJ6O4xm4uLcRF7Gnoh.webp
:width: 734px
:height: 483px
```

## **获取Quectel Pi H1的IP地址**

在终端输入 *ip address* 命令，查看Quectel Pi H1的 **IP地址**。

```{image} images/image_HFNNbr0OooYDCCxpK6oc2pJsn9f.webp
:width: 732px
:height: 480px
```

## **配置SSH登录**

在Windows控制台输入以下命令。连接过程中需要输入“**Yes**”确认连接。

```bash
ssh <username>@<ip-address># 示例ssh pi@192.168.2.xxx  
```

```{image} images/image_P6yEbHVYOombkzx87ikcIxFMnfh.webp
:width: 977px
:height: 393px
```

# 在串口控制台上操作

## 登录串口控制台

打开PuTTY，配置USB串口参数，点击“**Open**”连接。

```{image} images/image_IHhcbOkSdoOEpNxjZBUcUy59nAf.webp
:width: 528px
:height: 520px
```

## **安装ssh-server服务**

```bash
sudo apt install openssh-server
```

- 若提示“**Continue? [Y/n]**”，按“**y+Enter**”。

- 后续其他选项直接按 *回车键* 即可。

## **启动ssh-server服务**

```bash
# 使能开启自启动
sudo systemctl enable ssh
# 开启服务
sudo systemctl start ssh
# 查看服务状态
sudo systemctl status ssh
```

若服务状态显示为“active (running)”，则表示服务已成功启动，可继续下一步。

```{image} images/image_RcGQbL2Cko7ZSNxRCcWcj8lindb.webp
:width: 661px
:height: 418px
```

## **获取Quectel Pi H1的IP地址**

在串口控制台输入 *ip address* 命令，查看Quectel Pi H1的 **IP地址**。

```{image} images/image_VFstbWg0fox56exFYm5cYzy8nNW.webp
:width: 661px
:height: 418px
```

## **配置SSH登录**

重新打开PuTTY，勾选“**SSH**”并输入Quectel Pi H1的 **IP地址**，然后点击“**Open**”。

```{image} images/image_KkyBbYCEroA9yfx57j4cDdRAnUf.webp
:width: 441px
:height: 437px
```

登录时使用的用户名及密码设置，请参考系统登录章节。