explaingit

nikkinikki-org/openwrt-nikki

4,677JavaScriptAudience · ops devopsComplexity · 4/5Setup · hard

TLDR

An OpenWrt router package that routes all your home network traffic through a proxy server automatically, using Mihomo, without needing to configure anything on individual devices.

Mindmap

mindmap
  root((openwrt-nikki))
    What it does
      Transparent proxy
      Network-level routing
      No per-device config
    Proxy Modes
      Redirect
      TPROXY
      TUN
    Features
      Access control
      IPv4 and IPv6
      Scheduled restart
    Interface
      LuCI web panel
      Profile editor
      Mixin system
    Requirements
      OpenWrt 24.10
      Kernel 5.13 or above
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Route all home network traffic through a proxy without touching individual device settings, so every connected device benefits automatically.

USE CASE 2

Access region-restricted content from any device on your home network by pointing the router proxy at a server in another country.

USE CASE 3

Apply per-device access control rules to decide which devices use the proxy and which connect directly.

USE CASE 4

Manage proxy profiles through the router's built-in web interface without editing config files manually.

Tech stack

JavaScriptLuCIOpenWrtMihomo

Getting it running

Difficulty · hard Time to first run · 1h+

Requires a router running OpenWrt 24.10 or later with Linux kernel 5.13+, most consumer routers need firmware replacement first.

No license terms are stated in the explanation.

In plain English

OpenWrt-nikki is a package that adds transparent proxy support to OpenWrt routers using a tool called Mihomo. OpenWrt is a Linux-based operating system you can install on many home routers to replace the manufacturer firmware, giving you much more control over network traffic. Mihomo is a proxy engine that can route traffic through servers in other locations, commonly used to access content that is region-restricted or to add an extra layer of privacy. The word "transparent" in this context means the proxy operates at the network level, handling traffic from devices on your local network without requiring any configuration on those devices. Everything passing through the router can be proxied automatically, rather than each device needing its own proxy settings. The package supports three modes for intercepting traffic: Redirect, TPROXY, and TUN, and it works with both IPv4 and IPv6. Beyond basic proxying, the package includes access control so you can decide which devices or destinations get routed through the proxy and which go direct. There is a profile editor built into the router's LuCI web interface, a mixin system for layering configuration on top of an existing proxy profile, and a scheduled restart option. The LuCI interface is the standard web-based admin panel that OpenWrt routers use. Installation requires OpenWrt version 24.10 or later and a Linux kernel at version 5.13 or above. The recommended setup adds the project's feed to the package manager and installs three packages: the core nikki package, a LuCI app for the web interface, and an optional Chinese language pack. A one-line script handles the feed setup. There is also a release-based installer script for routers that prefer that approach. The README is brief, detailed usage instructions are in the project's wiki rather than in the repository itself.

Copy-paste prompts

Prompt 1
I have an OpenWrt 24.10 router and want to install openwrt-nikki. Walk me through adding the feed and installing the three required packages.
Prompt 2
How do I configure access control in openwrt-nikki to route only specific devices through the Mihomo proxy while others go direct?
Prompt 3
I already have a Mihomo proxy profile file. How do I import it into openwrt-nikki and apply a mixin on top to override specific settings?
Prompt 4
What is the difference between Redirect, TPROXY, and TUN interception modes in openwrt-nikki, and which should I use for an IPv4 and IPv6 dual-stack home network?
Open on GitHub → Explain another repo

← nikkinikki-org on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.