当前位置：首页 > news >正文

OpenWrt系统开发笔记

news 2025/8/28 7:34:14

openWrt英文官网： https://openwrt.org/ 中文官网： http://www.openwrt.org.cn/

一、开发环境及编译

在github上有两个源码使用的比较多
一个是lede,地址为：https://github.com/coolsnowwolf/lede
另一个为OpenWrt的官方源码：https://github.com/lede-project
下载lede的源码方法为：

git clone https://github.com/coolsnowwolf/lede

下载OpenWrt的官方源码方法为：

git clone https://github.com/openwrt/openwrt.git

二、编译模块

单独编译一个模块，以myapp_test为例

make package/myapp_test/clean          // 清除编译生成的文件  
make package/myapp_test/prepare        // 编译准备，下载、解压缩、打补丁  
make package/myapp_test/configure      // 根据设置选项配置生成Makefile  
make package/myapp_test/compile        // 根据Makefile进行编译  
make package/myapp_test/install        // 生成安装包

三、源码目录

openWrt顶层目录含义：

config/         // 编译选项配置文件  
docs/           // 文档目录  
include/        // 包含准备环境脚本、下载脚本、编译Makefile以及编译指令  
package/        // 各种功能的安装包  
scripts/        // 包含准备环境脚本、下载脚本、编译Makefile以及编译指令  
target/         // 嵌入式平台  
toolchain/      // 编译器和C库等  
tools/          // 通用命令，用来生成固件的辅助工具

在openWrt固件中，几乎所有的东西都是软件包(package)，可以编译为 .ipk 结尾的安装包，这样就可以很方便的安装、升级和卸载。
openWrt编译生成目录含义：

dl/             // 编译时下载软件代码包临时目录  
feeds/          // 扩展软件包目录  
bin/            // 编译完成后的最终成果目录  
build_dir/      // 编译中间文件目录  
staging_dir/    // 编译安装目录  
log/            // 如果打开了log选项，则编译log保存在该目录下

四、openWrt系统包管理

安装并进入openWrt系统后，openWrt包管理方法为:

4.1、软件包管理

opkg update		// 更新可以安装的软件包列表
opkg install	// 安装软件包，需要第三个参数传递一个软件包的名称。如 opkg install file
opkg remove		// 卸载安装包，需要第三个参数传递一个软件包的名称。autoremove可以将不需要的安装包也删除。如 opkg remove file --autoremove
opkg upgrade	// 升级软件包，需要第三个参数传递一个软件包的名称。一般只用来升级应用(非内核软件)。

4.2、查询信息：

opkg list					// 列出所有可使用的软件包
opkg list-installed			// 列出系统中已经安装的软件包
opkg list-changed-conffiles	// 列出用户修改过的配置文件
opkg files <pkg>			// 列出属于这个软件包中的所有文件
opkg search <file>			// 列出提供file的软件包，需要传递文件的绝对路径
opkg find <regexp>			// 列出软件包名称和regexp匹配的软件包
opkg info [pkg]				// 显示已安装pkg软件包的信息
opkg download <pkg>			// 将软件包pkg下载到当前目录
opkg print-architecture		// 列出安装包的架构
opkg whardepends [-A] [pkg]	// 针对已安装的软件包，输出依赖这个软件包的软件包

opkg命令选项：
-A 查询所有软件包
-d <dest_name> 使用dest_name作为软件包安装的根目录
-f <conf_file> 使用conf_file作为opkg的配置文件
--nodeps 不按照依赖来安装，只安装软件包自己
--autoremove 卸载软件包时自动卸载不再使用的软件包
--force-reinstall 强制重新安装软件包

五、openWrt系统配置（UCI接口）

MVC(Model-View-Control)模式是经典的Web开发编程模式。openWrt也是采用该设计模式，模型层采用统一配置接口 UCI (Unified Configuration Interface)。
openWrt系统的核心配置文件，都位于 /etc/config/ 目录下。
例如修改网络ip：

uci set network.lan.ipaddr=192.168.6.1
uci commit network

通过运行以下命令修改生效：

/etc/init.d/network restart

如图所示：
在这里插入图片描述

常用功能配置文件含义：

/etc/config/dhcp        // dnsmasq软件包配置，包含dhcp和dns设置  
/etc/config/dropbear    // SSH服务器选项  
/etc/config/firewall    // 防火墙设置，包含网络地址转换、包过滤、端口转发等  
/etc/config/network     // 网络配置，包含桥接、接口、路由配置  
/etc/config/system      // 系统配置，包含主机名称、网络时间同步等  
/etc/config/timeserver  // rdate的时间服务列表  
/etc/config/luci        // 基本的LuCI配置  
/etc/config/wireless    // 无限设置和wifi网络定义  
/etc/config/uhttpd      // web服务器选项配置  
/etc/config/upnpd       // miniupnpd UPnP服务设置  
/etc/config/qos         // 网络服务质量的配置文件定义

六、openWrt内核配置

6.1、sysctl

sysctl.conf 是系统启动预加载的内核配置文件，sysctl.conf的文件位置在openwrt源码文件的目录为： package/base-files/files/etc/sysctl.conf。通过编译，在openwrt系统中生成/etc/sysctl.d/* 。
在openwrt系统中可以通过sysctl命令去读和设置。例如：

/sbin/sysctl -a								# 显示所有的内核配置
/sbin/sysctl -n kernel.hostname				# 查询kernel.hostname的值
/sbin/sysctl -w kernel.hostname="zhangsan"	# 修改系统主机名称为zhangsan
/sbin/sysctl -p /etc/sysctl.conf			# 加载配置

在这里插入图片描述

6.2、/proc/sys/ 目录

大部分可用的内核参数均在 /proc/sys/ 目录下。例如：
查询是否打开路由转发：

cat /proc/sys/net/ipv4/ip_forward

打开路由转发设置：

echo "1" > /proc/sys/net/ipv4/ip_forward

6.3、系统配置文件

系统配置文件介绍：

/etc/rc.local       // 想要在开机后就执行的命令可以写入该文件  
/etc/profile        // 为系统的每个登陆用户设置环境变量  
/etc/shells         // openWrt采用的shell是 /bin/ash  
/etc/fstab          // 各种文件系统的描述信息  
/etc/services       // 互联网网络服务类型列表  
/etc/protocols      // 协议定义描述文件