No description
  • Go 58.8%
  • HTML 13%
  • Svelte 10.9%
  • JavaScript 8.3%
  • CSS 3.2%
  • Other 5.8%
Find a file
Fifth-Ace 5f081a7a7b
Some checks failed
CI / CI change scope (push) Has been cancelled
CI / Fast release contracts (push) Has been cancelled
CI / Publish validated stable promotion (push) Has been cancelled
CI / test (push) Has been cancelled
CI / Beta package build (aarch64-3.10) (push) Has been cancelled
CI / Beta package build (mips-3.4) (push) Has been cancelled
CI / Beta package build (mipsel-3.4) (push) Has been cancelled
CI / Publish verified multiarch Beta (push) Has been cancelled
CI / Publish rolling ARM64 Dev channel (push) Has been cancelled
release: prepare RouterForge Stable 0.14.0 candidate
2026-10-26 17:50:25 +03:00
.github ci: align Network Tools dev topology with CrowdSec manager 2026-10-16 17:32:45 +03:00
components fix(ui): unify Port Access Manager integration card title (L2B7A) 2026-10-24 00:55:26 +03:00
docs release: prepare RouterForge Stable 0.14.0 candidate 2026-10-26 17:50:25 +03:00
internal feat(telemetry): count release channels and installed modules 2026-10-22 00:30:54 +03:00
marketplace fix: regenerate marketplace registry for P30-4A 2026-10-03 17:04:04 +03:00
modules refactor(i18n): deduplicate Admin Service Inspector labels (L2B6B) 2026-10-23 23:48:48 +03:00
release/channels release: prepare RouterForge Stable 0.14.0 candidate 2026-10-26 17:50:25 +03:00
scripts feat(core): add install accounting and telemetry collector 2026-10-21 14:56:56 +03:00
services/telemetry-collector feat(telemetry): count release channels and installed modules 2026-10-22 00:30:54 +03:00
tests test(delivery): validate safe resume and fault handling 2026-10-12 14:06:18 +03:00
.editorconfig chore: clean up public repository structure 2026-09-02 21:36:42 +03:00
.gitattributes refactor: organize repository by component 2026-09-05 03:11:03 +03:00
.gitignore release: prepare RouterForge 0.6.0 stable multiarch 2026-09-07 15:32:24 +03:00
.mailmap docs: repair badges and normalize technical author display 2026-10-17 00:13:34 +03:00
CHANGELOG.md release: stage 0.13.0 stable ten-module candidate 2026-10-16 16:32:50 +03:00
CONTRIBUTING.md docs: streamline public documentation and remove internal development artifacts 2026-10-16 15:57:54 +03:00
go.mod refactor: organize repository by component 2026-09-05 03:11:03 +03:00
LICENSE chore: finalize public project setup 2026-09-02 01:58:15 +03:00
README.md docs: repair badges and normalize technical author display 2026-10-17 00:13:34 +03:00
README_EN.md docs: repair badges and normalize technical author display 2026-10-17 00:13:34 +03:00
SECURITY.md release: prepare RouterForge 0.7.1 stable 2026-09-11 16:23:13 +03:00
THIRD_PARTY_NOTICES.md feat: add authenticated package management 2026-09-03 17:00:43 +03:00

RouterForge — monitoring, diagnostics and management for Keenetic / Netcraze with Entware

RouterForge

Русский | English

CI Stable Beta License: MIT

RouterForge is a modular web platform for Keenetic / Netcraze routers running Entware. Monitoring, administration, DNS, network diagnostics and security tools are available in one interface.

RouterForge integrates with KeeneticOS/NDMS and Entware through ndmc, RCI and system interfaces. The Web UI runs on :2233; modules connect to Core using local Unix sockets.

Note

RouterForge is an independent, non-commercial community project. It is not an official product, division or partner project of Keenetic, Netcraze or Entware. Trademarks belong to their respective owners. License: MIT.

Tip

Core and modules are versioned independently — see Versioning Policy.

Installation

You need a Keenetic / Netcraze router running Entware, shell access and an internet connection.

Stable

For everyday use:

/opt/bin/opkg update && /opt/bin/opkg install curl && /opt/bin/curl -fsSL https://github.com/Fifth-Ace/routerforge/releases/download/routerforge-stable/routerforge-stable-bootstrap.sh | sh

Beta

Prerelease channel with new modules and features:

/opt/bin/opkg update && /opt/bin/opkg install curl && /opt/bin/curl -fsSL https://github.com/Fifth-Ace/routerforge/releases/download/routerforge-beta/routerforge-beta-bootstrap.sh | sh

Open http://<router-ip>:2233 after installation. Stable and Beta are separate release channels. Choose deliberately. See Installation and updates.

Architecture

RouterForge consists of Core and independently installed modules.

Browser
   |
   | http://router:2233
   v
RouterForge Core
├── Web UI / REST / SSE
├── Authentication / Settings
├── App Center / Registry / Releases
├── Module ABI host
└── Unix-socket proxy
     ├── DNS
     ├── Management
     │    ├── Processes / Services
     │    ├── File Manager / Maintenance
     │    ├── Entware Terminal
     │    └── Keenetic NDM Console
     ├── Monitoring
     │    ├── System / Thermal / Storage / Network
     ├── Network Tools
     │    ├── Network Doctor / Route Inspector
     │    └── Flow Explorer / Active Probes
     ├── NFQWS Manager
     │    ├── Diagnostics / AutoSelect
     │    ├── Strategies / Config / Lists
     │    ├── Smart Apply / Backups
     │    ├── DPI Detector
     │    └── NFQWS Menu
     ├── Antiscan Manager
     │    ├── Status / Diagnostics
     │    └── Config / Lists / Recovery
     ├── Port Access Manager
     │    ├── knockd / fwknopd / SPA
     │    └── iptables recent / odin
     └── CrowdSec Manager
          ├── Firewall Bouncer / LAPI
          └── ipset / iptables / Diagnostics

routerforge-profiling runs separately and is bound to 127.0.0.1:6061 by default. The backend is written in Go; modules do not need public standalone HTTP servers. See Architecture.

Why RouterForge

  • Purpose-built for Keenetic / Netcraze. Designed for KeeneticOS/NDMS and Entware.
  • System integration. ndmc, RCI, interfaces, routes, DNS, policy routing and services.
  • One interface. Administration, App Center, diagnostics and maintenance through one Web UI.
  • Modular installation. Core first, optional components as needed.
  • Lightweight runtime. Go backend, no Node.js runtime on the router.
  • Guarded changes. Validation, confirmations, backups and rollback where supported.
  • Verifiable releases. Multi-architecture packages, SHA256 checks and immutable release snapshots.

RouterForge modules

Available capabilities depend on the installed release channel and package selection.

Core — the management hub

routerforge-core

Web UI, authentication, settings, App Center, updates, module lifecycle and basic device telemetry. Required for all other modules.

DNS — resolver management

routerforge-dns

DNS, DoT and DoH configuration, resolver health, latency, errors and fallback; temporarily disable resolvers without removing them. Use it for advanced DNS management.

Management — router administration

routerforge-admin

Processes, services, file manager, maintenance, Entware terminal and Keenetic NDM console. Use it for routine administration in the browser.

Monitoring — device overview

routerforge-monitoring

CPU, memory, thermals, storage and network interface status. Use it for device resource visibility.

Network Tools — network diagnostics

routerforge-network-tools

Network Doctor, Route Inspector, Flow Explorer and Active Probes. Use it for WAN, VPN and routing investigations.

NFQWS Manager — nfqws2 management

routerforge-nfqws-manager

Manage an existing nfqws2-keenetic installation: configuration, profiles, lists, site diagnostics, strategy selection, test sandbox, guarded apply and backups. Use it if you run nfqws2.

Antiscan Manager — Antiscan management

routerforge-antiscan-manager

Manage an installed Antiscan service: configuration, diagnostics, lists, ipset, scheduling and recovery. Use it if you run Antiscan.

Port Access Manager — protected access

routerforge-port-access-manager · Beta

Access management for network services and forwarded ports through knockd, fwknopd / SPA and iptables recent / odin. Use it for port knocking and access control.

CrowdSec Manager — Firewall Bouncer management

routerforge-crowdsec-manager · Beta

CrowdSec LAPI connectivity, Firewall Bouncer lifecycle, ipset/iptables diagnostics and block statistics. Use it if you deploy CrowdSec protection.

Profiling — RouterForge diagnostics

routerforge-profiling

Local Core profiling for development and performance analysis. Optional for advanced diagnostics.

Supported platforms

RouterForge targets Keenetic / Netcraze with Entware.

Architecture Status
aarch64-3.10 Primary, hardware-validated
mipsel-3.4 Experimental, partly validated
mips-3.4 Experimental

Entware in /opt, opkg, root access and curl or wget are required. See Architecture compatibility.

Community

Ideas, feedback and questions: Telegram @RouterForge. Bugs and technical requests: GitHub Issues.

Documentation

Development

Backend: Go 1.21+. Frontend: Node.js 22.x.

sh scripts/build-frontend.sh
sh scripts/build-dns-frontend.sh
sh scripts/build-admin-frontend.sh
sh scripts/build-monitoring-frontend.sh
go test ./...
go vet ./...

See CONTRIBUTING.md.

License

MIT · Copyright © 2026 Fifth-Ace.