前言

恩山论坛上有很多用户编译好的现成固件,自己编译固件最大的优势是可以根据需求更好的自定义,建议没有特别需求的用户还是直接选用现成的固件即可。编译固件也是一种乐趣,整个过程大约1-3小时左右,需要耐心等待。

环境要求

  1. 系统版本

    Debian 11 或者 Ubuntu LTS

  2. 网络要求

    最好是境外主机或者能够访问国际网络,大陆网络环境编译失败率较高,配置推荐 2H4G 以上

  3. 编译依赖

    # 升级
    sudo apt update -y
    sudo apt full-upgrade -y
    # 安装依赖
    sudo apt install -y 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 python2.7 python3 python3-pip libpython3-dev qemu-utils \
    rsync scons squashfs-tools subversion swig texinfo uglifyjs upx-ucl unzip vim wget xmlto xxd zlib1g-dev
    # 清理
    sudo apt autoremove --purge
    sudo apt clean
    

开始编译

  1. 新建一个用户,用于编译固件
    useradd -m openwrt  # 新建一个名为 openwrt 的用户
    
    # 修改用户默认的 Shell
    apt install -y sudo
    usermod -s /bin/bash openwrt
    
    # 切换用户
    su openwrt
    cd ~
    
  2. 拉取源码,这里用的是 Lean 大佬的 LEDE 分支源码
    git clone https://github.com/coolsnowwolf/lede
    cd lede
    
  3. 添加软件源,L大源码里默认有四个软件源里面包含了大部分常用插件,如果要添加其他没有的插件则需要自行添加软件源至 feeds.conf.default 文件,当然也可以单独添加某个插件
    vim feeds.conf.default
    
    # 添加软件源(打开下方仓库链接可以查看包含的插件列表,一般选前两个源就行)
    src-git kenzo https://github.com/kenzok8/openwrt-packages
    src-git small https://github.com/kenzok8/small
    src-git haibo https://github.com/haiibo/openwrt-packages
    src-git liuran001 https://github.com/liuran001/openwrt-packages
    
    # 单独添加(在更新并安装插件之前执行)
    ## 主题
    rm -rf package/lean/luci-theme-argon
    git clone -b 18.06 https://github.com/jerrykuku/luci-theme-argon.git package/lean/luci-theme-argon
    ## 插件
    git clone https://github.com/esirplayground/luci-app-poweroff.git package/luci-app-poweroff
    
    # 更新并安装插件
    ./scripts/feeds clean
    ./scripts/feeds update -a
    ./scripts/feeds install -a
    

  4. 自定义配置

    # 修改默认IP为 10.0.0.2
    sed -i 's/192.168.1.1/10.0.0.2/g' package/base-files/files/bin/config_generate
    
    # 修改默认主机名
    sed -i '/uci commit system/i\uci set [email protected][0].hostname='Soft_Router'' package/lean/default-settings/files/zzz-default-settings
    
    # 加入编译者信息
    sed -i "s/OpenWrt /Kinoko build $(TZ=UTC-8 date "+%Y.%m.%d") @ OpenWrt /g" package/lean/default-settings/files/zzz-default-settings
    
    # 修改默认主题
    sed -i "s/luci-theme-bootstrap/luci-theme-argon/g" feeds/luci/collections/luci/Makefile
    
  5. 执行 make menuconfig 命令进入编译菜单

    菜单选项简要说明:

    # 选择 CPU 类型
    Target System (x86) --> # 软路由选择 x86,硬路由根据型号厂家自行选择
    Subtarget (x86_64) --> # CPU 子选项
    Target Profile (Generic x86/64) --> # 厂家具体型号
    
    # 设置镜像编译的格式(squashfs,ext4)
    Target Images --> # 默认 squashfs
    
    # 添加较多插件时,为了避免空间不足,建议修改下面两项默认大小(x86/64)
    Target Images --> (16) Kernel partition size (in MB) # 默认是16,建议修改为256
    Target Images --> (400) Root filesystem partition size (in MB) # 默认是400,建议修改为512
    
    # 开启 IPv6 支持
    Extra packages --> ipv6helper(选定这个后,下面几项会自动选择)
    Network --> odhcp6c
    Network --> odhcpd-ipv6only
    LuCI --> Protocols --> luci-proto-ipv6
    LuCI --> Protocols --> luci-proto-ppp
    
    # 开启适用于 VMware 的 VMware Tools
    Utilities --> open-vm-tools
    Utilities --> open-vm-tools-fuse
    
    # 选择插件
    LuCI --> Applications # 根据需要选择,* 代表编入固件,M 表示编译成模块或者IPK包,为空表示不编译
    
    # 选择主题
    LuCI --> Themes # 选择喜欢的主题,可以选多个
    
    # 其他选项一般不需要调整,如感兴趣可以自行了解
    

    插件中文说明对照表:https://www.right.com.cn/forum/thread-3682029-1-1.html

  6. 配置完成后使用编译菜单底部的 Save 保存,然后退出菜单 Exit,开始下载软件包

    # 预下载编译所需的软件包
    make download -j8
    # 检查文件完整性
    find dl -size -1024c -exec ls -l {} \;
    # 检查文件完整性命令可以列出下载不完整的文件,小于1k的文件属于下载不完整,如果存在则用下面的命令删除,然后重新下载编译所需的软件包,再次检查
    # 确认所有文件完整可大大提高编译成功率,避免浪费时间
    find dl -size -1024c -exec rm -f {} \;
    
  7. 最后编译固件,编译完成后输出路径是 bin/targets,默认密码是 password
    # 编译固件(-j 后面是线程数,首次编译推荐用单线程)
    make V=s -j1
    

二次编译

  1. 拉取最新 OpenWrt 源码和更新 feeds 源中的软件包源码
    cd lede
    git pull
    ./scripts/feeds update -a
    ./scripts/feeds install -a
    
  2. 清除旧的编译产物和目录(可选)
    make clean
    # 源码有大规模更新或者内核更新后执行,以保证编译质量
    # 此操作会删除 /bin 和 /build_dir 目录中的文件
    
    make dirclean
    # 更换架构编译前必须执行
    # 此操作会删除 /bin 和 /build_dir 目录的中的文件(make clean),以及 /staging_dir、/toolchain、/tmp 和 /logs 中的文件
    
  3. 同首次编译,多线程编译失败后自动进入单线程编译,失败则输出详细日志
    make defconfig
    make download -j8
    find dl -size -1024c -exec ls -l {} \;
    make -j$(nproc) || make -j1 || make -j1 V=s
    
    # 如果需要重新配置
    rm -rf ./tmp && rm -rf .config # 清除临时文件和编译配置文件
    make menuconfig
    make download -j8
    find dl -size -1024c -exec ls -l {} \;
    make -j$(nproc) || make -j1 || make -j1 V=s
    

参考文档


Never give up your dreams.