4、OpenWrt系统基础：文件系统结构、进程管理、开机启动脚本、日志查看、常用命令与工具

MT7688智能网关的软件核心是OpenWrt/LEDE系统，它本质上是一个针对嵌入式设备深度裁剪和定制的Linux发行版。与通用Linux服务器不同，OpenWrt运行在仅有16MB~128MB Flash和64MB~256MB内存的硬件上，因此其文件系统布局、进程管理方式、启动机制以及日志策略都带有鲜明的嵌入式特征。对于从事多设备数据转发开发的工程师而言，理解OpenWrt的“骨架”是进行驱动移植、协议栈调试和业务进程守护的前提。本章将围绕文件系统结构、进程管理、启动脚本、日志查看和常用工具五个维度展开，并结合MT7688网关的实际开发场景进行拆解。

上图展示了MT7688网关中OpenWrt系统的整体架构关系。从底层硬件到上层应用，每一层都有明确的职责边界。文件系统采用overlay机制实现只读固件与可写配置的分离，进程管理由procd统一接管，启动脚本通过/etc/init.d目录组织，日志通过logd统一收集。理解这张图，就掌握了OpenWrt系统的基本脉络。

4.1 文件系统结构：overlay机制与目录规划

4.1.1 核心原理：只读与可写的分离

OpenWrt的文件系统采用overlayfs（叠加文件系统）设计。固件烧录时，根文件系统以squashfs格式打包为只读分区（挂载在/rom），而用户配置和数据存放在可写的jffs2或ubifs分区（挂载在/overlay）。系统启动时，内核将/overlay叠加在/rom之上，形成完整的根目录视图。对用户而言，所有对根文件系统的写入操作都透明地重定向到/overlay分区，而/rom中的原始文件保持不变。这种设计的核心优势在于：恢复出厂设置只需清空/overlay分区，固件本身永远不会被用户误操作破坏。

4.1.2 操作流程：查看分区与空间管理

在MT7688开发中，经常需要确认Flash分区布局和剩余空间。使用以下命令：

# 查看分区表
cat /proc/mtd
# 查看挂载情况
df -h
# 查看overlay使用率
mount | grep overlay
# 查看根目录实际占用
du -sh /overlay/*

当overlay空间不足时，应清理opkg安装的冗余软件包或日志文件。注意不要直接删除/rom中的文件，因为它们是只读的，删除操作只会创建whiteout标记，反而占用overlay空间。

4.1.3 实战场景：数据转发程序的部署位置

假设我们要在网关上部署一个自定义的数据转发程序data_forwarder，该程序需要保存运行日志和配置文件。合理的做法是：

1. 将可执行文件放在/usr/bin/（overlay层，可写）
2. 将配置文件放在/etc/config/data_forwarder.conf
3. 将运行时日志写入/var/log/data_forwarder.log（tmpfs，避免频繁写Flash）
4. 如果需要持久化关键数据，写入/etc/data/目录

4.1.4 常见误区与复盘

初学者常犯的错误是试图修改/rom中的文件，或者将大文件直接放在根目录。实际上，OpenWrt的overlay机制意味着所有对根文件系统的修改都占用overlay空间。另一个误区是忽略/tmp的tmpfs特性，将重要配置放在/tmp下导致重启丢失。正确的做法是：配置文件放/etc，临时数据放/tmp，日志放/var/log（自动映射到/tmp）。

4.2 进程管理：procd守护与ubus通信

4.2.1 核心原理：procd与init的演进

传统Linux使用SysVinit作为1号进程，而OpenWrt使用procd作为进程管理器。procd不仅负责启动系统服务，还提供进程守护（respawn）、热插拔事件处理和服务依赖管理功能。当被守护的进程异常退出时，procd会自动重启它，这对于网关设备上需要7×24小时运行的数据转发进程至关重要。procd通过ubus（OpenWrt微总线）与其他系统组件通信，ubus类似于D-Bus，但更轻量，适合嵌入式环境。

4.2.2 操作流程：进程查看与信号控制

# 查看所有进程
ps w
# 查看特定进程
ps | grep data_forwarder
# 发送信号终止进程
kill -9 1234
# 优雅停止
kill -TERM 1234
# 按名称终止
killall data_forwarder
# 查看进程资源占用
top

对于由procd管理的服务，应使用/etc/init.d/服务名 stop|start|restart来控制，而不是直接kill。因为直接kill后procd会立即重启该服务，导致“杀不死”的现象。

4.2.3 案例拆解：守护数据转发进程

背景：某智能网关运行一个串口转TCP的数据转发程序，该程序偶尔因串口异常而崩溃。要求实现进程崩溃后自动重启，且重启次数有限制，防止无限重启。

实现步骤：

1. 创建启动脚本/etc/init.d/data_forwarder
2. 在脚本中定义start_service()和stop_service()函数
3. 使用procd_open_instance和procd_set_param command注册守护
4. 设置respawn参数：procd_set_param respawn 3600 5 5（1小时内最多重启5次，每次间隔5秒）

#!/bin/sh /etc/rc.common
START=99
STOP=10

start_service() {
    procd_open_instance
    procd_set_param command /usr/bin/data_forwarder
    procd_set_param respawn 3600 5 5
    procd_set_param stdout 1
    procd_set_param stderr 1
    procd_close_instance
}

stop_service() {
    killall data_forwarder
}

结果：程序崩溃后5秒内自动重启，1小时内超过5次则停止重启并记录错误日志。通过logread可以查看procd的重启记录。

4.2.4 常见误区与复盘

误区一：使用kill -9强制杀死procd管理的进程，导致procd立即重启它，造成“杀不死”的假象。正确做法是使用/etc/init.d/服务名 stop。误区二：忽略进程的退出码。procd根据退出码判断是否需要重启，如果程序正常退出（exit 0），procd不会重启它。误区三：在脚本中使用while true; do ...; done循环来保持进程存活，这会导致procd认为进程一直在运行，无法监控真实业务进程的状态。

4.3 开机启动脚本：init.d机制与启动顺序

4.3.1 核心原理：rc.common与运行级

OpenWrt的启动脚本位于/etc/init.d/目录，每个脚本都包含#!/bin/sh /etc/rc.common头部，并定义START和STOP变量控制启动顺序。系统启动时，/etc/rc.d/目录下的符号链接按数字顺序执行。例如S99_data_forwarder表示在第99优先级启动。使用/etc/init.d/脚本 enable命令会在/etc/rc.d/中创建符号链接，disable则移除链接。

4.3.2 操作流程：编写自定义启动脚本

#!/bin/sh /etc/rc.common
# 启动优先级（数字越小越先启动）
START=95
# 停止优先级（数字越小越先停止）
STOP=15

# 启动时执行
start() {
    echo "Starting data forwarder..."
    /usr/bin/data_forwarder --daemon
}

# 停止时执行
stop() {
    echo "Stopping data forwarder..."
    killall data_forwarder
}

# 重启时执行
restart() {
    stop
    sleep 1
    start
}

保存后执行：

chmod +x /etc/init.d/data_forwarder
/etc/init.d/data_forwarder enable
/etc/init.d/data_forwarder start

4.3.3 实战场景：依赖网络就绪的启动

数据转发程序通常需要网络接口就绪后才能正常工作。如果启动顺序不当，程序可能在网络未配置完成时启动，导致初始化失败。解决方案有两种：

• 将START值设为大于网络服务的值（网络服务通常在40~60之间），例如START=95
• 在脚本中使用procd_add_reload_trigger监听网络接口事件，网络就绪后自动重启服务

4.3.4 常见误区与复盘

误区一：忘记执行chmod +x导致脚本无法执行。误区二：在启动脚本中使用exit 0提前退出，导致procd认为脚本执行失败。误区三：启动脚本中启动后台进程时未使用--daemon或&，导致脚本阻塞。正确做法是让启动脚本快速返回，由procd管理后台进程的生命周期。

4.4 日志查看：logd与logread

4.4.1 核心原理：环形缓冲区与持久化

OpenWrt使用logd（日志守护进程）统一收集系统日志。logd将日志写入内存环形缓冲区（默认64KB），同时可以配置为同时写入Flash文件。使用logread命令读取缓冲区内容，使用logread -f实时跟踪日志输出。这种设计避免了频繁写Flash，延长了Flash寿命。

4.4.2 操作流程：日志查看与配置

# 查看全部日志
logread
# 实时跟踪日志
logread -f
# 查看最近50行
logread | tail -50
# 按关键字过滤
logread | grep "data_forwarder"
# 查看日志缓冲区大小
cat /proc/sys/kernel/printk

如果需要持久化日志到Flash，编辑/etc/config/system：

config log
    option log_file '/var/log/system.log'
    option log_size '64'
    option log_remote '0'

4.4.3 案例拆解：排查数据转发异常

现象：网关上的数据转发程序每隔一段时间就停止工作，但进程仍然存在。

排查过程：

1. 执行logread | grep data_forwarder查看程序日志，发现“Connection reset by peer”错误
2. 执行logread | grep kernel查看内核日志，发现TCP连接超时记录
3. 使用netstat -tunap查看连接状态，发现大量TIME_WAIT连接
4. 确认是TCP连接未正确关闭导致文件描述符耗尽

解决方案：在程序中增加连接超时关闭机制，并定期清理无效连接。同时使用logread -f实时监控日志，确认问题不再出现。

4.4.4 常见误区与复盘

误区一：使用dmesg查看内核日志，但dmesg只显示内核环形缓冲区，不包含用户态程序日志。误区二：在程序中直接写/dev/console，这会导致日志输出到串口，影响串口调试。误区三：忽略日志级别。OpenWrt的日志级别从0（紧急）到7（调试），默认只显示级别4（警告）以上的日志。使用logread -l 7可以查看所有级别日志。

4.5 常用命令与工具：高效开发必备

4.5.1 核心原理：BusyBox与精简工具集

OpenWrt使用BusyBox提供精简的Unix命令集。BusyBox将ls、cp、ps、kill等常用命令编译为单一可执行文件，通过符号链接调用不同功能。这种设计大幅节省了Flash空间。MT7688开发中，常用的工具还包括：uci（配置管理）、swconfig（交换机配置）、i2cget/i2cset（I2C总线操作）、gpioctl（GPIO控制）等。

4.5.2 操作流程：网络与串口调试工具

# 网络抓包（需安装tcpdump）
tcpdump -i br-lan port 8080 -w /tmp/capture.pcap
# 串口数据监控
cat /dev/ttyS0 | hexdump -C
# 测试TCP连接
nc -vz 192.168.1.100 8080
# 查看路由表
ip route show
# 查看ARP表
cat /proc/net/arp

4.5.3 实战场景：使用strace定位系统调用问题

当数据转发程序出现“无法打开文件”或“权限不足”错误时，使用strace跟踪系统调用：

# 跟踪程序的所有系统调用
strace -f -o /tmp/trace.log /usr/bin/data_forwarder
# 跟踪特定系统调用
strace -e open,read,write -p 1234

通过分析trace.log，可以快速定位程序尝试访问的文件路径、返回的错误码（如ENOENT、EACCES），从而判断是路径错误、权限问题还是文件系统只读导致。

4.5.4 常见误区与复盘

误区一：在OpenWrt上使用grep时，BusyBox的grep不支持--color等GNU扩展选项。误区二：使用vi编辑文件时，BusyBox的vi功能有限，建议使用sed或awk进行脚本化编辑。误区三：忘记安装必要的工具包。OpenWrt默认只包含最小工具集，使用opkg update && opkg install tcpdump strace安装所需工具。