LibWrt

[中文] [English]

适用于 IPQ 系列设备的 OpenWrt 源码仓库

说明

该项目旨在为 Qualcomm IPQ 系列设备提供功能完善的 OpenWrt 系统。

在开源社区的共同努力下，本项目解决了以往 IPQ 系列设备在使用 OpenWrt 时，需放弃部分 NSS 功能或使用老旧内核的问题。我们特别融合了 JiaY-shi 和 qosmio 两位开发者的 NSS 支持代码，并采用 ImmortalWrt 的 LuCI 和 Packages 作为插件支持。

在此，向所有贡献者表示衷心的感谢！

设备支持概览

✨ NSS 功能支持矩阵

** 图例说明**

• ¹ 需要 NSS 固件 11.4 版本 (CONFIG_NSS_FIRMWARE_VERSION_11_4=y)
• ² ⛔ 在该平台上不可用
• ³ ❌ 在 NSS 固件 (11.4–12.5) 版本中不可用
• ⁴ ⚠️ 在 ath11k 驱动程序中存在故障

Wiki & FAQ

• 什么是NSS？
• OpenWrt如何“分载”流量？
• NSS与OpenWrt的“分载”选项有何不同？
• 我需要NSS吗？
• 我的设备支持NSS吗？
• 重要提示！

使用方法

云编译

您可以使用以下项目进行云端编译：

• breeze303/openwrt-ci
• ZqinKing/wrt_release
• laipeng668/openwrt-ci-roc
• VIKINGYFY/OpenWRT-CI

本地编译

⚠️ 注意事项

• 请勿使用 root 用户进行编译！
• 国内用户编译前建议开启网络代理。
• 编译环境要求：至少 4GB 内存和 25GB 可用磁盘空间。
• 默认配置：
  • 登陆 IP: 192.168.1.1
  • 密码: none

1. 系统环境准备

推荐使用 Ubuntu 22.04 LTS 或 Debian 11 系统。

2. 安装编译依赖

…

3. 下载源码与配置

# 克隆源码
git clone -b 25.12-nss --depth 1 --single-branch https://github.com/LiBwrt/LibWrt.git libwrt
cd libwrt

# 更新 feeds
./scripts/feeds update -a && ./scripts/feeds install -a

# 进入菜单配置
make menuconfig

4. 首次编译

# 下载依赖库 (多线程)
make download -j$(nproc)

# 开始编译 (建议使用单线程，方便排查错误)
make -j1 V=s

编译完成后，固件位于 bin/targets 目录下。

5. 二次编译

cd libwrt

# 拉取最新代码
git fetch && git reset --hard origin/25.12-nss

# 更新 feeds
./scripts/feeds update -a && ./scripts/feeds install -a

# 加载默认配置并编译
make defconfig
make -j$(nproc) V=s 

6. 重新配置

如果需要修改配置，请执行以下命令：

# 清除旧配置
rm -rf .config

# 进入菜单配置
make menuconfig

# 开始编译
make -j$(nproc) V=s 

⭐ 支持项目

如果您喜欢这个项目，请在 GitHub 上点个 Star 支持一下！