从手动三步到上电即连：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 -brlink| grep -E'enx|eth|usb'# 期望看到 enxae0c29a39b6d 这类接口名# 确认模组枚举成功lsusb | grep -i quectel

3. 权限要求

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

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

4. 手动三步验证

sudoifconfig enxae0c29a39b6d upsudostty-F /dev/ttyUSB1 -opostsudoprintf"AT+qnetdevctl=1,1,1\r\n"> /dev/ttyUSB1sleep10sudodhclient enxae0c29a39b6dip -4 addr show enxae0c29a39b6d # 期望看到 inet 10.x.x.xping -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.sleep10s，等待模组注册与 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拿IPset-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 execsudo"$0""$@"filog"===== auto-connect start (pid=$$ iface=$IFACEmodem=$MODEM) ====="# 1) 等网卡出现（≤30s）foriin$(seq1 30);do iplinkshow dev"$IFACE">/dev/null 2>&1 && {log"iface$IFACE出现 (${i}s)";break; } sleep1doneiplinkshow dev"$IFACE">/dev/null 2>&1 || {log"ERROR:$IFACEnot found";exit1; }# 2) 拉起网卡ifcommand-v ifconfig >/dev/null 2>&1;then ifconfig"$IFACE"up 2>>"$LOG"else iplinkset"$IFACE"upfilog"iface$IFACEup"# 3) 等模组tty出现（≤60s）foriin$(seq1 60);do [ -e"$MODEM"] && {log"modem$MODEM出现 (${i}s)";break; } sleep1done[ -e"$MODEM"] || {log"ERROR:$MODEMnot present";exit1; }# 4) 关tty输出处理stty-F"$MODEM"-opost 2>/dev/nullsleep2# 5) 触发PDP拨号printf"AT+qnetdevctl=1,1,1\r\n">"$MODEM"log"AT+qnetdevctl sent"# 6) 等模组注册 + PDP激活sleep10# 7) DHCP带重试foriin1 2 3 4 5;do ifcommand-v dhclient >/dev/null 2>&1;then ifdhclient"$IFACE"2>>"$LOG";thenlog"dhclient OK (try$i)";break;fi elifcommand-v dhcpcd >/dev/null 2>&1;then ifdhcpcd"$IFACE"2>>"$LOG";thenlog"dhcpcd OK (try$i)";break;fi else log"ERROR: 未安装 dhclient/dhcpcd";exit1 fi log"DHCP try$ifailed, sleep 5s & retry" sleep5donelog"===== auto-connect end ====="exit0

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

[Unit]Description=Auto bring up4G modem (Quectel AT+qnetdevctl) and DHCPAfter=local-fs.targetWants=local-fs.target[Service]Type=oneshotRemainAfterExit=yesExecStart=/usr/local/bin/auto-4g-connect.shRestart=on-failureRestartSec=15StartLimitBurst=5StartLimitIntervalSec=300[Install]WantedBy=multi-user.target

六、 安装与验证

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

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

sudochmod+x /usr/local/bin/auto-4g-connect.shsudosystemctl daemon-reload # 重载单元，否则enable会报 unit not foundsudosystemctlenable--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 # 脚本日志

卸载：

sudosystemctldisable--now auto-4g-connect.servicesudorm/usr/local/bin/auto-4g-connect.sh /etc/systemd/system/auto-4g-connect.service

写在最后

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

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