Skip to content

NSS-Switch v1.0.0-r1 (DEBUG)

Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 21 May 12:33

⚠️ WORK IN PROGRESS
A selective CPU bypass manager for Qualcomm NSS (Network Subsystem) on OpenWrt.
This tool allows you to mark specific connections so they are processed by the CPU instead of the NSS hardware accelerator.
Useful (and needed) for:

  • Traffic that needs deep inspection (e.g., tcpdump, bandwidthd, snort)
  • Debugging or troubleshooting NSS offload issues
  • Per-flow bypass rules without disabling NSS globally
    No service/network restart required to bypass (hot-swapping) any NSS connection.

📌 See CHANGELOG.md for detailed history and pending work.

Installation on OpenWrt

Pre-requisites

  • OpenWrt 25.12+ with NSS (QCA SSDK) enabled
  • Full conntrack / nftables support

APK file

apk add /path/to/nss-switch-1.0.0-r1_DEBUG.apk --allow-untrusted

RSA public key is included in the repository/releases so it can be added to /etc/apk/keys/ directly, making the --allow-untrusted flag unnecessary.