前言

本项目旨在提供便捷的方式用于编译各种矿渣盒子、外贸机顶盒、路由器、X86的openwrt固件，支持使用github action流水线编译，以及在本地使用docker容器进行编译。 亮点在于本地编译时无需安装和解决各种复杂的环境依赖软件依赖，直接构建一个镜像和容器进行编译，编译完成后可以直接使用docker rm删除镜像和容器，即用即走，不对环境造成任何污染。

支持的能力

• 支持Arm平台、X86平台、MIPS平台的固件编译
• 支持使用Github Action编译，使用Docker进行编译，保证与本地编译环境产物一模一样
• 支持本地编译，本地编译无需准备复杂的环境，只需要一个Linux虚拟机+安装了Docker即可
• 支持版本机制，即可以指定用哪个Commit的代码来进行编译
• 支持将固件安装到云服务器

目录及脚本说明

目录或文件名	说明
.github/workflows	使用Github action编译构建命令，一般不需要改动
scripts	用于存放编译过程中用到的自定义脚本，比如需要希望将某个插件的版本进行更新，或者是加入新的feeds源，都可以在里面进行自定义
scripts/build_with_docker.sh	本地编译时容器启动后执行的脚本，一般无需更改
configs	编译配置
configs/armv8.config	ARM盒子通用简配
configs/armv8_full.config	ARM盒子通用高配
configs/armv8_simple.config	仅包含最最基本的能够让盒子启动和写入到emmc的编译配置，建议可以基于此配置文件去创建你的自定义配置文件
Dockerfile	docker镜像文件，用于本地构建一个编译环境镜像
run_build_use_docker.sh	本地编译的执行脚本

支持的型号列表

vplus

beikeyun

l1pro

rock5b

h88k h68k

r66s r68s

e25

s905 s905d s905x2 s905x3 s912 s922x s922x-n2

qemu

r3g r3p rm2100

编译说明

本项目使用的是coolsnowwolf/lede openwrt库源码、flippy的打包脚本、breakings维护的内核 感谢以上几位大佬。 注：每次全新编译打包默认使用最新的openwrt代码与内核

编译方法

Github Action编译

Fork本项目，然后在Action中启动任务，在界面中可以选择盒子型号和配置，然后进行编译。由于github限制单任务最大时长只能6个小时，而一旦编译配置文件包含了如Node这些大型软件，编译很容易超时，推荐使用下面的本地Docker编译方法

本地Docker编译（推荐）

本地编译命令

./run_build_use_docker.sh -c 配置文件 -d 设备型号 [-p] [-o]
-c: （必填）参数值为使用的配置文件前缀，无需填写.config后缀，如使用armv8.config则只需填armv8
-d：（必填）编译的目标设备型号，具体值参考上面的型号列表，如N1对应s905d、章鱼星球对应s912
-p：（可选、无需填值）表示在已编译出底包的前提下仅进行打包，不做编译操作，节约时间。适用于需要使用同个底包打包出多种盒子镜像的场景
-o：（可选、默认为openwrt_build_tmp）编译过程输出目录文件夹
-n：（可选、默认为openwrt_build）编译时使用的容器名称，默认为openwrt_build

具体用法：使用虚拟机或者在你的云服务器等搭一个linux系统（推荐Ubuntu20+，硬盘空闲空间不小于15G），安装好docker后，clone本项目，然后执行命令，如

./run_build_use_docker.sh -c armv8 -d s905d

armv8.config的配置编译出N1盒子的openwrt固件。

如何自制配置文件

使用虚拟机或者在你的云服务器等搭一个linux系统，安装好docker后，clone本项目，在目录下执行

./run_build_use_docker.sh menuconfig armv8

即可进入固件配置界面，配置完成，会在目录下生成custom.config配置，再执行类似如：

./run_build_use_docker.sh -c armv8 -d s905d

则会使用刚刚生成的自定义配置文件进行编译