飞牛NAS本地编译ImmortalWrt保姆级教学 & 懒人包分享

构建要求 (Requirements)

要构建此项目，推荐使用 Debian 11 系统。此外，您需要满足以下硬件条件：

• CPU: 基于 AMD64 架构
• 内存 (RAM): 至少 4GB
• 磁盘空间: 至少 25GB 可用空间
• 网络: 确保互联网访问通畅

编译 ImmortalWrt 需要以下工具链，不同 Linux 发行版的软件包名称可能会有所不同。以下是面向 Debian/Ubuntu 用户的安装示例：

方法一：通过 APT 安装依赖

Bash

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

方法二：使用一键脚本环境配置

Bash

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

注意事项 (Note):

• 权限警告： 所有操作请使用普通用户权限执行，切勿使用 root 用户，也不要加 sudo。
• CPU 架构： 使用其他架构的 CPU 理论上也可以编译 ImmortalWrt，但这需要更多额外的代码调整——我们对此不提供任何保证。
• 路径规范： 您的系统 PATH 环境变量或工作目录路径中，绝不能包含空格或非 ASCII 字符（如中文字符）。
• WSL 用户： 如果您使用的是 Windows Subsystem for Linux (WSL)，则必须从 PATH 中移除 Windows 系统文件夹，详情请参阅“构建系统设置 WSL”文档。
• macOS 用户： 不推荐使用 macOS 作为宿主编译系统。我们对此不提供任何保证。您可以从“构建系统设置 macOS”文档中获取相关提示。
• 更多详情，请参阅“构建系统设置”文档。

快速上手 (Quickstart)

1. 克隆源码： 运行以下命令克隆源代码（请将 <branch> 替换为您想要编译的分支，例如 master 或 openwrt-23.05）：Bashgit clone -b <branch> --single-branch --filter=blob:none https://github.com/immortalwrt/immortalwrt
2. 进入目录： 运行以下命令进入源码目录：Bashcd immortalwrt
3. 更新软件源 (Feeds)： 运行以下命令，获取 feeds.conf / feeds.conf.default 中定义的所有最新软件包：./scripts/feeds update -a
4. 安装软链接： 运行以下命令，将获取到的所有软件包软链接安装到 package/feeds/ 目录下：./scripts/feeds install -a
5. 配置固件： 运行以下命令，打开配置菜单，选择您需要的工具链、目标系统（路由器型号）以及固件包含的软件包：make menuconfig
6. 开始编译： 运行以下命令构建您的固件：Bashmake 系统将自动下载所有源代码，构建交叉编译工具链，然后为您的目标系统交叉编译 GNU/Linux 内核以及所有选定的应用程序。

Requirements

To build with this project, Debian 11 is preferred. And you need use the CPU based on AMD64 architecture, with at least 4GB RAM and 25 GB available disk space. Make sure the Internet is accessible.

The following tools are needed to compile ImmortalWrt, the package names vary between distributions.

• Here is an example for Debian/Ubuntu users:
  • Method 1:Setup dependencies via APTsudo 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
  • Method 2:sudo bash -c ‘bash <(curl -s https://build-scripts.immortalwrt.org/init_build_environment.sh)’

Note:

• Do everything as an unprivileged user, not root, without sudo.
• Using CPUs based on other architectures should be fine to compile ImmortalWrt, but more hacks are needed – No warranty at all.
• You must not have spaces or non-ascii characters in PATH or in the work folders on the drive.
• If you’re using Windows Subsystem for Linux (or WSL), removing Windows folders from PATH is required, please see Build system setup WSL documentation.
• Using macOS as the host build OS is not recommended. No warranty at all. You can get tips from Build system setup macOS documentation.
• For more details, please see Build system setup documentation.

Quickstart

1. Run git clone -b <branch> --single-branch --filter=blob:none https://github.com/immortalwrt/immortalwrt to clone the source code.
2. Run cd immortalwrt to enter source directory.
3. Run ./scripts/feeds update -a to obtain all the latest package definitions defined in feeds.conf / feeds.conf.default
4. Run ./scripts/feeds install -a to install symlinks for all obtained packages into package/feeds/
5. Run make menuconfig to select your preferred configuration for the toolchain, target system & firmware packages.
6. Run make to build your firmware. This will download all sources, build the cross-compile toolchain and then cross-compile the GNU/Linux kernel & all chosen applications for your target system.