网络配置与 SSH

本文档介绍 shimetapi RK3588 开发板在 Linux 系统下的网络配置方法，包括有线网络（以太网）的静态 IP 和 DHCP 配置、SSH 远程登录与文件传输，以及网络性能测试工具的使用。

适用范围： shimetapi RK3588 开发板（C-3588LQ V1.0 核心板 + SHIMETAPI-M5-R2A V1.0 底板）的网络功能配置。 接口名说明： 本文以 Debian 镜像的 end1 为例；Ubuntu 镜像的千兆网口名为 eth0（另有 eth1），操作时替换即可，详见Debian 与 Ubuntu 镜像差异。

1. 准备工作

1.1 硬件清单

组件型号/规格数量备注
主控板C-3588LQ 核心板 + SHIMETAPI-M5-R2A 底板1已烧录 Linux 系统
网线标准 RJ45 网线1有线网络使用
路由器/交换机支持 DHCP1网络接入设备
WiFi 天线2.4G/5G 天线1WiFi 模块使用（如已装配）
电脑Windows/Linux/Mac1用于 SSH 连接

1.2 硬件连接

  • 有线网络：将网线一端插入开发板 RJ45 网口（J3），另一端接入路由器或交换机
  • WiFi 网络：WiFi 模块为可选配置，如已装配 RTL8821CS 等模块需连接天线

底板以太网口为 J3，千兆以太网（GMAC1），详见核心板规格书。 WiFi 模块为可选配置，具体型号见底板原理图 PDF 第 17 页（Sheet 18/21）。

1.3 必须知道：开发板网络接口名

注意：出厂镜像采用 systemd 可预测接口命名（根据网卡物理位置自动命名，而不是传统的 eth0），有线网卡名称是 end1（GMAC1）。 本文出现的所有 eth0 占位符，请替换为实际接口名（默认 end1）。

通过串口或 ADB 登录后，执行：

ip link show

输出：

1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue state UNKNOWN mode DEFAULT group default qlen 1000
    link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
2: dummy0: <BROADCAST,NOARP> mtu 1500 qdisc noop state DOWN mode DEFAULT group default qlen 1000
    link/ether d6:f8:bb:c8:a8:9c brd ff:ff:ff:ff:ff:ff
3: end1: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc mq state UP mode DEFAULT group default qlen 1000
    link/ether fa:fc:7b:12:bc:96 brd ff:ff:ff:ff:ff:ff permaddr 42:46:d0:aa:1a:fa
4: enP2p33s0: <NO-CARRIER,BROADCAST,MULTICAST,UP> mtu 1500 qdisc mq state DOWN mode DEFAULT group default qlen 1000
    link/ether fa:fc:7b:12:bc:94 brd ff:ff:ff:ff:ff:ff permaddr 00:55:7b:b5:7d:f7

接口说明：

接口用途本机状态
lo本地回环始终 UP
end1GMAC1 千兆有线网卡UP（接网线时）
enP2p33s0GMAC 第 2 个以太网口（备用）DOWN（未使能）
dummy0占位接口-
wlan0WiFi 无线网卡（如底板配 WiFi 模块）通常未装配

1.4 确认网络管理工具

systemctl status NetworkManager

输出：

● NetworkManager.service - Network Manager
     Loaded: loaded (/lib/systemd/system/NetworkManager.service; enabled; preset: enabled)
     Active: active (running) since Mon 2026-04-27 19:48:56 UTC; ...
       Docs: man:NetworkManager(8)
   Main PID: 1236 (NetworkManager)
      Memory: 16.0M

4月 27 19:49:15 linaro-alip NetworkManager[1236]: dhcp4 (end1): state changed new lease, address=192.168.49.60
4月 27 19:49:15 linaro-alip NetworkManager[1236]: policy: set '有线连接 2' (end1) as default for IPv4 routing and DNS

出厂镜像默认使用 NetworkManager 管理网络，配置命令是 nmcli。 若系统未启用 NetworkManager，可改用 netplan 或 systemd-networkd（本机无需）。

2. 即插即用：DHCP 自动获取 IP

最常见的场景：插上网线后，路由器会通过 DHCP（动态主机配置协议，一种自动分配 IP 地址的机制）给开发板分配 IP。用下面的命令确认拿到的是什么地址。

2.1 插上网线并查看 IP

ip addr show end1

输出（DHCP 已获取）：

3: end1: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc mq state UP group default qlen 1000
    link/ether fa:fc:7b:12:bc:96 brd ff:ff:ff:ff:ff:ff
    inet 192.168.49.60/24 brd 192.168.49.255 scope global dynamic noprefixroute end1
       valid_lft 86338sec preferred_lft 86338sec

查看完整路由：

ip route show

输出：

default via 192.168.49.1 dev end1 proto dhcp src 192.168.49.60 metric 100
192.168.49.0/24 dev end1 proto kernel scope link src 192.168.49.60 metric 100

2.2 验证连通性

# 网关
ping -c 4 192.168.49.1

# 外网 IP
ping -c 4 8.8.8.8

# DNS 解析
ping -c 4 www.baidu.com

输出（关键行）：

$ ping -c 4 192.168.49.1
4 packets transmitted, 4 received, 0% packet loss, time 3004ms
rtt min/avg/max/mdev = 0.810/0.917/1.255/0.069 ms

$ ping -c 2 8.8.8.8
2 packets transmitted, 2 received, 0% packet loss
（平均延迟 ≈ 163ms）

$ ping -c 2 www.baidu.com
64 bytes from 103.235.47.188 (103.235.47.188): time=311.134 ms
2 packets transmitted, 2 received, 0% packet loss

网关 1ms 内响应、外网 ~160ms、DNS 解析正常，即代表网络可用。

3. 配置静态 IP

如果路由器不开 DHCP，或需要固定 IP 地址。

3.1 方法一：使用 NetworkManager（推荐）

查看当前所有连接配置：

nmcli connection show

输出：

NAME        UUID                                  TYPE      DEVICE
有线连接 2  42c7b20e-55dc-3d21-b6a6-28e482f0eab4  ethernet  end1
lo          5d01ded6-9f14-4784-8b55-7bbe207c522d  loopback  lo
有线连接 1  c910abd8-2f1a-3a8c-98c4-db3d4d177b6b  ethernet  --

当前 end1 绑定的是 "有线连接 2"，不是"有线连接 1"。"有线连接 1"未绑定设备（空 DEVICE）。 如要修改实际生效的连接，请使用连接名 有线连接 2 而非 有线连接 1。

把 end1 的连接改成静态 IP（连接名以 nmcli connection show 实际显示为准）：

nmcli connection modify "有线连接 2" \
    ipv4.method manual \
    ipv4.addresses 192.168.49.200/24 \
    ipv4.gateway 192.168.49.1 \
    ipv4.dns "8.8.8.8 114.114.114.114"

# 应用变更
nmcli connection down "有线连接 2"
nmcli connection up "有线连接 2"

查当前详细状态：

nmcli device show end1

输出（DHCP 模式下）：

GENERAL.DEVICE:                         end1
GENERAL.TYPE:                           ethernet
GENERAL.HWADDR:                         FA:FC:7B:12:BC:96
GENERAL.MTU:                            1500
GENERAL.STATE:                          100（已连接）
GENERAL.CONNECTION:                     有线连接 2
IP4.ADDRESS[1]:                         192.168.49.60/24
IP4.GATEWAY:                            192.168.49.1
IP4.ROUTE[1]:                           dst = 192.168.49.0/24, nh = 0.0.0.0, mt = 100
IP4.ROUTE[2]:                           dst = 0.0.0.0/0, nh = 192.168.49.1, mt = 100
IP4.DNS[1]:                             202.96.134.133
IP4.DNS[2]:                             202.96.128.166

DHCP 模式下，自动获得的 DNS 是运营商（ISP）分配的（本机为中国电信 202.96.134.133 / 202.96.128.166，地区：深圳）。 切到 manual 时会以 modify 命令中的 dns 字段为准。

3.2 方法二：编辑 interfaces 文件（仅作参考）

当系统使用 NetworkManager（出厂镜像默认）时，/etc/network/interfaces 的配置可能被忽略。 推荐优先使用 §3.1 的 nmcli 方法。

vi /etc/network/interfaces

示例内容（将 eth0 替换为实际接口名）：

auto eth0
iface eth0 inet static
    address 192.168.49.200
    netmask 255.255.255.0
    gateway 192.168.49.1
    dns-nameservers 8.8.8.8 114.114.114.114

重启网络服务：

systemctl restart networking

3.3 验证

ip addr show end1    # 应显示修改后的静态 IP
ping -c 4 192.168.49.1

4. SSH 服务配置

4.1 检查与启动 SSH

查 SSH 服务状态：

systemctl status ssh

Debian 12 / OpenSSH 9.x 默认服务名是 ssh.service（不是 sshd.service）。 配置文件路径仍为 /etc/ssh/sshd_config。

如未安装：

apt update
apt install -y openssh-server

启动 + 开机自启：

systemctl start ssh
systemctl enable ssh

4.2 安全配置（推荐）

编辑配置文件：

vi /etc/ssh/sshd_config

常用配置项：

配置项推荐值说明
Port22SSH 端口（可改为非标准端口增强安全）
PermitRootLoginprohibit-password禁止 root 密码登录（建议使用密钥登录）
PasswordAuthenticationyes允许密码认证（开发环境可开启）
PubkeyAuthenticationyes允许密钥认证

出厂镜像的 /etc/ssh/sshd_config 关键参数（Port / PermitRootLogin / PasswordAuthentication）默认是注释掉的，即使用默认值（Port=22、PermitRootLogin=yes）。 如需禁用 root 密码登录，仅密钥可登，请手动添加并取消注释。

修改后重启：

systemctl restart ssh

4.3 SSH 密钥登录（更安全）

[电脑端] 生成密钥对：

ssh-keygen -t rsa -b 4096

[电脑端] 把公钥复制到开发板（推荐）：

ssh-copy-id root@192.168.49.60

或手动复制：

cat ~/.ssh/id_rsa.pub | ssh root@192.168.49.60 "mkdir -p ~/.ssh && cat >> ~/.ssh/authorized_keys"

5. 文件传输与 WiFi

5.1 SCP 文件传输（基于 SSH）

[电脑端] 上传（PC → 开发板）：

scp ./myfile.txt root@192.168.49.60:/root/
scp -r ./myfolder/ root@192.168.49.60:/root/

[电脑端] 下载（开发板 → PC）：

scp root@192.168.49.60:/root/myfile.txt ./
scp -r root@192.168.49.60:/root/myfolder/ ./

常用参数：

参数说明
-r递归传输目录
-P 2222指定端口（大写 P，SSH 端口非默认时使用）
-C启用压缩传输
-i ~/.ssh/id_rsa指定私钥文件

5.2 WiFi 连接

状态说明： 出厂镜像默认未装配 WiFi 模块，本机 nmcli dev wifi list 不可用。 如底板已焊接 RTL8821CS 等模块，需先接天线再使用。

使用 nmcli 连接：

# 扫描可用 WiFi
nmcli dev wifi list

# 连接（会提示输入密码）
nmcli device wifi connect "你的SSID" password "你的密码"

# 查看活动连接
nmcli connection show --active

# 设静态 IP（可选）
nmcli connection modify "你的SSID" \
    ipv4.method manual \
    ipv4.addresses 192.168.49.210/24 \
    ipv4.gateway 192.168.49.1 \
    ipv4.dns "8.8.8.8 114.114.114.114"
nmcli connection down "你的SSID"
nmcli connection up   "你的SSID"

无 NetworkManager 时使用 wpa_supplicant：

wpa_passphrase "你的SSID" "你的密码" > /etc/wpa_supplicant/wpa_supplicant.conf
wpa_supplicant -B -i wlan0 -c /etc/wpa_supplicant/wpa_supplicant.conf
dhclient wlan0

6. 网络性能测试（iperf）

iperf 是一款网络带宽测试工具，用来测试开发板与电脑之间的网络吞吐量。

6.1 版本选择

注意：Debian 12 出厂镜像默认安装的是 iperf v2（命令为 iperf），而不是 iperf3。 测试两端必须使用同一版本，否则无法通信。

查看当前安装版本：

iperf --version

输出：

iperf version 2.1.8 (12 August 2022) pthreads

如需 iperf3：

apt install -y iperf3    # 装上后两侧都用 iperf3

6.2 上行带宽测试（开发板为客户端）

[电脑端] 启动服务端：

iperf -s

客户端连接（开发板 IP = 192.168.49.60，电脑 IP 示例 = 192.168.49.50）：

iperf -c 192.168.49.50 -t 30

将 IP 替换为电脑的实际地址，-t 30 表示测试持续 30 秒。

6.3 下行带宽测试（开发板为服务端）

iperf -s

[电脑端]：

iperf -c 192.168.49.60 -t 30

6.4 结果解读

iperf v2 输出格式：

[  5] local 192.168.49.50 port 5001 connected with 192.168.49.60 port 5001
[ ID] Interval       Transfer     Bandwidth
[  5]  0.0-30.0 sec   345 MBytes  96.5 Mbits/sec

RK3588 配备千兆以太网（GMAC1），理论带宽 ~1000Mbps。实际受网线质量、路由器转发能力、CPU 负载等因素影响。

7. 验证

7.1 网络连通性

ip addr show end1

输出：

3: end1: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc mq state UP group default qlen 1000
    link/ether fa:fc:7b:12:bc:96 brd ff:ff:ff:ff:ff:ff
    inet 192.168.49.60/24 brd 192.168.49.255 scope global dynamic noprefixroute end1
       valid_lft 85520sec preferred_lft 85520sec
ping -c 4 8.8.8.8

输出：

64 bytes from 8.8.8.8: icmp_seq=1 ttl=103 time=163 ms
64 bytes from 8.8.8.8: icmp_seq=2 ttl=103 time=163 ms
64 bytes from 8.8.8.8: icmp_seq=3 ttl=103 time=164 ms
64 bytes from 8.8.8.8: icmp_seq=4 ttl=103 time=163 ms
4 packets transmitted, 4 received, 0% packet loss, time 3000ms

7.2 SSH 连接

[电脑端]：

ssh root@192.168.49.60

成功标志：直接进入开发板 shell 提示符，不需要输入密码（默认 root 无密码 / 出厂镜像允许 PermitRootLogin yes）。

7.3 网络性能

[电脑端] 先启动服务端，再从开发板端测速：

# 电脑端
iperf -s

# 开发板端
iperf -c <电脑IP> -t 10

成功标志：iperf 报告 Bandwidth 接近或超过 900 Mbps（千兆网理论上限的 90%）。

8. 故障排除

8.1 网口灯不亮 / 链路未建立

检查内核网卡驱动：

dmesg | grep -iE 'eth|gmac'

输出（节选）：

[    2.132077] rk_gmac-dwmac fe1c0000.ethernet: IRQ eth_lpi not found
[    2.132206] rk_gmac-dwmac fe1c0000.ethernet: supply phy not found, using dummy regulator
[    2.132244] rk_gmac-dwmac fe1c0000.ethernet: clock input or output? (output).
[    2.132250] rk_gmac-dwmac fe1c0000.ethernet: TX delay(0x43).
[    2.132255] rk_gmac-dwmac fe1c0000.ethernet: Can not read property: rx_delay.
[    2.132260] rk_gmac-dwmac fe1c0000.ethernet: set rx_delay to 0xffffffff

检查链路状态（速率、双工、协商）：

ethtool end1

注意：出厂镜像未预装 ethtool，直接执行会报 bash: ethtool: 未找到命令。 先安装：apt install -y ethtool，然后再执行查看 Speed / Duplex / Auto-negotiation 信息。

8.2 DHCP 获取不到 IP

手动触发 DHCP 请求：

dhclient end1

或重启网络服务：

systemctl restart networking

8.3 WiFi 连接不稳定

  1. 确认天线已牢固连接
  2. 缩短开发板与路由器的距离
  3. 检查 WiFi 信道是否拥挤，尝试切换 5G 频段

8.4 SSH 连接慢

编辑 SSH 配置关闭 DNS 反查：

vi /etc/ssh/sshd_config

加入：

UseDNS no

重启 SSH 服务：

systemctl restart ssh

相关文档