OpenWrt的一些心得

最近在折腾OpenWRT,第一次接触,用的是HLK7688的板子(就是下面这个东西,淘宝找的图)

OpenWrt的一些心得_第1张图片

先说个坑,烧了固件之后,WAN口改变,并不是左边独立出来的第一个,我的变成了最右边的那个。所以,如果通过uboot烧固件,怎么都不成功的话,多试试其它网口。硬件部分在图片的基础上略有改动,这个板子有两个串口(就图上的两个),我的板子把串口2卸了,装了个数码管,可以实时统计WIFI设备的连接数量。

好了,我接下来就说说我自己的研究过程心得。

0x01 OpenWrt小试牛刀之环境准备与初次编译

OpenWrt的准备工作我就不详细介绍了,我直接说说我自己的环境吧,还有中途我遇到的一些坑。我会给一些参考链接,不明白的可以参考别人写的比较详细的内容。

1、Linux环境 (Ubunut 16.04)

推荐Ubuntu16.04,我就是使用的Ubuntu16.04,搭配的VMware虚拟机。本来我自己的主机是Kali2016.1_x64,一开始想直接用Kali编译,结果变异过程特别艰难,头文件好多函数名不一样,修改了4、5个头文件,还是编译没出固件,所以不推荐使用Kali,其它的没用过,看了网上的回馈Ubuntu12.04应该也还可以。

2、安装依赖库

apt-get install g++
apt-get install libncurses5-dev
apt-get install zlib1g-dev
apt-get install bison
apt-get install flex
apt-get install unzip
apt-get install autoconf
apt-get install gawk
apt-get install make
apt-get install gettext
apt-get install gcc
apt-get install binutils
apt-get install patch
apt-get install bzip2
apt-get install libz-dev
apt-get install asciidoc
apt-get install subversion
apt-get install libssl-dev

或者

apt-get install g++ libncurses5-dev zlib1g-dev bison flex unzip autoconf gawk make gettext gcc binutils patch bzip2 libz-dev asciidoc subversion libssl-dev

网上很多都少了安装libssl-dev这个库,也可能是Ubuntu16.04的需要手动安装一下,这里需要注意一点。

3、下载OpenWrt项目

我下载的是 Trunk版

自己想要什么版本,可以直接上官方找找,链接: http://git.openwrt.org/

在Linux系统里直接git下来就好了

$ git clone git://git.openwrt.org/openwrt.git

4、更新软件包

进入openwrt项目的目录执行下面两条命令

$ ./scripts/feeds update –a
$ ./scripts/feeds install –a.

5、配置编译配置文件

首先需要生成配置文件,是一个在openwrt根目录下的隐藏文件“.config”

$ make defconfig

这条命令会检查编译环境,如果安装包没安装好,这一步会有提示,然后自行安装就Ok

接下来就可以开始定制自己想要的标准功能了

$ make menuconfig

这条命令是在控制台生成的图形化配置窗口,进入之后就能配置自己的固件了,对应固件的硬件信息,标准软件包,一目了然。熟悉之后,配置完成,保存,会自动在OpenWrt目录配置隐藏的".config"文件。接下来就可以编译了。

6、编译

简单介绍几个常用编译参数以及效果

$ make		// 直接编译,全都使用默认参数
$ make -j8 	// -j表示启动多线程编译,8表示8条线程
$ make V=s	// 编译过程打印输出变异过程,如果编译失败,使用这条命令,可以看到出错详细信息,最好和 -j1联用
$ make package/xxx	// 指定编译软件包,最终生成*.ipk,在bin/目录,编译完成拷贝到路由器使用 opkg install *.ipk进行安装

生成的文件,在OpenWrt的bin/目录下,虽然我的板子用的是MT7688,但在实际编译时我配置的目标是MT7628。在目录下会生成很多个*.bin文件,烧录的时候,烧录openwrt-ramips-mt7628-mt7628-squashfs-sysupgrade.bin

第一次接触,这里还有一个点需要注意

在编译完成之后,如果发现没有生成想要的openwrt-ramips-mt7628-mt7628-squashfs-sysupgrade.bin这个文件。

可能是因为生成的包大小超过了,比如说我想直接在路由器里进行开发,选择编译了,编译出来的包有20+M,但我的路由器是根本装不下的,OpenWrt项目会自动判断,就算生成了这个包,你也无法安装,是无效的,就不会生成这个*.bin文件。所以在自定义配置的时候,还是根据需求自己选择必须的功能就好。如果真的就想生成这么大的固件,这个问题我想应该也是可以突破的,不过我还没有研究。

0x02 如何把自己的程序编译进固件

既然是做二次开发,那我们总不能写个程序编译了一个一个路由器里把程序拷贝进去,我们就需要把程序一起编译进固件,烧完路由器,程序也就自然安装好了。

关于如何把自己写的代码编译到固件里其实也很简单。

这里先推荐两篇文章

OpenWRT Makefile框架以及Kernel和firmware生成过程分析
http://www.cnblogs.com/sammei/p/3968916.html

OpenWrt上用C来写一个Helloworld http://scateu.me/2016/12/03/openwrt-helloworld.html

通过上两篇文章,我再把我汲取到的知识简要的分享一下,不懂的可以在博客留言

首先,生成*.ipk包的源文件都是存在于package目录下的

配置**.config**编译配置文件的时候,会扫描所有目录的makefile文件,那么我们只需要按照OpenWrt给我们的规则来配置makefile文件就行Ok.

我以一个helloword的例子讲述一下这个过程。

1、创建一个规范的目录结构

在package目录下创建一个helloworld文件夹

openwrt/package/helloworld
├── Makefile					// 暂且称为root_Makefiel
└── src
    ├── helloworld.c
    └── Makefile				// 暂且成为src_Makefile

在root_Makefile写入内容 (这里的root_Makefile表示的是外部的Makefile,注意看上一段的注释)

include $(TOPDIR)/rules.mk

PKG_NAME:=helloworld
PKG_RELEASE:=1

PKG_BUILD_DIR:=$(BUILD_DIR)/$(PKG_NAME)

include $(INCLUDE_DIR)/package.mk

# 这里的宏配置的是在 make menuconfig 中的选项
define Package/helloworld
	SECTION:=utils
	CATEGORY:=Utilities
	TITLE:=Helloworld
endef

define Build/Prepare
	mkdir -p $(PKG_BUILD_DIR)
	$(CP) ./src/* $(PKG_BUILD_DIR)/
endef

define Package/helloworld/install
	$(INSTALL_DIR) $(1)/bin
	$(INSTALL_BIN) $(PKG_BUILD_DIR)/helloworld $(1)/bin/
endef

$(eval $(call BuildPackage,helloworld))

然后在src/helloworld.c里写一个标准教科书版本的 helloword

#include 

int main()
{
	printf("hello world\");
	return 0;	
}

再写一下编译程序的src_Makefile

helloworld: helloworld.o
	$(CC) $(LDFLAGS) helloworld.o -o helloworld
helloworld.o: helloworld.c
	$(CC) $(CFLAGS) -c helloworld.c

clean:
	rm *.o helloworld

OK.这样就可以编译了

启动OpenWrt的编译配置

~$ make menuconfig

我们刚写好的程序,在选项Utilities->helloworld,选中,保存,退出

执行make,就能直接把程序编译到固件里

测试程序也可以先把程序编译成*.ipk包,然后放到路由器里opkg install helloworld.ipk先安装测试一下,再编译固件。

0x03 自启动脚本如何编译进固件

自启动脚本的编译也可以按照上面的思路来进行,最后添加到启动项的时候,只需要在外部Makefile里添加把脚本拷贝到系统目录**/etc/init.d/**的命令就可以,虽然我小测无果,但我相信这个思路肯定没问题。

我这里说另一种更直接粗暴简单的方法。

将脚本文件放到这个目录下,并且添加可执行权限。

package/base-files/

这是编译固件的一个基础文件目录,就是说,所有固件中都会包含这个文件夹里的内容。

我就用我的数码管实时显示WIFI用户数量的脚本来说。

我的程序目录结构是这样的

/
├── etc
│    └──count_number
└── usr
    └── share
    	 └──count_number
				 └──count_number.sh

就只有两个文件

/usr/share/count_number/count_number.sh是我获取WIFI客户连接数量并输出到数码管的脚本实现

/etc/init.d/count_number 是开机启动脚本,实际上的开机启动脚本存在于**/etc/rc.d目录下,这个目录我们不用管,他会自动帮我们拷贝/etc/init.d/**目录下的文件过去

/etc/init.d/count_number 脚本代码

#!/bin/sh /etc/rc.common
# Copyright (C) 2017 www.wangsansan.com

START=50

start() {
	/usr/share/count_number/count_number.sh &
}

OK,把文件按照目录结构放到**package/base-files/**文件夹下,并添加可执行权限

这样就完成了。

编译,就直接把脚本编译进固件里了。

0x04 Luci 静态界面修改

好的,固件定制结束了,那就定制一下web页面,先登陆到路由器web页面看看

1、界面底部

OpenWrt的一些心得_第2张图片

上图蓝色部分包含超链接、版权支持信息文字和版本信息

看到图,第一个思路,找到Luci的安装目录,再从所有文件中搜索上面那串文字,

如果第一次玩OpenWRT不知道Luci安装目录,可以先找到index.html文件,因为Luci使用的是Lua脚本跑的,所以找到之后,cat查看或者用vim打开index.html,就能找到Luci安装目录。当然,也可以直接在根目录“/”执行查找命令,不过时间会比较漫长。

一般来说Luci的安装目录都是 “/usr/lib/lua/luci”

执行下面的命令。

root@OpenWrt:~# cd /usr/lib/lua/luci
root@OpenWrt:/usr/lib/lua/luci# find ./ -name "*" | xargs grep -Hn "Powered by"

解释一下参数含义,find 命令就不说了

xargs 将stdout输出流测内容传到stdin当作下一条命令的参数

grep

-H //打印文件名

-n //打印行号

返回结果

root@OpenWrt:/usr/lib/lua/luci# find ./ -name "*" | xargs grep -Hn "Powered by"
./view/themes/bootstrap/footer.htm:17:    Powered by <%= ver.luciname %> (<%= ver.luciversion %>) / <%= ver.distversion %>
root@OpenWrt:/usr/lib/lua/luci#

找到那么,vim 打开文件 “./view/themes/bootstrap/footer.htm”

修改第17行,对比原文,分析一下这行html代码什么意思

## 原文 ##
Powered by LuCI Master (git-17.246.24307-3e1ae70) / OpenWrt Designated Driver r49395

## HTML 标签,方便观看,分成三行 ##

Powered by <%= ver.luciname %> (<%= ver.luciversion %>)
 
/ <%= ver.distversion %>

一眼看过去,嗯,用眼睛翻译一下

 Powered by <变量1> (<变量2>)  / <变量3>
变量1 = "LuCI Master"
变量2 = "git-17.246.24307-3e1ae70"
变量3 = "OpenWrt Designated Driver r49395"

且 <变量3> 不包含超链接。

既然知道怎么回事,改起来方法就很多了。

1、可以直接修改变量内容;

2、直接修改此处的html内容;

为了方便,我就直接修改html吧,超链接跳转到我的博客地址,并且居中显示

Powered by WangSansan

看看结果

OpenWrt的一些心得_第3张图片

好了,底部部分完成。

2、左上角LOGO

LOGO部分,不知道是图片还是纯文字,页面上右键查看源代码,或者直接把页面另存到桌面

查看html,18行

OpenWrt

可以看到是文字Logo,如果是图片或许还方便一些,直接把logo替换就行,既然是文字,那就找找在哪儿修改

页面底部布局的文件是 “view/themes/bootstrap/footer.htm”

修改完成后退出vim,查看同级目录,包含一个文件 header.htm

vim打开,分析一下。就是这份文件。

162行和184行,修改一下,要加Logo也可以加一个Logo

<%=striptags( (boardinfo.hostname or "?") .. ( (node and node.title) and ' - ' .. translate(node.title) or '')) %> - LuCI
...
...
...
<%=boardinfo.hostname or "?"%>

修改后的代码

WangSansan - LuCI
...
...
...
WangSansan

修改后大概这样子

OpenWrt的一些心得_第4张图片

0x05 Web界面功能添加与内容开发

本来想把web功能部分与静态页面修改放到一起写,静态页面的修改,只研究了半个小时就能搞定了,本以为加功能嘛,大概浏览了一下,无非就是一堆Lua代码,增删改也就一会儿的事,研究了才发现除了Lua代码,还有目录结构和包含关系,这部分相对于纯静态页面的修改,还是稍有难度,所以单独分节,好了,接着上面的步骤来说。

静态内容的修改,没什么难度,既然我们是二次开发,那我们就尝试增加点新功能。

先登陆进去

OpenWrt的一些心得_第5张图片

常规的路由器功能,该有的都有。

接下来就可以开始定制属于我们自己的路由器界面了。

不建议直接对原油配置文件的内容进行修改

我们先把LuCi的配置文件是怎么工作的搞明白,在一步一步进行我们的二次开发工作。

LuCI采用了MVC模式,使用Lua脚本开发,在**/usr/lib/lua/luci**目录下,分别对应、、三个文件夹,做开发的同学,对MVC架构应该就比较熟悉了,模型(model)-视图(view)-控制器(controller),Luci采用的Lua进行开发,我们不需要定义自己的视图框架的话基本不需要对view层进行修改,基本上只需要修改model层就可以完成我们功能的添加。

Luci运行时,会扫描controller目录下的所有*.lua文件,进行功能入口的注册并展示在Web页面

当我们在Web页面点击各功能入口时,Luci会执行model目录下的对应入口功能模型

1、简单的CBI格式

目录 (注册模块入口)

module("luci.controller.控制器名/路径", package.seeall)
function index()
        entry(url跳转路径, 文件的相对路径, _("显示名称"), 显示顺序)
        end

目录 (配置CBI Module)

local fs = require "nixio.fs"
local sys = require "luci.sys"

local m, s

m = Map("配置文件文件名", "配置页面标题", "配置页面说明")
s = m:section("创建Section方式", "对象模块名")  
s.anonymous=true

return m

如果读者懂一点Lua语言的话看起来就会方便很多

包含两个变量,分别是m和s

变量m用于映射模块信息,其中**Map()**上面有函数三个参数

需要注意的是第1个参数:配置文件名,这个配置文件需要放到系统的/etc/config目录下

如果没有创建配置文件的话,访问页面会出错。配置文件可以简单的写一条“config 模块名”,后面会讲。

s = m:section("创建Section方式", "对象模块名")  

这一条是创建模块的,Section分为两种,NamedSection和TypedSection,前者根据配置文件中的Section名,而后者根据配置文件中的Section类型。

2、注册一个模块入口

首先进入controller目录,创建一个文件wangsansan.lua

写入内容

module("luci.controller.wangsansan", package.seeall)

function index()
        entry({"admin", "wangsansan_url"},
                cbi("admin_wangsansan/test"),
                _("Test"))
end

访问一下,可以看到我们已经添加了一个名为“Test”的入口

并且点击之后的url跳转路径是 http://192.168.1.1/cgi-bin/luci/admin/wangsansan_url

entry({"admin", "wangsansan_url"},cbi("admin_wangsansan/test"), _("Test"))

这条语句我折行了,看不懂的话,把它合并到一行来看就行了

第2个参数表示调用的路径,就下面这行内容

cbi("admin_wangsansan/test")

cbi() 这个函数会检索到model目录下,那这一行就是说,目标文件路径为model/cbi/admin_wangsansan/test.lua

OpenWrt的一些心得_第6张图片

不过这个时候我们点击Test会报错,因为我们还没有配置CBI模块

3、配置对应入口的CBI模块

首先创建配置文件

# echo "config wangsansan" > /etc/config/wangsansan

接下来配置CBI模块,创建文件model/cbi/admin_wangsansan/test.lua

写入下面的内容

local fs = require "nixio.fs"
local sys = require "luci.sys"

local m, s

m = Map("wangsansan", "wangsansan_title", "wangsansan_explain")
s = m:section(TypedSection, "wangsansan")
s.anonymous=true

return m

好了,点击Test栏目,访问一下

OpenWrt的一些心得_第7张图片

好了,可以看到和我们配置的信息是一样的。

自己纯手动建立过一遍,就能弄明白怎么回事,我们可以开始自己定制我们想要的界面了

提供参考连接:

LuCi API
https://htmlpreview.github.io/?https://raw.githubusercontent.com/openwrt/luci/master/documentation/api/index.html

Openwrt Luci界面开发http://blog.csdn.net/lichao_ustc/article/details/42739563

为你的luci添加自助高级配置界面http://www.right.com.cn/forum/thread-183560-1-1.html

Openwrt开发与Luci介绍http://www.jianshu.com/p/bfb93c4e8dc9


折腾几天的成果,可能有些坑爬出来之后,就忘了,如果大家有遇到其它坑,可以在博客下留言,如果恰好我懂,我会回复。

CSDN博客:http://blog.csdn.net/byb123
个人博客:https://www.wangsansan.com
个人微信公众号:iamwangsansan

欢迎关注公众号

OpenWrt的一些心得_第8张图片


你可能感兴趣的:(OpenWrt,路由器)