使用 OpenWrt 24.10.2 官网源码编译固件

创建日期：2023/04/05 修改日期：2025/07/08 OpenWrt

> 1. 下文以官方 24.10.2 为例
> 2. 下文以为 x86 架构编译为例，若为其他平台（路由器、树莓派等其他架构）则下文中获取内核的魔法值、菜单配置需自行更改

# 前言

用过大佬编译好的固件，也自己基于大佬的固件手动编译，最终还是决定用官方的源码编译，只加入自己想要的软件

相关链接：

- 源码：[https://github.com/openwrt/openwrt](https://github.com/openwrt/openwrt)
- 固件：[https://downloads.openwrt.org](https://downloads.openwrt.org)

# 准备工作

## 环境

- 系统：Debian 12 x64位系统
- 网络：可以访问外网（**国内请全局科学上网**）
- 磁盘：大约有 50G 的空闲空间
- 内存：至少 4G 物理内存
- CPU：越快越好，影响编译速度

## 依赖

以 `root` 用户执行以下命令或者有 `root` 权限的用户

```bash
sudo apt-get -y update
sudo apt-get -y install ack antlr3 aria2 asciidoc autoconf automake autopoint binutils bison build-essential \
bzip2 ccache cmake cpio curl device-tree-compiler fastjar flex gawk gettext gcc-multilib g++-multilib \
git gperf haveged help2man intltool libc6-dev-i386 libelf-dev libglib2.0-dev libgmp3-dev libltdl-dev \
libmpc-dev libmpfr-dev libncurses5-dev libncursesw5-dev libreadline-dev libssl-dev libtool lrzsz \
mkisofs msmtp nano ninja-build p7zip p7zip-full patch pkgconf python3 python3-pip libpython3-dev qemu-utils \
rsync scons squashfs-tools subversion swig texinfo uglifyjs upx-ucl unzip vim wget xmlto xxd zlib1g-dev
```

## 源码

以下命令以普通用户执行，不要用 `root`

```bash
# 下载源码（-b 指定分支/标签、 --single-branch 仅下载单个分支/标签、 --depth=1 只下载最新的一次提交 ）
git clone -b v24.10.2 --single-branch --depth=1 https://github.com/openwrt/openwrt.git
# 进入到该目录
cd openwrt
```

# 配置

## 时区

```bash
# 编辑配置文件
vim package/base-files/files/bin/config_generate +315
# 修改时区为 CST-8
set system.@system[-1].timezone='CST-8'
# 再在下一行添加如下内容
set system.@system[-1].zonename='Asia/Shanghai'
```

修改完成后效果如下：

![](https://cdn2.maxqiu.com/upload/db888fedc0a74556ab127eeee7268cd0.png)

## 默认IP

默认管理IP为 `192.168.1.1` ，可以根据自己的需求进行修改

```bash
# 编辑配置文件
vim package/base-files/files/bin/config_generate +165
# 修改如下内容
lan) ipad=${ipaddr:-"192.168.188.1"} ;;
```

修改完成后效果如下：

![](https://cdn2.maxqiu.com/upload/180bf37e65964258b7a236bedb712503.png)

## 软件包

### 系统软件包

默认情况下，系统 `feeds.conf.default` 配置的下载地址是 `git.openwrt.org` ，该地址下载较慢，可以切换到 `GitHub` 下载

编辑配置文件

```bash
vim feeds.conf.default
```

删除所有内容，粘贴如下内容并保存

```
src-git packages https://github.com/openwrt/packages.git^c7d1a8c1ae976bd0ad94a351d82ee8fbf16a81f0
src-git luci https://github.com/openwrt/luci.git^d6b13f648339273facc07b173546ace459c1cabe
src-git routing https://github.com/openwrt/routing.git^85d040f28c21c116c905aa15a66255dde80336e7
src-git telephony https://github.com/openwrt/telephony.git^2a4541d46199ac96fac214d02c908402831c4dc6
```

### 三方软件包

添加第三方软件有两种方式：

1. 将软件包仓库地址写入 `feeds.conf.default` 文件中，可以参考当前目录下的 `feeds.conf.default` 文件
2. 使用 `git clone` 手动下载软件包放入到 `package` 文件夹中

### 更新软件包

执行以下代码更新 `feeds` 包

```bash
./scripts/feeds update -a
./scripts/feeds install -a
```

## 菜单配置

执行以下命令打开菜单配置

```bash
make menuconfig
```

终于来到了一个图形化界面，该界面有如下操作

- `↑ ↓` 键：上下切换
- `PgUp PgDn` 键：上下翻页
- `Enter` 回车键：
  - 进入子菜单
  - 选择/确认
- `Y` 键：选中，在 `< >` 上进行操作，操作后变为 `<*>`
- `N` 键：取消选中，在 `<*>` 上进行操作，操作后变为 `< >`
- `Esc` 键：连击两下，返回上层菜单，如果在主菜单则为退出配置

按照如下配置进行选择，其他未说明的不要动

- Target System -> x86
- Subtarget -> x86_64
- Target Images
  - < > tar.gz
  - < > ext4
  - < > Build GRUB images
  - (1) Seconds to wait before booting the default entry
  - (256) Root filesystem partition size
- Base system
  - < > dnsmasq
  - <*> dnsmasq-full
- LuCI
  - Collections
    - <*> luci
  - Modules
    - Translations
      - <*> Chinese Simplified
  - Applications
    - 根据自己的需要选择软件包

如果不小心配错了，可以执行以下命令重新配置

```bash
rm -rf ./tmp && rm -rf .config
make menuconfig
```

## 预下载

这里会先把编译时要下载的文件下载下来（只是一部分，后面编译阶段还会下载，仍需保持网络畅通）

```bash
make download -j8 V=s
```

# 编译

接下来就要进入漫长的编译时间了，使用 `-j` 参数可以指定编译时使用的线程数

亲测笔记本 `i7-8750H` 12线程全开需要接近2小时完成，单线程需要4-5小时

```bash
# 根据CPU核心数开启指定线程数执行编译
make V=s -j$(nproc)
# 如果编译过程中报错了，需要使用单线程模式，确认出错的地方，然后排查（注：有时候单线程就不报错了）
make V=s -j1
```

# 获取成果

编译完成后，镜像文件地址是：`./bin/targets/x86/64/openwrt-x86-64-generic-squashfs-combined-efi.img.gz`

下载到本地后需要先解压

```bash
# 如果是PVE中安装，上传 .img 文件后，可以使用以下命令导入镜像文件
qm importdisk 100 /var/lib/vz/template/iso/openwrt-x86-64-generic-squashfs-combined-efi.img local
```

8298

全部评论

一丈青-扈三娘2024/04/15 15:23:50

/usr/lib/lua/luci/view/admin_status/index.htm这个文件op 23.05没有了，23.05怎么加首页温度信息啊，大佬知道吗
管理员回复一丈青-扈三娘2024/04/15 15:26:29

不知道
摩云金翅-欧鹏2024/05/14 10:31:11

我按照步驟進行操作，但最終仍然出現無法編譯的錯誤： package/Makefile:111: 目標「/openwrt/staging_dir/target-aarch64_cortex-a55+neon-vfpv4_musl/stamp/.package_install」的配方失敗
管理员回复摩云金翅-欧鹏2024/05/14 10:36:43

抱歉，没办法帮到你，我这边x86和xdr6088都可以正常编译
铁臂膊-蔡福2025/03/09 19:17:14

有用的文章。有技术。小白值得一试。thanks