利用 Docker 编译 OpenWrt

由于网络原因编译openwrt时经常下载失败，搭建编译环境也很复杂， 因此想到利用阿里云、Github action等远程构建docker镜像，将编译的下载步骤放在远程进行。

目前还有一个方法就是利用Github action直接远程编译，但这样做有3个问题：

1. 编译需要config文件，生成这个文件又需要下载一些库，这就造成了循环=。=。而通过docker你拉下来的镜像中已经下好了所有库，不需要下载。
2. 如果你要对config进行一些小的改动，通过Github action就需要从头开始编译。而利用docker镜像可以直接进入docker容器修改文件后编译，不需从头开始。
3. Github action有一定学习成本，而dockerfile和shell差不多，就算没接触过过也能快速上手

开始之前

本教程所有代码在：

• https://github.com/gojuukaze/openwrt-build
• https://gitee.com/gojuukaze/openwrt-build

关于Docker的一些概念，以及如何使用阿里云、Github action等来构建docker镜像不在本教程范围，你可以自行学习。

编译步骤

首选说明下，我是分成了4个镜像来编译的，base , v1 , v2 , v3 ，你完全可以只构建一个镜像。

这样的好处是有些镜像可以重复利用，编译有问题时可以使用上一步的镜像来再次构建，避免从头开始。

每个镜像说明：

1. 构建 base

使用 Dockerfile 构建 base 镜像，此镜像是基于 immortalwrt/opde:base 在此基础上通过immortalwrt的脚本更新了一些包。

# base
FROM immortalwrt/opde:base
USER opde:opde
ENV HOME /home/opde
WORKDIR /home/opde
RUN wget https://build-scripts.immortalwrt.eu.org/init_build_environment.sh
RUN chmod +x /home/opde/init_build_environment.sh
RUN sudo /home/opde/init_build_environment.sh

理论上来说，这个镜像能用于编译其他openwrt系统，不过建议在dockerfile的最后再安装一次你系统所需的包

2. 构建 v1

使用 Dockerfile_1 构建 v1 镜像，这个镜像主要clone代码，执行update与install。

如果你不用immortalwrt系统，修改代码的地址。

# v1
FROM xx/openwrt-build:base
USER opde:opde
ENV HOME /home/opde
WORKDIR /openwrt
# 修改代码的地址
RUN git clone -b v21.02.3 --single-branch https://github.com/immortalwrt/immortalwrt
WORKDIR /openwrt/immortalwrt
RUN ./scripts/feeds update -a 
RUN ./scripts/feeds install -a

2. 构建 v2

使用 Dockerfile_2 构建 v2 镜像，这个镜像主要进行make前的最终准备修改（修改源码，添加功能，再次执行update与install）。

# v2
FROM xx/openwrt-build:v1
USER opde:opde
ENV HOME /home/opde
WORKDIR /openwrt/immortalwrt

COPY imm_patch /openwrt/immortalwrt/imm_patch
RUN sudo chown -R opde:opde /openwrt/immortalwrt/imm_patch
# 修改代码，增加一些功能。可以根据你的需求添加
RUN git apply imm_patch/wan_ACCEPT.patch

# 软件包
RUN sed -i '$a src-git kenzo https://github.com/kenzok8/openwrt-packages' feeds.conf.default
RUN sed -i '$a src-git small https://github.com/kenzok8/small' feeds.conf.default
# 修改默认ip为 192.168.2.1
RUN sed -i 's/192.168.1.1/192.168.2.1/g' package/base-files/files/bin/config_generate
# 时区
RUN sed -i "s/'UTC'/'CST-8'\n   set system.@system[-1].zonename='Asia\/Shanghai'/g" package/base-files/files/bin/config_generate

RUN rm -rf /openwrt/immortalwrt/imm_patch
RUN ./scripts/feeds update -a 
RUN ./scripts/feeds install -a

RUN ./scripts/feeds install lm-sensors
RUN ./scripts/feeds install luci-app-samba4
RUN ./scripts/feeds install wsdd2
RUN ./scripts/feeds install luci-lib-base
RUN ./scripts/feeds install luci-proto-ipv6
RUN ./scripts/feeds install wget-ssl
RUN ./scripts/feeds install liblzma
RUN ./scripts/feeds install libnetsnmp
RUN ./scripts/feeds install libcap
RUN ./scripts/feeds install libpam
# 检查下是否还有报错
RUN ./scripts/feeds install -a

• 这里有的代码我是通过 git patch 来修改的，你也可以通过sed或其他方式来修改，或者最后一步编译前拉取镜像本地修改。

• 如果你要使用我的patch，请注意：我的patch是基于Orange Pi - R1 Plus LTS以及immortalwrt 21.02修改的，这些patch不一定适用于你，请甄别后使用。

  每个patch说明如下：

  • add_pwm_fan.sh.patch : 风扇脚本。我的板子用这个脚本风扇会滋滋响，如果你有同样问题，取消这个试试。
  • resizing_filesystem_at_first_boot.patch : 首次启动时扩展分区。注意这个依赖bash、f2fsck等命令，需要在config中添加。这个我测试有问题，因此我采用的是开机后手动执行一次 resize_rootfs.sh (这个脚本在仓库里)
  • wan_ACCEPT.patch : 允许通过wan的ip口登录。immortalwrt默认只能通过lan口登录。
  • swap_wan_and_lan.patch : wan lan口互换
  • 1.5g.patch : cpu超频至1.5g

  这些path是从 R1-Plus-LTS 复制的，有问题请向他反馈

• Dockerfile_2 最后单独install了几个包，这是因为我在执行./scripts/feeds install -a 会出现这个warning 287#9 2.046 WARNING: Makefile 'package/utils/busybox/Makefile' has a dependency on 'libpam', which does not exist。
  如果你的没报错可以删除这几个install。

3. 创建config

docker run xxx/openwrt-build:v2 zsh

make menuconfig

创建完后通过docker cp把.config复制到本地并上传仓库

4. 构建 v3，编译系统

使用 Dockerfile_3 构建 v3 镜像，这个镜像就是执行最终的编译了。

# v3 复制config，并下载依赖
FROM xx/openwrt-build:v2
USER opde:opde
ENV HOME /home/opde
WORKDIR /openwrt/immortalwrt

COPY config_1 /openwrt/immortalwrt/.config
RUN sudo chown opde:opde /openwrt/immortalwrt/.config
RUN make defconfig
RUN make download -j$(nproc)
# 这里我是本地编译
# RUN make V=s -j$(nproc)

• 由于远程编译可能会因时间太久而被判断为超时，且我本地性能更好。因此这里我选择只执行make download，构建镜像后拉取到本地编译的，你可以根据需要自行选择。

• 如果你选择本地编译，需要注意：

  1. 这一步仍然可能需要下载一些包，这取决于你的config文件。不过一般这些下载一般不会太慢，如果你这一步卡了，可以ctrl-c后再编译，一般都能下载成功。

  2. 建议你修改下go以及npm的源，你config中有的选项可能依赖它们。

     export GOSUMDB=off
     export GO111MODULE=on
     export GOPROXY=https://goproxy.cn
     
     npm config set registry http://registry.npmmirror.com

执行make V=s时有的教程建议首次编译时添加-j 1，这是为了更好的发现编译错误。
但如果你满足下面条件，首次完全可以多线程编译的。

1. 对源码改动不是更大。
2. 你的硬件之前有人编译成功或受官方支持。
3. config中没有选择太多或偏门选项。

多线程编译时，若这一步需要下载文件，下载进度条可能无法正确显示。如果你看到一直卡主不动，或是有数字一直闪烁且没有变化那多半是下载卡主了，直接终止后重新编译。

5. 从docker中取出镜像

最终的系统镜像是在 bin/targets/xx 下，通过docker cp取出来。（若非本地编译你需要先运行镜像）。

另，取出的镜像不用解压，可以直接写入tf卡。