欢迎来到 Lean 的 LEDE 源码仓库

为国产龙芯 LOONGSON SoC loongarch64 / 飞腾 Phytium 腾锐 D2000 系列架构添加支持

I18N: English | 简体中文 | 日本語

官方讨论群

如有技术问题需要讨论或者交流，欢迎加入以下群：

1. QQ 讨论群：Op 固件技术研究群，号码 891659613，加群链接：点击加入
2. TG 讨论群：OP 编译官方大群，加群链接：点击加入

瑞莎网络计算 - 轻松打造你的网络边缘计算系统

瑞莎网络计算系列覆盖从入门到高性能的边缘网关场景，从千兆到 2.5G，从四核到六核，全系列基于瑞芯微高可靠处理器，低功耗、稳定运行，适合 7×24 小时网络服务。

产品型号	E20C	E24C	E25	E52C	E54C
处理器	瑞芯微RK3528A（四核）	瑞芯微 RK3528A（四核）	瑞芯微 RK3568（四核）	瑞芯微 RK3582（六核）	瑞芯微 RK3582（六核）
以太网	2x 千兆以太网	4x 千兆以太网	2x 2.5G 以太网	2x 2.5G 以太网	4x 千兆以太网
适用场景	入门级软路由 / 家用网关	多口家庭路由 / IoT 网关	高速 2.5G 家庭 / 小型企业软路由	高性能 2.5G 路由 / 边缘计算 / VPN	多口网络控制器 / 企业网关

• 多网口设计，为网络计算而生
  • 提供 2 / 4 网口、千兆 / 2.5G 多种组合，灵活适配家用、宿舍、小型企业与 IoT 网络。
• 一板多用，系统自由切换
  • 支持 OpenWrt、Debian、Armbian 等多种系统，可应用于网关、轻量服务器或开发板等领域。
• 稳定可靠，适合全天候运行
  • 优秀的金属外壳散热设计 + 瑞芯微平台的低功耗特性，确保长时间满载仍能保持稳定。
• 开发生态完善，轻松扩展功能
  • 提供配套文档、源码与社区支持，方便开发者进行二次开发、插件扩展与自定义功能。

了解更多

• 官方文档

• 官网介绍

• 瑞莎京东店铺

• 瑞莎淘宝店铺

注意

1. 不要用 root 用户进行编译
2. 国内用户编译前最好准备好梯子
3. 默认登陆IP 192.168.1.1 密码 password

编译命令

1. 首先装好 Linux 系统，推荐 Debian 或 Ubuntu LTS 22/24

2. 安装编译依赖

   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 flex gawk gcc-multilib g++-multilib gettext \
   genisoimage git gperf haveged help2man intltool libc6-dev-i386 libelf-dev libfuse-dev libglib2.0-dev \
   libgmp3-dev libltdl-dev libmpc-dev libmpfr-dev libncurses5-dev libncursesw5-dev libpython3-dev \
   libreadline-dev libssl-dev libtool llvm lrzsz libnsl-dev ninja-build p7zip p7zip-full patch pkgconf \
   python3 python3-pyelftools python3-setuptools qemu-utils rsync scons squashfs-tools subversion \
   swig texinfo uglifyjs upx-ucl unzip vim wget xmlto xxd xz-utils zlib1g-dev

3. 下载源代码，更新 feeds 并选择配置

   git clone https://github.com/coolsnowwolf/lede
   cd lede
   ./scripts/feeds update -a
   ./scripts/feeds install -a
   make menuconfig

4. 下载 dl 库，编译固件 （-j 后面是线程数，第一次编译推荐用单线程）

   make download -j8
   make V=s -j1

本套代码保证肯定可以编译成功。里面包括了 R24 所有源代码，包括 IPK 的。

你可以自由使用，但源码编译二次发布请注明我的 GitHub 仓库链接。谢谢合作！

二次编译：

cd lede
git pull
./scripts/feeds update -a
./scripts/feeds install -a
make defconfig
make download -j8
make V=s -j$(nproc)

如果需要重新配置：

rm -rf .config
make menuconfig
make V=s -j$(nproc)

编译完成后输出路径：bin/targets

使用 WSL/WSL2 进行编译

由于 WSL 的 PATH 中包含带有空格的 Windows 路径，有可能会导致编译失败，请在 make 前面加上：

PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin

由于默认情况下，装载到 WSL 发行版的 NTFS 格式的驱动器将不区分大小写，因此大概率在 WSL/WSL2 的编译检查中会返回以下错误：

Build dependency: OpenWrt can only be built on a case-sensitive filesystem

一个比较简洁的解决方法是，在 git clone 前先创建 Repository 目录，并为其启用大小写敏感：

# 以管理员身份打开终端
PS > fsutil.exe file setCaseSensitiveInfo <your_local_lede_path> enable
# 将本项目 git clone 到开启了大小写敏感的目录 <your_local_lede_path> 中
PS > git clone https://github.com/coolsnowwolf/lede <your_local_lede_path>

对已经 git clone 完成的项目目录执行 fsutil.exe 命令无法生效，大小写敏感只对新增的文件变更有效。

macOS 原生系统进行编译

1. 安装 macOS Command Line Tools（无需安装完整 Xcode）：

   xcode-select --install

   如果系统已安装 Xcode，可跳过此步骤。

2. 安装 Homebrew：

   /bin/bash -c "$(curl -fsSL https://github.com/raw/Homebrew/install/HEAD/install.sh)"

3. 使用 Homebrew 安装工具链、依赖与基础软件包：

   brew install coreutils diffutils findutils gawk gnu-getopt gnu-tar gnu-sed grep make \
     ncurses pkgconf wget quilt xz bash git rsync gpatch python3 python-setuptools go swig

   宿主编译器使用 Command Line Tools 提供的 Clang，目标工具链由构建系统生成。 Apple Silicon 上编译 Go 软件包时需要已安装的 Go 进行自举，构建系统会自动从 PATH 中查找。 python-setuptools 为仍使用 distutils 的软件包构建脚本提供兼容模块。 swig 用于 U-Boot 等组件的 Python FDT 绑定生成。 为 U-Boot 的 binman 镜像打包工具准备 Python 依赖：

   python3 -m venv --system-site-packages ~/.venvs/lede-build
   source ~/.venvs/lede-build/bin/activate
   python3 -m pip install pyelftools
   export PYTHONPATH="$(python3 -c 'import site; print(site.getsitepackages()[0])')${PYTHONPATH:+:$PYTHONPATH}"

   每次新开终端编译前需重新激活该环境并执行上述 export，使构建系统缓存的 Python 命令也能找到模块。 --system-site-packages 保留 Homebrew setuptools 的可用性。

4. 准备区分大小写的构建文件系统。macOS 默认的 APFS 通常不区分大小写，不能直接在默认的家目录中编译。 在“磁盘工具”中向现有 APFS 容器添加一个“APFS（区分大小写）”卷，例如 LEDE-build，然后在 /Volumes/LEDE-build 中存放源码和构建目录。 建议至少保留 100 GB 可用空间；多个 target 的构建回归需要更多空间。APFS 卷默认共享容器空间，可不设置配额上限。

5. 进入 Bash，配置 GNU 工具路径（通过 Homebrew 前缀同时兼容 Intel 和 Apple Silicon）：

   # Intel Mac 的 Homebrew 通常位于 /usr/local，Apple Silicon 通常位于 /opt/homebrew
   eval "$(/opt/homebrew/bin/brew shellenv)" # Intel Mac 请改为 /usr/local/bin/brew
   bash
   export BREW_PREFIX="$(brew --prefix)"
   for tool in coreutils diffutils findutils gnu-tar gnu-sed grep make; do
     export PATH="$BREW_PREFIX/opt/$tool/libexec/gnubin:$PATH"
   done
   export PATH="$BREW_PREFIX/opt/gnu-getopt/bin:$PATH"
   umask 022

   每次新开终端编译前需重新加载以上环境；也可将 export 和循环部分保存到 ~/.bashrc，进入 Bash 后执行 source ~/.bashrc。 macOS 默认的 Zsh 不会自动加载 ~/.bashrc。

6. 在上述大小写敏感卷内获取源码，按本文的 feeds 和配置步骤进行编译；使用普通用户执行，不要使用 sudo make。 例如选择 Target System: x86、Subtarget: x86_64 后：

   make defconfig
   make download -j8
   make V=s -j$(nproc)
   # 如果失败，使用单线程详细输出定位首个错误
   make -j1 V=s

   长时间或通过 SSH 编译时，可使用 caffeinate -i make V=s -j$(nproc)，在构建任务运行期间防止 Mac 因空闲而睡眠。

   这是 macOS 原生交叉编译，Apple Silicon 主机也可构建 x86_64 固件，无需虚拟机或容器。 Airoha AN7581/AN7583 的 BL2 构建会自动下载经过 SHA256 校验的 Arm 工具链；Apple Silicon 使用原生 macOS ARM64 版本。Intel Mac 需额外执行 brew install arm-none-eabi-gcc。

   UML（User Mode Linux）目标仅支持 Linux x86_64 主机构建，不适用于本节的 macOS 原生构建流程。

特别提示

1. 源代码中绝不含任何后门和可以监控或者劫持你的 HTTPS 的闭源软件， SSL 安全是互联网最后的壁垒，安全干净才是固件应该做到的。

2. 想学习 OpenWrt 开发，但是摸不着门道？自学没毅力？基础太差？怕太难学不会？跟着佐大学 OpenWrt 开发入门培训班助你能学有所成 报名地址：点击报名

3. QCA IPQ60xx 开源仓库地址：https://github.com/coolsnowwolf/openwrt-gl-ax1800

4. 存档版本仓库地址：https://github.com/coolsnowwolf/openwrt

捐贈

如果你觉得此项目对你有帮助，可以捐助我们，以鼓励项目能持续发展，更加完善