# openwrt-6.x

**Repository Path**: afeng11/openwrt-6.x

## Basic Information

- **Project Name**: openwrt-6.x
- **Description**: No description available
- **Primary Language**: C
- **License**: Not specified
- **Default Branch**: 25.12-nss
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-04-07
- **Last Updated**: 2026-10-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

[**[中文]**](README.md) [**[English]**](README-en.md)

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

## 📖 说明

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

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

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

### 🎯 设备支持概览
| Target | NSS 功能 | 2.4G WiFi (NSS Offload) | 5G WiFi (NSS Offload) |
| :----: |:--------:|:-----------------------:|:---------------------:|
| IPQ807X| ✅       | ✅                      | ✅                    |
| IPQ60XX| ✅       | ✅                      | ✅                    |
| IPQ50XX| ❌       | ❌                      | ❌                    |

---

## ✨ NSS 功能支持矩阵

| 功能 | IPQ807x | IPQ60xx | 功能 | IPQ807x | IPQ60xx |
| :--- | :---: | :---: | :--- | :---: | :---: |
| TUNIPIP6 | ✅ | ✅ | RMNET | 🟨¹ | ⛔² |
| PPPOE | ✅ | ✅ | MIRROR | ✅ | ✅ |
| L2TPV2 | ✅ | ✅ | WIFI (AP/STA) | ✅ | ✅ |
| BRIDGE | ✅ | ✅ | WIFI (WDS) | 🟨¹ | 🟨¹ |
| VLAN | ✅ | ✅ | WIFI (MESH) | 🟨¹ | 🟨¹ |
| MAP_T | ✅ | ✅ | WIFI (AP VLAN) | ⚠️⁴ | ⚠️⁴ |
| TUN6RD | ✅ | ✅ | IPSEC | ❌³ | ❌³ |
| GRE | ✅ | ✅ | PVXLAN | ❌³ | ❌³ |
| PPTP | ✅ | ✅ | CLMAP | ❌³ | ❌³ |
| IGS | ✅ | ✅ | TLS | ❌³ | ❌³ |
| VXLAN | ✅ | ✅ | CAPWAP | ❌³ | ❌³ |
| MATCH | ✅ | ✅ | DTLS | ❌³ | ❌³ |

<br/>

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

---

## 📚 Wiki & FAQ

- [**什么是NSS？**](https://github.com/qosmio/openwrt-ipq/blob/qualcommax-6.x-nss-wifi/README.md#whats-nss)
- [**OpenWrt如何“分载”流量？**](https://github.com/qosmio/openwrt-ipq/blob/qualcommax-6.x-nss-wifi/README.md#how-does-openwrt-offload-traffic)
- [**NSS与OpenWrt的“分载”选项有何不同？**](https://github.com/qosmio/openwrt-ipq/blob/qualcommax-6.x-nss-wifi/README.md#how-is-nss-different-from-openwrts-offloading-options)
- [**我需要NSS吗？**](https://github.com/qosmio/openwrt-ipq/blob/qualcommax-6.x-nss-wifi/README.md#do-i-need-nss)
- [**我的设备支持NSS吗？**](https://github.com/qosmio/openwrt-ipq/blob/qualcommax-6.x-nss-wifi/README.md#ok-i-want-nss-does-my-device-support-it)
- [**重要提示！**](https://github.com/qosmio/openwrt-ipq/blob/qualcommax-6.x-nss-wifi/README.md#important-note)

---

## 🚀 使用方法

### 云编译

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

- [**breeze303/openwrt-ci**](https://github.com/breeze303/openwrt-ci)
- [**ZqinKing/wrt_release**](https://github.com/ZqinKing/wrt_release)
- [**laipeng668/openwrt-ci-roc**](https://github.com/laipeng668/openwrt-ci-roc)
- [**VIKINGYFY/OpenWRT-CI**](https://github.com/VIKINGYFY/OpenWRT-CI)

### 本地编译

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

#### 1. 系统环境准备
推荐使用 **Ubuntu 22.04 LTS** 或 **Debian 11** 系统。

#### 2. 安装编译依赖
```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 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 libfuse-dev libssl-dev libtool lrzsz \
genisoimage msmtp nano ninja-build p7zip p7zip-full patch pkgconf python3 python3-pip libpython3-dev qemu-utils \
rsync scons squashfs-tools subversion swig texinfo uglifyjs upx-ucl unzip vim wget xmlto xxd zlib1g-dev
```

#### 3. 下载源码与配置
```bash
# 克隆源码
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. 首次编译
```bash
# 下载依赖库 (多线程)
make download -j$(nproc)

# 开始编译 (建议使用单线程，方便排查错误)
make -j1 V=s
```
编译完成后，固件位于 `bin/targets` 目录下。

#### 5. 二次编译
```bash
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. 重新配置
如果需要修改配置，请执行以下命令：
```bash
# 清除旧配置
rm -rf .config

# 进入菜单配置
make menuconfig

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

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

[![Stargazers over time](https://starchart.cc/LiBwrt-op/openwrt-6.x.svg?variant=adaptive)](https://starchart.cc/LiBwrt-op/openwrt-6.x)