OpenWrt 编译步骤与命令详解

来源 https://p3terx.com/archives/openwrt-compilation-steps-and-commands.html

 

前言

编译 Open­Wrt 的过程就像是复读机，除了选择系统组件外，几乎每次编译都是复制粘贴相同的命令。而理解每一条命令的作用、什么时候该去执行，这样才能更好的去解决编译中遇到的问题，更顺利的编译出固件。

下载资源站点 http://182.140.223.146/dl/ 

golang module 代理站点 https://goproxy.io/

首次编译

• 克隆 Open­Wrt 源码

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

  这里以 Lean 大佬的源码仓库为例子，毕竟很多人都在用它。命令末尾加了openwrt是指克隆代码到openwrt目录，目的是为了规范化，因为有时并不是编译这个的源码。

• 进入源码目录

  cd openwrt

• 下载 feeds 源中的软件包源码

  ./scripts/feeds update -a

  feeds 是扩展的软件包，独立于 Open­Wrt 源码之外，所以需要单独进行拉取和更新。

• 安装 feeds 中的软件包

  ./scripts/feeds install -a

• 调整 Open­Wrt 系统组件

  make menuconfig

  首次编译建议只选择架构，其它都不要动，这样编译成功率会更高。如果不打算调整组件则输入make defconfig，它会检测编译环境并生成默认的编译配置文件。

• 预下载编译所需的软件包

  make download -j8 V=s

  -j8是指使用8个线程下载，理论上是数字越大下载越快，但似乎有个上限，实测5线程以上其实速度相差不了多少，在网络好的情况下，基本在5分钟以内能下载完。

• 检查文件完整性

  find dl -size -1024c -exec ls -l {} \;

  此命令可以列出下载不完整的文件（根据我多次编译的经验得出小于1k的文件属于下载不完整），如果存在这样的文件可以使用find dl -size -1024c -exec rm -f {} \;命令将它们删除，然后重新执行make download下载并反复检查，确认所有文件完整可大大提高编译成功率，避免浪费时间。

• 开始编译

  make -j1 V=s

  -j1：使用单线程编译。新手推荐单线程编译，一是因为玄学问题可能成功率高，二是方便查看错误日志。

   

  V=s：输出详细日志，用于编译失败时找出错误。而且满屏代码在跑能装逼，一跑就是几个小时，装逼更持久。

再次编译

• 进入源码目录（如果不在此目录）

  cd openwrt

更新

TIPS： 短期内再次编译可忽略更新这个步骤。

• 更新系统软件包

  sudo sh -c "apt update && apt upgrade -y"

  主要作用是更新在编译环境搭建时所安装的编译组件

• 拉取 Open­Wrt 源码更新

  git pull

• 更新 feeds 源中的软件包源码

  ./scripts/feeds update -a

• 安装 feeds 中的软件包

  ./scripts/feeds install -a

文件清理

• 清除旧的编译产物（可选）

  make clean

  在源码有大规模更新或者内核更新后执行，以保证编译质量。此操作会删除/bin和/build_dir目录中的文件。

• 清除旧的编译产物、交叉编译工具及工具链等目录（可选）

  make dirclean

  更换架构编译前必须执行。此操作会删除/bin和/build_dir目录的中的文件(make clean)以及/staging_dir、/toolchain、/tmp和/logs中的文件。

• 清除 Open­Wrt 源码以外的文件（可选）

  make distclean

  除非是做开发，并打算 push 到 GitHub 这样的远程仓库，否则几乎用不到。此操作相当于make dirclean外加删除/dl、/feeds目录和.config文件。

• 还原 Open­Wrt 源码到初始状态（可选）

  git clean -xdf

  如果把源码改坏了，或者长时间没有进行编译时使用。

• 清除临时文件

  rm -rf tmp

  删除执行make menuconfig后产生的一些临时文件，包括一些软件包的检索信息，删除后会重新加载package目录下的软件包。若不删除会导致一些新加入的软件包不显示。

• 删除编译配置文件

  rm -f .config

  在不删除的情况下如果取消选择某些组件它的依赖组件不会自动取消，所以对于需要调整组件的情况下建议删除。

编译

• 调整 Open­Wrt 系统组件

  make menuconfig

  如果不打算调整组件则输入make defconfig，它会检测编译环境并根据更新自动调整编译配置文件。

• 预下载编译所需的软件包

  make download -j8 V=s

• 检查文件完整性

  find dl -size -1024c -exec ls -l {} \;

  此命令可以列出下载不完整的文件（根据我多次编译的经验得出小于1k的文件属于下载不完整），如果存在这样的文件可以使用find dl -size -1024c -exec rm -f {} \;命令将它们删除，然后重新执行make download下载并反复检查，确认所有文件完整可大大提高编译成功率，避免浪费时间。

• 开始编译

  make -j$(nproc) || make -j1 || make -j1 V=s

  多线程编译失败后自动进入单线程编译，失败则输出详细日志。

尾巴

很少有人会告诉你为什么要这样做，而是会要求你必须要这样做。

 

 

2020.2.17小白mj写给麻瓜看的复读机编译教程 v2.0

2020.2.17更新DL，OpenWrt R20.2.15 By Lean

虚拟机先安装Vmtools和SSH:
sudo apt-get update
sudo apt-get install openssh-server open-vm-tools-desktop -y
sudo reboot

———————————————————————————————————————————————————————————————————————————————————————————————————————————

大雕编译教程：

注意：
1. 不要用 root 用户 git 和编译！！！
2. 国内用户编译前最好准备好梯子
3. 默认登陆IP 192.168.1.1, 密码 password

编译命令如下:

1. 首先装好 Ubuntu 64bit，推荐 Ubuntu 14 LTS x64
http://releases.ubuntu.com/14.04.5/ubuntu-14.04.5-desktop-amd64.iso

2. 命令行输入 sudo apt-get update ，然后输入 (2019.11.1 update)
sudo apt-get -y install build-essential asciidoc binutils bzip2 gawk gettext git libncurses5-dev libz-dev patch unzip zlib1g-dev lib32gcc1 libc6-dev-i386 subversion flex uglifyjs git-core gcc-multilib p7zip p7zip-full msmtp libssl-dev texinfo libglib2.0-dev xmlto qemu-utils upx libelf-dev autoconf automake libtool autopoint device-tree-compiler python3.5

3. git clone https://github.com/coolsnowwolf/lede 命令下载好源代码，然后 cd lede 进入目录

4. ./scripts/feeds update -a
./scripts/feeds install -a
make menuconfig

5. 最后选好你要的路由，输入 make -j1 V=s （-j1后面是线程数。第一次编译推荐用单线程，国内请尽量全局挂机场）即可开始编译你要的固件了。

———————————————————————————————————————————————————————————————————————————————————————————————————————————

以后二次编译：
cd lede 进入LEDE目录
git pull 同步更新大雕源码
./scripts/feeds update -a && ./scripts/feeds install -a 更新FEEDS
rm -rf ./tmp && rm -rf .config 清除编译配置和缓存
make menuconfig 进入编译配置菜单
make -jn V=s n=线程数+1，例如4线程的I5填-j5，开始编译

编译完成后输出路径
固件：/lede/bin/targets
插件：/lede/bin/packages

———————————————————————————————————————————————————————————————————————————————————————————————————————————

建议：
编译机最好100G起步，全局梯子
编译前下载好DL包，可大量缩减首次编译时间
此DL包，不定期更新，可编译X64固件
链接: https://pan.baidu.com/s/1dy4L8b775NRCApd8mXZ9Cg 密码: mjdl

以下操作请把mj替换为自己的用户名
DL包：
如果存在/home/mj/lede/dl目录，请删除
WINSCP上传dl.tgz放进/home/mj 目录下，右键-文件自定义命令-Untar/Gzip，直接回车，解压出DL文件夹后，执行以下命令
ln -s /home/mj/dl /home/mj/lede

涡轮增雕法：(可编译大雕源码里没有或者已删除的插件)
WINSCP上传diy.tgz放进/home/mj 目录下，右键-文件自定义命令-Untar/Gzip，直接回车，解压出diy文件夹后，执行以下命令
ln -s /home/mj/diy /home/mj/lede/package/openwrt-packages
这样编译时就会加载/package/lean和/package/openwrt-packages（量子领域），如果这2个文件夹里的插件包同名则优先编译/package/lean里的插件
使用涡轮增雕法，可通过在量子领域里把插件打包回去编译，例如KPR，Verysync，Serverchan，BaiduPCS-Web

———————————————————————————————————————————————————————————————————————————————————————————————————————————

编译切换内核：
打开LEDE目录/target/linux/架构/Makefile
KERNEL_PATCHVER:=4.9
具体支持内核版本
include/kernel-version.mk

源码回退：
git log 查看源码更新日志
git reset --hard HEAD^ 回退到上个版本
git reset --hard HEAD~3 回退到前3次提交之前，以此类推，回退到n次提交之前
git reset --hard commit_id 退到/进到 指定commit的sha码（可到大雕源码地址直接查询）

单独编译某个插件:
make menuconfig
在编译配置菜单中选择luci-app-unblockmusic
make package/luci-app-unblockmusic/{clean,compile} V=s

files大法：就是把你 改好的配置 直接编译进固件
这样做的好处就是升级不需要保留配置，或者恢复出厂设置，缺省值就是你自己设置好的配置
固化某配置教程例子：
1.提取路由固件下的\etc\config\network
2.在编译机LEDE根目录下创建files目录
3.拷贝到\files\etc\config\network
这样编译完，network就是你自己配置好的network，注意提取的文件路径和权限要一致

一些常用的配置，路由器路径
\etc\config 各个LUCI配置
\etc\shadow 登录密码
\etc\firewall.user 自定义防火墙规则
\usr\share\adbyby adbyby里的相关规则和设置
\usr\lib\lua\luci\view\admin_status\index.htm 主页样式文件，温度显示等等
X86架构固件的index，默认被大雕files强奸了，自己到源码里替换/lede/package/lean/autocore/files/index.htm
如果无效请make clean或者删除/lede/build_dir/target架构/autocore-1（编译其他失败同理）

Github团队协作之Pull请求
https://www.cnblogs.com/cposture/p/4903767.html

 

================ End