本地编译
- 首先是注意事项
首先装好 Ubuntu 64bit,推荐 Ubuntu 22.04
不要用 root 用户 git 和编译!!!
国内用户编译前最好准备好软件源下载加速
默认登陆IP 192.168.1.1, 密码 password - 安装编译依赖
1 | sudo apt update -y |
- 下载源代码,更新 feeds 并选择配置
1 | git clone https://github.com/coolsnowwolf/lede |
- 下载 dl 库,编译固件
(-j 后面是线程数,第一次编译推荐用单线程)
1 | make download -j8 |
- 二次编译:
1 | cd lede |
- 如果需要重新配置:
1 | rm -rf .config |
- 编译完成后输出路径:bin/targets
- 原文链接:https://github.com/coolsnowwolf/lede
openwrt编译步骤与命令详解
首次编译
- 克隆 OpenWrt 源码
1
git clone https://github.com/coolsnowwolf/lede openwrt
- 进入源码目录
1
cd openwrt
- 下载 feeds 源中的软件包源码
1
./scripts/feeds update -a
feeds 是扩展的软件包,独立于 OpenWrt 源码之外,所以需要单独进行拉取和更新。
- 克隆 OpenWrt 源码
安装 feeds 中的软件包
1
./scripts/feeds install -a
调整 OpenWrt 系统组件
1
make menuconfig
首次编译建议只选择架构,其它都不要动,这样编译成功率会更高。如果不打算调整组件则输入make defconfig,它会检测编译环境并生成默认的编译配置文件。
生成当前配置与默认配置的差异
1
./scripts/diffconfig.sh > diffconfig
预下载编译所需的软件包
1
make download -j8 V=s
-j8是指使用8个线程下载,理论上是数字越大下载越快,但似乎有个上限,实测5线程以上其实速度相差不了多少,在网络好的情况下,基本在5分钟以内能下载完。
检查文件完整性
1
find dl -size -1024c -exec ls -l {} \;
此命令可以列出下载不完整的文件(根据我多次编译的经验得出小于1k的文件属于下载不完整),如果存在这样的文件可以使用find dl -size -1024c -exec rm -f {} ;命令将它们删除,然后重新执行make download下载并反复检查,确认所有文件完整可大大提高编译成功率,避免浪费时间。
开始编译
1
make -j1 V=s
-j1:使用单线程编译。新手推荐单线程编译,一是因为玄学问题可能成功率高,二是方便查看错误日志。
V=s:输出详细日志,用于编译失败时找出错误。而且满屏代码在跑能装逼,一跑就是几个小时,装逼更持久。再次编译
进入源码目录(如果不在此目录)
1
cd openwrt
更新
TIPS: 短期内再次编译可忽略更新这个步骤。
- 更新系统软件包
1
sudo sh -c "apt update && apt upgrade -y"
主要作用是更新在编译环境搭建时所安装的编译组件
- 拉取 OpenWrt 源码更新
1
git pull
- 更新 feeds 源中的软件包源码
1
./scripts/feeds update -a
- 安装 feeds 中的软件包
1
./scripts/feeds install -a
- 更新系统软件包
文件清理
- 清除旧的编译产物(可选)
1
make clean
在源码有大规模更新或者内核更新后执行,以保证编译质量。此操作会删除/bin和/build_dir目录中的文件。
- 清除旧的编译产物、交叉编译工具及工具链等目录(可选)
1
make dirclean
更换架构编译前必须执行。此操作会删除/bin和/build_dir目录的中的文件(make clean)以及/staging_dir、/toolchain、/tmp和/logs中的文件。
- 清除 OpenWrt 源码以外的文件(可选)
1
make distclean
除非是做开发,并打算 push 到 GitHub 这样的远程仓库,否则几乎用不到。此操作相当于make dirclean外加删除/dl、/feeds目录和.config文件。
- 还原 OpenWrt 源码到初始状态(可选)
1
git clean -xdf
如果把源码改坏了,或者长时间没有进行编译时使用。
- 清除临时文件
1
rm -rf tmp
删除执行make menuconfig后产生的一些临时文件,包括一些软件包的检索信息,删除后会重新加载package目录下的软件包。若不删除会导致一些新加入的软件包不显示。
- 删除编译配置文件
1
rm -f .config
在不删除的情况下如果取消选择某些组件它的依赖组件不会自动取消,所以对于需要调整组件的情况下建议删除。
- 清除旧的编译产物(可选)
编译
- 调整 OpenWrt 系统组件
1
make menuconfig
如果不打算调整组件则输入make defconfig,它会检测编译环境并根据更新自动调整编译配置文件。
- 预下载编译所需的软件包
1
make download -j8 V=s
- 检查文件完整性
1
find dl -size -1024c -exec ls -l {} \;
此命令可以列出下载不完整的文件(根据我多次编译的经验得出小于1k的文件属于下载不完整),如果存在这样的文件可以使用find dl -size -1024c -exec rm -f {} ;命令将它们删除,然后重新执行make download下载并反复检查,确认所有文件完整可大大提高编译成功率,避免浪费时间。
- 开始编译
1
make -j$(nproc) || make -j1 || make -j1 V=s
多线程编译失败后自动进入单线程编译,失败则输出详细日志。
- 调整 OpenWrt 系统组件
原文链接:https://p3terx.com/archives/openwrt-compilation-steps-and-commands.html
在线云编译
P3TERX方案
- 前提
1、已经会本地编译
2、有GitHub账号 - 第一步
打开自己本地编译目录,先和大屌源码同步一下然后执行1
2
3git pull
./scripts/feeds update -a
./scripts/feeds install -amake menuconfig
选好后执行这样配置的差异部分就写入这个文件了1
2make defconfig
./scripts/diffconfig.sh > seed.config - 第二步
1、打开https://github.com/P3TERX/Actions-OpenWrt
fork这个项目
2、之后在自己fork出来的项目里的网页里创建一个新文件(点击Create new file).conifg
3、然后把前面提到的seed.config文件的内容粘贴进来
4、其它修改化设置可以查看https://p3terx.com/archives/build-openwrt-with-github-actions.html
- 第三步
1、在Actions
页面可以手动开始编译了
2、固件下载在Actions--Build OpenWrt--Artifacts--OpenWrt firmware
- 原文链接:https://github.com/coolsnowwolf/lede/issues/2288
KFERMercer方案
- fork https://github.com/coolsnowwolf/lede 仓库
- 在
.github/workflows/
下创建工作流文件openwrt-CI.yml
- 代码内容为:如需定制,代码内有详细说明
1 | name: OpenWrt-CI |
- 个人在原仓库代码的基础上做了少量修改及加入备注,以符合个人需求
- 仓库地址:https://github.com/KFERMercer/OpenWrt-CI
在线自动生成固件
- https://firmware-selector.openwrt.org/
- https://firmware-selector.immortalwrt.org/
- https://openwrt.ai/
插件中英文对照
1 | luci-app-clash # clash科学上网(基本上没用的了,已经给luci-app-openclash代替) |