# openwrt-image-maker

**Repository Path**: weiweibaba2007/openwrt-image-maker

## Basic Information

- **Project Name**: openwrt-image-maker
- **Description**: 基于openwrt的智能路由器系统镜像修改软件，该软件可以帮助openwrt爱好者基于已有的发布镜像增加/删除用户自己想要的软件，以达到快速制作自己的定制镜像。
- **Primary Language**: Shell
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2015-12-10
- **Last Updated**: 2020-12-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

#openwrt-image-maker

##声明
本人并非openwrt系统专业开发者, 相关知识来自于搜索引擎以及自己摸索开发的经验, 不正确之处请各位行业专家指导。

##简介
基于openwrt的智能路由器系统镜像修改软件，该软件可以帮助openwrt爱好者基于已有的发布镜像增加/删除用户自己想要的软件，以达到快速制作自己的定制镜像。

##运行环境要求
Ubuntu Linux 14.04 64位
其他Linux系统理论上也可以运行使用, 但是各种发行版太多, 本人无精力进行一一验证测试, 有兴趣的朋友可以自行测试验证共享。

##软件包说明
软件包包括一个shell脚本和两个依赖二进制程序, 下载后解压即可使用。
###1、下载软件包
<pre><code>wget http://git.oschina.net/weiweibaba2007/openwrt-image-maker/raw/master/oim.tar.gz</code></pre>
###2、解压软件包
<pre><code>tar xf oim.tar.gz</code></pre>
解压目录结构如下:

<pre><code>- firmware.sh
- bin/
- bin/mksquashfs4
- bin/padjffs2</code></pre>

###3、脚本运行说明
####3.1 安装依赖程序
<pre><code>apt-get install squashfs-tools</code></pre>
####3.2 解压已有的image文件
此处以PandoraBox-ralink-mt7621-pbr-m1-squashfs-sysupgrade-r1807-20151209.bin为例, 用户需自己下载响应的image文件到软件解压目录下。
<pre><code>./firmware.sh e PandoraBox-ralink-mt7621-pbr-m1-squashfs-sysupgrade-r1807-20151209.bin
运行过程如下, 持续约20秒-30秒, 根据系统配置而定。
Starting...
1313238+0 records in
1313238+0 records out
1313238 bytes (1.3 MB) copied, 3.77215 s, 348 kB/s
9958958+0 records in
9958958+0 records out
9958958 bytes (10 MB) copied, 29.0729 s, 343 kB/s
Parallel unsquashfs: Using 1 processor
2164 inodes (2207 blocks) to write

[========================================================================================================================-] 2207/2207 100%
created 1890 files
created 159 directories
created 272 symlinks
created 1 devices
created 0 fifos</code></pre>

解压后新生成：
<pre><code>-kernel.bin                           ------------该文件不要处理, 保持其位置即可.
-squashfs-root/						  ------------我们要定制的是这个目录</code></pre>

####3.3 定制squashfs-root目录内容
此处比较复杂, 后续将撰写教程一一说明，供新手参考。

####3.4 生成定制的image文件
<pre><code>./firmware.sh c oim-1.0.bin          ------------最后一个参数oim-1.0.bin是要生成的image文件名字, 可以自己取名字。</code></pre>

##自定义openwrt Image需要掌握的技能以及相关教程
基于openwrt以及相关的衍生系统(如pandorabox)，内部的结构基本是类似的. 
要定制Image需要掌握如下技能:
###Shell脚本基本知识
###Lua脚本基本知识  这个主要用于定制openwrt的WEB管理控制台
###openwrt的一些相关运行框架

我在后面会逐一写一些教程讲解, 这些知识都是来自于百度搜索以及自己摸索过程中的一些所得。