NSSオフロードを有効にしたQualcomm IPQ806x機種向けのOpenWrt25.12.6ビルドが公開されているのを発見したので、こちらをありがたくベースにさせてもらってNEC WG2600HP用のイメージを仕立てました、というメモ。10年以上前の機体なのでもはや使う人もいないだろうけど、何かの役に立てば幸いです。
※大半の作業をClaudeにお願いして作った個人用の趣味のビルドです。At your own riskでお使いください。WG2600HP2での動作は不明であり、導入は非推奨です。
GitHubリポジトリ
sysupgradeイメージはこちら。
ビルド概要
- NEC WG2600HP用 OpenWrt 25.12.6。実機で最低限のテスト済み
- NSSオフロード有効。IPv4/IPv6/PPPoE/DS-Lite/MAP-E等の有線通信がオフロードされ、ほぼCPUを使わずに1Gbpsのワイヤレート上限で処理できる
- 公開イメージはTailscale入りでサイズが少し大きい。要らない人は自前でビルドし直してください
- テスト中に見つけた複数のバグに対する個人的フィックスを含む
詳細は以下のReadme日本語訳を参照してください。
Readme日本語訳
NEC Aterm WG2600HP 向けカスタム NSS ビルド
このブランチは、初代 NEC Aterm WG2600HP(IPQ8064)向けの、NSS オフロードに対応した OpenWrt 25.12.6 のビルドです。gyimesibalazs/openwrt-ipq806x-nss-25.12 をベースに、いくつかの修正を加えています。個人で利用するために作ったプライベートビルドです。
- ベース: gyimesibalazs/openwrt-ipq806x-nss-25.12、ブランチ
ipq806x-nss-25.12.6、commita0d03e3b8b(OpenWrt 25.12.6r33311、kernel 6.12.112、swconfig、qca-nss-gmac、NSS、ECM)。ベースは、tingalvin/r7800 の NSS 対応を OpenWrt 25.12 に移植したものです。 - feeds: ベースの
feeds.conf.defaultで固定された commit を、そのまま使います。tailscale 1.104.1 と Go 1.27 は、openwrt-25.12 の packages feed のものです。 - パッケージ管理: apk(OpenWrt 25.12)。
- イメージ: このリポジトリの Releases ページにあります。
このリポジトリの GitHub 上の fork 関係(tingalvin/r7800)は、以前の 24.10 版ビルドのものです。24.10 版はすでに削除しました。
ベースからの変更
| # | 変更 | 場所 |
|---|---|---|
| 1 | qca-nss-ecm: standard プロファイルを起動時に開始し、firewall4 と連携する | このブランチの commit |
| 2 | qca-nss-ecm: accel_delay_pkts を 1 から 24 に変更 |
このブランチの commit |
| 3 | qca-nss-clients tunipip6: encap の例外処理での dst リークを修正 | このブランチの commit |
| 4 | qca-nss-ecm: インターフェースの機能を、イメージに組み込まれる kmod の分だけ有効にする | このブランチの commit |
| 5 | qca-nss-ecm: ECM のロード中は conntrack イベントを有効にする(MAP-E の修正) | このブランチの commit |
| 6 | イメージ: sysupgrade イメージが収まるかを検査する(24192k) | このブランチの commit |
| 7 | ベースの GitHub workflow を削除 | このブランチの commit |
| 8 | NSS 用の、初回起動時の初期設定 | custom/files/wg2600hp/etc/uci-defaults/98-wg2600hp-nss-defaults |
| 9 | config: WG2600HP のみ、パッケージの選択、CONFIG_ALL_KMODS=y |
custom/configs/wg2600hp.config |
| 10 | トップの README はこの文書を案内する。ベースの README は README.base.md として残す |
このブランチの commit |
ベースの以下の部分は、変更せずに使います。
- NSS の CPU 分散: qca-nss-drv の init スクリプトが、2 つ目の NSS コアの IRQ を CPU1 に移します。また、qca-nss-drv の packet steering のフックが、汎用の packet steering スクリプトの後で
eth*の RPS を 0 にします。 - kernel、NSS のファームウェアとドライバ、WG2600HP の swconfig 用 device tree。
ベースの以下の部分は使いません。
- config の元になる
diffとdiff-c2600(配布名「OpenWrt NSS」、他の機種)。このビルドの config はcustom/configs/wg2600hp.configです。 VHTNSS.zip(ベースの workflow が feeds に適用する LuCI のパッチ)。
1. ECM の起動と firewall4
kmod-qca-nss-ecm-standardが、ファイアウォール用スクリプトで使うiptables-nftとiptables-mod-physdevに依存するようにしました。- init スクリプトを
rc.common形式でインストールし、ECM が起動時に開始するようにしました。 - ファイアウォールの include を
fw4_compatibleとして登録しました。この include は、ファイアウォールが先に起動した場合に備えて ECM を開始し、ファイアウォールの reload 後には加速中の接続を flush します。 - bridge netfilter の sysctl は
/etc/sysctl.d/99-qca-nss-ecm.confに書くので、既定値の後に適用されます。
2. accel_delay_pkts=24
ECM は、各接続の最初の accel_delay_pkts 個のパケットを CPU で処理し、その後で接続を NSS に渡します。
- 元の値
1では、ECM は TCP 以外の接続を、両方向のパケットを見るまで加速しません。このため、DS-Lite、MAP-E、片方向の UDP は CPU で処理されたままでした。 24にすると、これらはすべて NSS で処理されます。
注意:
1以外の値では、片方向で見た DSCP と mark が両方向に適用されます。QoS の分類や、mwan3・ポリシールーティングの mark に影響することがあります。- 値を変えるには、
/etc/init.d/qca-nss-ecmのload_ecm()にあるecho 24 > .../accel_delay_pktsの行を編集し、/etc/init.d/qca-nss-ecm restartを実行します。sysupgrade すると 24 に戻ります。
3. tunipip6(DS-Lite/MAP-E)の dst リーク
Qualcomm の upstream の修正(qca-nss-clients ec7a57b)です。nss_tunipip6_encap_exception() で検索した route を解放します。この修正が無いと、該当するパケットごとに dst エントリがリークし、ip_dst_cache が際限なく増えます。130 はこのパッケージの Linux 6.12 用パッチが使っているので、パッチの番号は 140-... にしました。
4. ECM の機能と CONFIG_ALL_KMODS
CONFIG_ALL_KMODS=y は、後から kmod を追加できるように、全 kmod をビルドします。同時に、kmod-sit、kmod-pppol2tp、kmod-macvlan、kmod-ipsec が =m になります。元の Makefile では、このツリーの NSS ドライバに無い機能を有効にして ECM がビルドされ、ビルドが失敗していました。そこで、これらの機能は、イメージに組み込まれる(=y)kmod の分だけ有効にするようにしました。
5. conntrack イベント(MAP-E の修正)
Linux 6.x では、net.netfilter.nf_conntrack_events の既定値が 2 です。この場合、接続ごとのイベント用データは、ctnetlink のリスナー(conntrack -E など)が動いている間しか確保されません。リスナーが無いと、ECM は接続の破棄を知らされず、閉じた接続の NSS ルールが残ります。
MAP-E は送信元ポートを小さなポートセットに割り当てます。このため、LAN 側のアドレスとポートを再利用した新しい接続が古いルールで変換され、通信が止まっていました。
ECM の init スクリプトは、qosmio/nss-packages と同じように、ECM のロード時に nf_conntrack_events を 1 にし、アンロード時に 2 に戻すようにしました。これにより、通信の停止は解消しました。追加で使うメモリは、接続あたり約 16 バイトです。
6. イメージサイズの検査
sysupgrade イメージは、ファームウェアのパーティション(24192k)に収まる必要があります。この検査により、大きすぎるイメージは作られず、ビルドが失敗します。
7. GitHub workflow
ベースには、他の機種のイメージを別の config でビルドし、v* タグで公開する workflow があります。このブランチは custom/build.sh でローカルにビルドするので、workflow は削除しました。
8. 初回起動時の初期設定
初回起動時に、98-wg2600hp-nss-defaults が以下を設定します。
- ファイアウォールの software / hardware flow offloading を無効にします。これらは NSS のスイッチではありません。software flow offloading を有効にすると、IPv4 と PPPoE の通信が NSS を経由しなくなります。
- packet steering を無効にします。
- ECM の加速エンジンを
nssにします。
9. config
config の内容は以下のとおりです。
| 分野 | パッケージと設定 |
|---|---|
| 機種 | ipq806x / generic / NEC WG2600HP |
| スイッチと Ethernet | swconfig、qca-nss-gmac |
| オフロード | qca-nss-drv、qca-nss-ecm-standard、NSS の PPPoE と tunipip6 のクライアント |
| WAN | PPPoE、DS-Lite、MAP-E(map)、odhcp6c |
| VPN | WireGuard(kmod-wireguard、wireguard-tools、luci-proto-wireguard)、tailscale |
| 管理と監視 | LuCI、conntrack、collectd、luci-app-statistics、collectd-mod-sensors |
| 無線 | QCA99x0 の board data、ath10k-ct |
| ビルド | CONFIG_ALL_KMODS=y、CONFIG_KERNEL_BUILD_USER="builder"、CONFIG_KERNEL_BUILD_DOMAIN="buildhost" |
CONFIG_ALL_KMODS=y だけでは、NSS 関連の kmod の一部も選ばれ、イメージに入る NSS ドライバと ECM が変わってしまいます。config ではこれらを無効にしています。対象は、kmod-bonding とそれを選ぶ kmod(kmod-qca-mcs と、もう一方の ECM の variant)、および NSS の追加機能の kmod(crypto、qdisc、L2TP、6rd など)です。これらの NSS の kmod は、後から追加できません。
tailscale
- イメージには、openwrt-25.12 の packages feed の tailscale 1.104.1(
tailscaleとtailscaled)が入っています。tailscale のライセンスは BSD-3-Clause です(LICENSE を参照)。このビルドは Tailscale Inc. とは関係がありません。 - イメージに tailscale のログイン情報や状態は含まれません。
tailscaledは起動時に開始しますが、ログインはしていません。ルーター上でtailscale upを実行し、表示される URL でログインしてください。 - tailscale の版は、イメージのビルド時に決まります。overlay には、ルーター上で更新するだけの空きがありません。tailscale を更新するには、新しい packages feed でイメージを再ビルドし、
-nを付けずにsysupgradeを実行します。これで、/etc/configと、/etc/tailscaleにある tailscale のログイン情報が引き継がれます。
tailscale なしでビルドする
custom/configs/wg2600hp.configの
をCONFIG_PACKAGE_tailscale=y
に置き換えます。# CONFIG_PACKAGE_tailscale is not set- 次の「ビルド」の手順でビルドします。
Go がまったくビルドされなくなるので、ビルド時間の大半を省けます。イメージもかなり小さくなります。
ビルド
OpenWrt をビルドできるホスト(OpenWrt のビルドシステムの文書を参照)で、以下を実行します。
git clone -b custom/ipq806x-nss-25.12.6 https://github.com/<this repository>.git openwrt
cd openwrt
custom/build.sh wg2600hp -j$(nproc)
custom/build.sh は以下を行います。
- 前提条件の検査が英語の出力を解析するので、
LC_ALL=Cを設定します。 feeds.conf.defaultの全 feed が commit に固定されていることを確かめ、そこからfeeds.confを作ります。feeds を更新し、チェックアウトされた commit を確かめます。- feeds をインストールします。
custom/files/wg2600hpをfiles/として配置します。- config を
.configにコピーします。 make defconfig、make download、makeを実行します。
イメージは bin/targets/ipq806x/generic/ にできます。Go をソースからビルドするので、時間がかかります。
インストール
この手順は、すでに OpenWrt が動いている WG2600HP が対象です。NEC の純正ファームウェアからの最初のインストール(シリアルコンソールと TFTP)は、OpenWrt wiki の WG2600HP のページを参照してください。
他のビルドから移行するときは、設定を引き継がずにインストール(sysupgrade -n)してください。このリポジトリの以前の 24.10 版ビルドからの移行も同じです。
- OpenWrt の公式リリースは DSA を、このイメージは swconfig を使うので、ネットワーク設定に互換性がありません。
- OpenWrt 25.12 は opkg ではなく apk を使います。24.10 版に追加したパッケージは引き継げません。
ssh root@192.168.1.1 'sysupgrade -b /tmp/backup.tar.gz && cat /tmp/backup.tar.gz' > backup-before.tar.gz
cat openwrt-ipq806x-generic-nec_wg2600hp-squashfs-sysupgrade.bin | ssh root@192.168.1.1 'cat > /tmp/fw.bin'
ssh root@192.168.1.1 'sha256sum /tmp/fw.bin; sysupgrade -T /tmp/fw.bin && echo OK'
ssh root@192.168.1.1 'sysupgrade -n /tmp/fw.bin'
その後、ルーターは初期状態で起動します。
- LAN のアドレスは 192.168.1.1
- root パスワードは未設定
- 無線は無効
NSS が働いていることは、以下で確かめられます。
dmesg | grep -E "nss core [01] booted"
lsmod | grep -E "^(ecm|qca_nss_drv|qca_nss_gmac|qca_nss_pppoe|qca_nss_tunipip6) "
cat /sys/kernel/debug/ecm/ecm_classifier_default/accel_delay_pkts # 24
cat /proc/sys/net/netfilter/nf_conntrack_events # 1
注意
- LuCI で software / hardware flow offloading を有効にしないでください。packet steering も無効のままにしてください。SQM(
sqm-scripts)は CPU で動き、NSS を経由しません。 - 他のパッケージは、公式の 25.12.6 の feeds から追加できます(
apk add)。ただし、カーネルモジュール(kmod-*)は例外です。公式のものはこの kernel に合わないので、このブランチを自分でビルドしたもの(bin/targets/ipq806x/generic/packages/)を使ってください。 - 初回起動後の overlay の空きは、約 6.4 MiB です。
テスト
このイメージは、WG2600HP の実機で動作を確認しました。
- NSS オフロード: 素の IPv4、PPPoE、IPv6、DS-Lite、MAP-E の TCP と UDP が、CPU がほぼ空いたまま回線速度で流れました。WireGuard は CPU で処理されます(TCP 1 本で約 330〜380 Mbit/s)。
- これらの WAN 種別での負荷試験: 再起動なし、kernel の警告なし、メモリ使用量の増加なし。
- Wi-Fi、5 GHz でクライアント 1 台: WPA2-Personal と WPA3-Personal(SAE)のどちらでも、切断なく接続できました。
試験していないもの: 2.4 GHz、Wi-Fi のスループットと到達距離、複数のクライアント、長期間の使用、再起動の繰り返し。
このイメージは WG2600HP の実機で動作を確認しましたが、試験の範囲は限られています。長期間の安定性や、細かな設定変更をした後の正常な動作は確認していません。自己責任で使ってください。
ライセンス
OpenWrt と各パッケージのライセンス(主に GPL-2.0)に従います。このブランチのパッチは、変更したファイルのライセンスに従います。





































