使用 OpenWrt 官方源码编译固件

约 950 字大约 3 分钟

openwrt 编译

2025-03-18

官方地址

源码：https://github.com/openwrt/openwrt
固件：https://downloads.openwrt.org

准备工作

依赖

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

直接抄大佬的环境 Requirements

sudo apt update -y
sudo apt full-upgrade -y
sudo apt install -y ack antlr3 asciidoc autoconf automake autopoint binutils bison build-essential \
  bzip2 ccache clang cmake cpio curl device-tree-compiler ecj fastjar flex gawk gettext gcc-multilib \
  g++-multilib git gnutls-dev gperf haveged help2man intltool lib32gcc-s1 libc6-dev-i386 libelf-dev \
  libglib2.0-dev libgmp3-dev libltdl-dev libmpc-dev libmpfr-dev libncurses-dev libpython3-dev \
  libreadline-dev libssl-dev libtool libyaml-dev libz-dev lld llvm lrzsz mkisofs msmtp nano \
  ninja-build p7zip p7zip-full patch pkgconf python3 python3-pip python3-ply python3-docutils \
  python3-pyelftools qemu-utils re2c rsync scons squashfs-tools subversion swig texinfo uglifyjs \
  upx-ucl unzip vim wget xmlto xxd zlib1g-dev zstd

或者

sudo bash -c 'bash <(curl -s https://build-scripts.immortalwrt.org/init_build_environment.sh)'

源码

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

下载源码

git clone -b v24.10.0 --single-branch --depth=1 https://github.com/openwrt/openwrt.git

自定义时区

# 修改时区
sed -i '/set system.@system\[\-1\].timezone=.*/c\        set system.@system[-1].timezone='\''CST-8'\''' package/base-files/files/bin/config_generate
# 设置时区名称
sed -i '/set system.@system\[\-1\].timezone=.*/a\        set system.@system[-1].zonename='\''Asia/Shanghai'\''' package/base-files/files/bin/config_generate

自定义IP

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

sed -i 's/192.168.1.1/10.0.0.2/g' package/base-files/files/bin/config_generate

自定义软件包

将软件包仓库地址写入 feeds.conf.default 文件中

添加 helloworld

sed -i "/helloworld/d" "feeds.conf.default"
echo "src-git helloworld https://github.com/fw876/helloworld.git" >> "feeds.conf.default"

拉取软件包

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

使用 git clone 下载或升级软件包

升级 golang ，helloworld 项目必备

rm -rf feeds/packages/lang/golang
git clone https://github.com/kenzok8/golang feeds/packages/lang/golang

添加 luci-theme-argon

git clone https://github.com/jerrykuku/luci-theme-argon.git feeds/luci/themes/luci-theme-argon

升级 openwrt-smartdns 和 luci-app-smartdns

rm -rf feeds/packages/net/smartdns
git clone https://github.com/pymumu/openwrt-smartdns.git feeds/packages/net/smartdns
rm -rf feeds/luci/applications/luci-app-smartdns
git clone https://github.com/pymumu/luci-app-smartdns.git feeds/luci/applications/luci-app-smartdns

菜单配置

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

make menuconfig

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

配置

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 # 二选一
Libraries
- < > libustream-mbedtls
- <*> libustream-openssl #与 helloworld 保持一致
- < > libustream-wolfssl
LuCI
- Collections
  - <*> luci
- Modules
  - Translations
    - <*> Chinese Simplified
  - <*> luci-compat # helloworld 勾选
- Applications
  - 根据自己的需要选择软件包
Network
- SSH
  - <*>openssh-sftp-server
- <*>snmpd

预下载

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

make download -j8 V=s

编译

执行编译

根据CPU核心数开启指定线程数

make V=s -j$(nproc)

二次编译

# 进入目录
cd openwrt
# 拉取更新
git pull
# 更新系统组件
./scripts/feeds update -a && ./scripts/feeds install -a
# 生成配置文件
make defconfig
# 下载源码文件
make download -j8
# 使用 WSL/WSL2 进行编译
PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
# 执行编译
make V=s -j$(nproc)

如果需要重新配置

# 清除缓存和配置文件
rm -rf ./tmp && rm -rf .config
# 打开配置菜单
make menuconfig
# 下载源码文件
make download -j8 
# 使用 WSL/WSL2 进行编译
PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
# 执行编译
make V=s -j$(nproc)

生成 `seed.config` 文件

make defconfig
./scripts/diffconfig.sh > seed.config

参考

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

【openwrt】openwrt内核编译libustream-openssl出错解决-谷动谷力

使用 OpenWrt 官方源码编译固件

配置

详情