OpenWrt Compilation Tutorial

It is recommended to use Ubuntu system, as there are many tutorials available, and troubleshooting becomes easier. You can use WSL, but it is not recommended to compile on NTFS or ReFS file systems, and using PowerShell for compilation is also discouraged.

Do not use the root user; the default user in Ubuntu is ‘ubuntu’, which can be used directly. For other systems or if you are logging in as root, consider creating a new user to perform the compilation.

The following content can be copied directly into the terminal for execution. Lines starting with # will be ignored by the terminal, so copying them together is not an issue.

# Preparation before compilation

#### Update software (optional) ####
sudo sh -c "apt update && apt upgrade -y"
########################

# Install dependencies
sudo apt install build-essential clang flex g++ gawk gcc-multilib gettext git libncurses5-dev libssl-dev python3-distutils rsync unzip zlib1g-dev file wget
# Clone source code
git clone https://github.com/coolsnowwolf/lede.git

# Enter the source code folder
cd lede

###### Add custom sources (optional) ##########
cat >> feeds.conf.default <<EOF
src-git kenzo https://github.com/kenzok8/openwrt-packages
src-git passwall https://github.com/xiaorouji/openwrt-passwall
src-git nas https://github.com/linkease/nas-packages.git
src-git jerrykuku https://github.com/jerrykuku/openwrt-package
src-git luci_passwall https://github.com/xiaorouji/openwrt-passwall.git;luci

EOF
####################################

# Update and install sources configured in feeds.conf.default
./scripts/feeds update -a && ./scripts/feeds install -a

###### Add OpenAppFilter application filter plugin (optional) ####
git clone https://github.com/destan19/OpenAppFilter package/OpenAppFilter
#################################################


#### Set the default management address of the router to .5.1 (optional) ###
sed -i 's/192.168.1.1/192.168.5.1/g' package/base-files/files/bin/config_generate
#############################################

# Select plugins as needed
make menuconfig
# Remember to appropriately expand the system partition and image size in Target Images
# If there are many drivers or plugins, this partition needs to be expanded accordingly
# (128) Kernel partition size (in MB)
# The filesystem partition can be understood as the default /overlay partition size after installation
# (512) Root filesystem partition size (in MB)

# Download the software packages required for compilation
make download -j8 V=s

# Check if there are any incomplete packages. This checks if there are any files under 1k in the dl directory. If there are, it is recommended to delete and download them again, as they may not be complete.
find dl -size -1024c -exec ls -l {} \;
# Delete
find dl -size -1024c -exec rm -f {} \;

Now distinguish between first-time compilation and second-time compilation.

First-time Compilation

# -j1: single-threaded compilation
make -j1 V=s
# If you get an error bash: po2lmo: command not found, it is likely that base has not been compiled first.
# You can run the following command to compile base first, then re-execute make -j1 V=s
make package/feeds/luci/luci-base/compile V=s
# The remaining issues are likely plugin conflicts, which need to be resolved gradually.

Second-time Compilation

# First, you must enter the lede directory: cd lede

# Pull the latest code
git pull
# Update and install the software packages included in the subscription source
./scripts/feeds update -a && ./scripts/feeds install -af

# Clean old files
# If only adjusting checks and drivers
make clean
# If adjustments to architecture are needed, or if there were errors in the previous compilation
make dirclean
# Delete old configuration files
rm -rf ./tmp && rm -rf .config
# Select plugins
make menuconfig
# Download packages
make download -j8 V=s
# Preferably use multi-threaded compilation, if an error occurs, use single-threaded and output detailed information
make -j$(nproc) ||  make -j1 V=s

Some tools:

• Because compilation has certain network requirements, it is usually done using overseas servers, which can create a transmission problem, especially when downloading directories like dl back to the domestic network; the transfer can be quite challenging.