从手动三步到上电即连：4G模组systemd开机自连方案

在工业网关、巡检终端、车载设备这类依赖4G网络回传数据的嵌入式产品中，"联网"是设备可运维、数据可回传的基础能力。这类设备通常部署在无人值守现场，若每次冷启动都需人工介入------登录串口、手动拉起USB网卡、发送AT指令触发拨号、再执行DHCP获取IP------不仅运维成本高，也难以满足工业场景对"上电即可用"的可靠性要求。

基于systemd的服务编排能力，可将上述手动链路封装为开机自启动服务，实现上电后15~30秒内自动完成网络接入。本文以EASY-EAI全栈产品为例，涵盖设备识别、systemd单元设计、完整脚本与一键安装，为同类4G联网产品的量产部署提供可复用的工程参考。

一、方案前提：先跑通手动链路

在接入systemd之前，必须确认手动流程可用。这是最容易忽略却最关键的一步------若手动都调不通，service启动失败时将无法区分是脚本问题还是网络本身问题。

1. 硬件确认

4G模组（Quectel EC800K-CN）已插入板卡USB口，SIM卡已装好
天线已接，信号格不为0
板卡已烧录系统，开机可进入shell
手动执行"拉网卡→拨号→DHCP"后可正常上网

2.设备识别

插好模组启动后，通过以下命令确认设备节点与网卡名：

复制代码

# 查看USB串口（模组一般枚举出 ttyUSB0~ttyUSB2）
ls -l /dev/ttyUSB* 2>/dev/null
# 期望看到 ttyUSB0/1/2，其中 ttyUSB1 为AT指令口

# 查看USB网卡（systemd命名为 enx+MAC 形式）
ip -br link | grep -E 'enx|eth|usb'
# 期望看到 enxae0c29a39b6d 这类接口名

# 确认模组枚举成功
lsusb | grep -i quectel

3. 权限要求

拉起网卡需要 CAP_NET_ADMIN 能力，写 /var/log 需要写权限，因此整个流程必须以 root 运行：

复制代码

sudo su   # 推荐直接切root，后续少敲sudo

4. 手动三步验证

复制代码

sudo ifconfig enxae0c29a39b6d up
sudo stty -F /dev/ttyUSB1 -opost
sudo printf "AT+qnetdevctl=1,1,1\r\n" > /dev/ttyUSB1
sleep 10
sudo dhclient enxae0c29a39b6d
ip -4 addr show enxae0c29a39b6d   # 期望看到 inet 10.x.x.x
ping -c 2 8.8.8.8                 # 期望有回应

以上全部通过，方可进入下一步。

二、工作流程：systemd接管后的七步链路

开机后，systemd启动 auto-4g-connect.service，调用主脚本按序执行：

复制代码

开机
 └─ systemd 启动 /etc/systemd/system/auto-4g-connect.service
     └─ 运行 /usr/local/bin/auto-4g-connect.sh
         ├─ 1. 等待 enxae0c29a39b6d 网卡出现（≤30s）
         ├─ 2. ifconfig enxae0c29a39b6d up
         ├─ 3. 等待 /dev/ttyUSB1 出现（≤60s）
         ├─ 4. stty 关闭 tty 输出处理，避免 \n 被转成 \r\n
         ├─ 5. 发送 AT+qnetdevctl=1,1,1 触发 PDP 拨号
         ├─ 6. sleep 10s，等待模组注册与 PDP 激活
         └─ 7. dhclient enxae0c29a39b6d（失败重试5次）

典型场景15~30秒完成；最坏情况（设备枚举慢 + 信号差 + DHCP多次重试）约2.5分钟。

三、关键设计解析

方案针对冷启动过程中的时序不确定性做了针对性处理，设计要点如下：

四、文件清单与路径规范

五、完整脚本与配置

5.1 主脚本 /usr/local/bin/auto-4g-connect.sh

复制代码

#!/bin/bash
# auto-4g-connect.sh --- 上电自启：拉网卡 -> 触发模组拨号 -> DHCP拿IP
set -u

# ========== 配置区（支持环境变量覆盖）==========
IFACE="${IFACE:-enxae0c29a39b6d}"
MODEM="${MODEM:-/dev/ttyUSB1}"
LOG="${AUTO_4G_LOG:-/var/log/auto-4g-connect.log}"

log() { echo "$(date '+%F %T') $*" | tee -a "$LOG"; }

# ========== 权限兜底 ==========
if [ "$(id -u)" -ne 0 ]; then
    echo "$(date '+%F %T') 非root，转sudo: $0 $*" >> "$LOG" 2>/dev/null
    echo "[!] 需要root，请用 sudo $0 $*" >&2
    exec sudo "$0" "$@"
fi

log "===== auto-connect start (pid=$$ iface=$IFACE modem=$MODEM) ====="

# 1) 等网卡出现（≤30s）
for i in $(seq 1 30); do
    ip link show dev "$IFACE" >/dev/null 2>&1 && { log "iface $IFACE 出现 (${i}s)"; break; }
    sleep 1
done
ip link show dev "$IFACE" >/dev/null 2>&1 || { log "ERROR: $IFACE not found"; exit 1; }

# 2) 拉起网卡
if command -v ifconfig >/dev/null 2>&1; then
    ifconfig "$IFACE" up 2>>"$LOG"
else
    ip link set "$IFACE" up
fi
log "iface $IFACE up"

# 3) 等模组tty出现（≤60s）
for i in $(seq 1 60); do
    [ -e "$MODEM" ] && { log "modem $MODEM 出现 (${i}s)"; break; }
    sleep 1
done
[ -e "$MODEM" ] || { log "ERROR: $MODEM not present"; exit 1; }

# 4) 关tty输出处理
stty -F "$MODEM" -opost 2>/dev/null
sleep 2

# 5) 触发PDP拨号
printf "AT+qnetdevctl=1,1,1\r\n" > "$MODEM"
log "AT+qnetdevctl sent"

# 6) 等模组注册 + PDP激活
sleep 10

# 7) DHCP带重试
for i in 1 2 3 4 5; do
    if command -v dhclient >/dev/null 2>&1; then
        if dhclient "$IFACE" 2>>"$LOG"; then log "dhclient OK (try $i)"; break; fi
    elif command -v dhcpcd >/dev/null 2>&1; then
        if dhcpcd "$IFACE" 2>>"$LOG"; then log "dhcpcd OK (try $i)"; break; fi
    else
        log "ERROR: 未安装 dhclient/dhcpcd"; exit 1
    fi
    log "DHCP try $i failed, sleep 5s & retry"
    sleep 5
done

log "===== auto-connect end ====="
exit 0开机
 └─ systemd 启动 /etc/systemd/system/auto-4g-connect.service
     └─ 运行 /usr/local/bin/auto-4g-connect.sh
         ├─ 1. 等待 enxae0c29a39b6d 网卡出现（≤30s）
         ├─ 2. ifconfig enxae0c29a39b6d up
         ├─ 3. 等待 /dev/ttyUSB1 出现（≤60s）
         ├─ 4. stty 关闭 tty 输出处理，避免 \n 被转成 \r\n
         ├─ 5. 发送 AT+qnetdevctl=1,1,1 触发 PDP 拨号
         ├─ 6. sleep 10s，等待模组注册与 PDP 激活
         └─ 7. dhclient enxae0c29a39b6d（失败重试5次）

5.2 systemd单元/etc/systemd/system/auto-4g-connect.service

复制代码

[Unit]
Description=Auto bring up 4G modem (Quectel AT+qnetdevctl) and DHCP
After=local-fs.target
Wants=local-fs.target

[Service]
Type=oneshot
RemainAfterExit=yes
ExecStart=/usr/local/bin/auto-4g-connect.sh
Restart=on-failure
RestartSec=15
StartLimitBurst=5
StartLimitIntervalSec=300

[Install]
WantedBy=multi-user.target

六、安装与验证

**一键安装（推荐）：**SSH登录板卡后，将安装脚本整块粘贴至终端执行，脚本会自动写入文件、赋权、注册服务并立即启动（完整安装源码见文末EASY-EAI开发者社区原贴）。

分步安装： 手动创建上述两个文件后执行：

复制代码

sudo chmod +x /usr/local/bin/auto-4g-connect.sh
sudo systemctl daemon-reload          # 重载单元，否则enable会报 unit not found
sudo systemctl enable --now auto-4g-connect.service

状态验证：

复制代码

systemctl status auto-4g-connect.service   # 期望 active (exited)
journalctl -u auto-4g-connect.service -f   # 服务日志
tail -f /var/log/auto-4g-connect.log       # 脚本日志

卸载：

复制代码

sudo systemctl disable --now auto-4g-connect.service
sudo rm /usr/local/bin/auto-4g-connect.sh /etc/systemd/syste

写在最后

这套方案的本质，是用systemd的服务编排能力，将4G模组在冷启动过程中的"时序不确定性"------网卡与tty设备枚举晚于systemd启动、信号注册耗时波动、DHCP下发延迟------转化为"等待+重试"的确定性流程。通过 IFACE / MODEM 环境变量解耦硬件差异，配合 oneshot 服务类型与失败重试策略，同一套脚本可适配不同板型与模组型号，降低多SKU产品的软件维护成本。

对于需要批量部署4G联网设备的工业客户而言，"开机即联网"虽是基础能力，却直接决定了设备的远程可运维性与数据回传完整率。EASY-EAI已在多款4G联网方案中已将该能力标准化，相关实现可供开发者直接集成。