树莓派3B+搭载Ubuntu Server 22.04，通过4G USB调制解调器和Netplan无法联网求助

阿华AIGC实验室

2026-4-17

嘿，我注意到你在树莓派3B+上跑Ubuntu Server 22.04，想用4G USB调制解调器搭配Netplan联网时遇到了麻烦。先别慌，咱们先梳理下目前的状况，一步步来排查问题~

目前设备识别状态

从你提供的命令输出来看，系统已经成功识别了这个ZTE的4G调制解调器，这是个不错的开头！

`lsusb` 识别结果

carlo@pi-box:~$ lsusb
Bus 001 Device 008: ID 19d2:0016 ZTE WCDMA Technologies MSM ZTE Mobile Broadband

`dmesg` 内核日志输出

carlo@pi-box:~$ sudo dmesg | grep usb
[  423.387073] usb 1-1.3: new high-speed USB device number 10 using dwc2
[  423.497368] usb 1-1.3: New USB device found, idVendor=19d2, idProduct=0016, bcdDevice=54.24
[  423.497428] usb 1-1.3: New USB device strings: Mfr=1, Product=2, SerialNumber=0
[  423.497452] usb 1-1.3: Product: ZTE Mobile Broadband
[  423.497474] usb 1-1.3: Manufacturer: ZTE,Incorporated
[  423.500645] usb 1-1.3: GSM modem (1-port) converter now attached to ttyUSB0
[  423.502143] usb 1-1.3: GSM modem (1-port) converter now attached to ttyUSB1
[  423.503982] usb 1-1.3: GSM modem (1-port) converter now attached to ttyUSB2

从日志能看到，系统把调制解调器映射成了三个串口设备：ttyUSB0、ttyUSB1、ttyUSB2，硬件层面的识别是正常的。

你的Netplan配置（目前未完成）

你给出的Netplan配置只写了一小部分：

network:
    renderer: NetworkManager
    ethernets:
        eth0:
       ...

下一步排查与配置建议

针对你的情况，我整理了几个实用的步骤，你可以逐一尝试：

安装必要的调制解调器依赖工具：Ubuntu Server默认可能没预装4G modem需要的组件，先执行下面的命令安装：
```
sudo apt update && sudo apt install ppp usb-modeswitch modemmanager
```
usb-modeswitch负责切换部分modem的工作模式（从存储设备切换到调制解调器模式），modemmanager则是管理调制解调器服务的核心工具。

完善Netplan的4G调制解调器配置：因为你选择了NetworkManager作为渲染器，我们可以在Netplan配置中添加modems段，参考下面的格式（记得替换成你的运营商APN）：

network:
  renderer: NetworkManager
  ethernets:
    eth0:
      dhcp4: true  # 如果eth0不需要联网，可以改成false
  modems:
    ttyUSB0:  # 通常ttyUSB0或ttyUSB2是数据传输端口，若不行可以换其他串口试试
      apn: "你的运营商APN"  # 比如中国移动填cmnet，中国联通填3gnet，中国电信填ctnet
      dhcp4: true
      method: auto

应用Netplan配置：修改完配置文件（一般在/etc/netplan/目录下，比如00-installer-config.yaml）后，执行以下命令生效：
```
sudo netplan generate
sudo netplan apply
```
检查NetworkManager状态与连接：配置完成后，查看设备状态：
```
nmcli device status
```
如果看到调制解调器设备显示disconnected，可以手动触发连接：
```
nmcli con up 你的调制解调器连接名  # 连接名通常会包含APN信息
```
查看日志排查问题：如果还是无法联网，查看NetworkManager的实时日志，定位具体错误：
```
journalctl -u NetworkManager -f
```