ETH网口

2025-05-20

QuecPi Alpha 单板电脑支持 1 路自适应千兆以太网，以太网对网线的要求：仅支持直连网线，不支持交叉网线。

网络配置

系统默认开启 NetworkManager 服务来管理网络。

使用 ifconfig 命令查看网络接口地址：

使用 route -n 命令查看网络路由信息，里面包含默认网关地址信息：

通过查看 /etc/resolv.conf 文件内容检查 DNS 服务器地址：

【如果是通过网络远程连接到设备中修改网络，会有风丢失网络连接的风险，请确保有方法（如通过调试串口或显示器）查看修改后的网络配置】

系统默认设置为自动获取网络配置，使用网线将设备接入局域网，设备会自动获取网络配置（前提条件需要局域网中存在可用的 DHCP 服务）。
故障排除：

查看连接信息：执行命令 nmcli c，观察输出的结果中 DEVICE 列是否有包含 eth0，如果有先删除再重建。
删除旧的连接信息：执行命令 nmcli c del 'Wired connection 1' #这里的 'Wired connection 1' 是从上一步中查询出的连接的 NAME。【删除后默认会自动创建一个 NAME 为 eth0 连接，这个时候会自动获取网络配置】
新建连接并使能：执行命令 nmcli c add type ethernet con-name eth0 ifname eth0 来创建连接，这里指定了连接名为 eth0，使用的网络接口也是 eth0；再执行 nmcli connection up eth0 来让名为 eth0 的连接生效。【一般上一步删除旧连接后，会自动创建一个 NAME 为 eth0 的连接，这个时候会自动获取网络配置，如果某些情况下新的连接迟迟没有自动创建，可以执行该步骤来创建和使能新的连接】

【如果是通过网络远程连接到设备中修改网络，会有风丢失网络连接的风险，请确保有方法（如通过调试串口或显示器）查看修改后的网络配置】

查看连接信息：执行命令 nmcli c，观察输出的结果中 DEVICE 列是否有包含 eth0，如果有记下其 NAME 值，后面需要用到。如果没有，则先创建一个 eth0 连接，执行命令 nmcli c add type ethernet con-name 'Wired connection 1' ifname eth0
手动配置网络：执行命令
```
nmcli c modify 'Wired connection 1' \
ipv4.addresses 192.168.1.100/24 \
ipv4.gateway 192.168.1.1 \
ipv4.dns 192.168.1.1 \
ipv4.method manual
```
修改完成后执行 nmcli c up 'Wired connection 1' 使能连接【示例中的 IP 地址、网关地址、DNS 地址根据实际需要修改】。

执行 ping 命令测试网络连接：