# nikkinikki-org/openwrt-nikki

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/nikkinikki-org-openwrt-nikki).**

4,321 stars · 500 forks · JavaScript · gpl-3.0

## Links

- GitHub: https://github.com/nikkinikki-org/OpenWrt-nikki
- Homepage: https://nikkinikki.pages.dev
- awesome-repositories: https://awesome-repositories.com/repository/nikkinikki-org-openwrt-nikki.md

## Topics

`clash` `luci-app` `luci-app-nikki` `mihomo` `nikki` `openwrt` `transparent-proxy`

## Description

OpenWrt-nikki is an OpenWrt proxy client and transparent proxy gateway that manages network traffic diversion through remote servers. It functions as a network access controller and DNS hijacking server, intercepting IPv4 and IPv6 traffic to route it through a proxy without requiring client-side configuration.

The project features a proxy subscription manager that automates the downloading and refreshing of remote configuration profiles using custom user agents. It employs a mixin-based configuration system to inject custom rules or proxy nodes into existing profiles without overwriting source files.

Network management capabilities include fake-IP DNS hijacking to map domains to proxy targets and firewall-based traffic filtering using IP, MAC, and port-level rules. The system also provides scheduled service automation for periodic restarts and subscription updates via cron expressions.

Diagnostic tools allow for viewing and exporting system logs, while network optimization settings include TCP keep-alive tuning to reduce battery drain on mobile devices.

## Tags

### Networking & Communication

- [Transparent Network Proxies](https://awesome-repositories.com/f/networking-communication/transparent-network-proxies.md) — Intercepts network traffic at the router level to automatically route packets through a proxy without client-side configuration. ([source](https://cdn.jsdelivr.net/gh/nikkinikki-org/openwrt-nikki@main/README.md))
- [Internal DNS Resolvers](https://awesome-repositories.com/f/networking-communication/dns-resolution-managers/internal-dns-resolvers.md) — Operates an integrated DNS resolver that intercepts queries to manage routing and fake-IP assignments.
- [DNS Override Resolvers](https://awesome-repositories.com/f/networking-communication/dns-resolution/dns-override-resolvers.md) — Functions as a DNS override resolver that intercepts queries to provide fake-IPs for optimized routing.
- [Fake-IP DNS Hijacking](https://awesome-repositories.com/f/networking-communication/fake-ip-dns-hijacking.md) — Intercepts DNS queries and returns synthetic IP addresses to map domains to proxy targets for traffic interception.
- [Proxy Clients](https://awesome-repositories.com/f/networking-communication/proxy-clients.md) — Provides a network routing tool for OpenWrt that manages proxy subscriptions and traffic diversion.
- [Proxy Subscription Automation](https://awesome-repositories.com/f/networking-communication/proxy-subscription-automation.md) — Automatically updates proxy subscriptions on a predefined timetable by triggering service restarts via cron expressions. ([source](https://github.com/nikkinikki-org/OpenWrt-nikki/wiki/FAQ))
- [Proxy Subscription Managers](https://awesome-repositories.com/f/networking-communication/pub-sub-messaging/sharded-pub-sub/proxy-subscription-managers.md) — Synchronizes and updates remote proxy server subscription lists from external providers automatically.
- [Transparent Proxies](https://awesome-repositories.com/f/networking-communication/transparent-proxies.md) — Intercepts IPv4 and IPv6 network traffic at the network layer to route it through a proxy without client configuration.
- [Device-Based Access Controls](https://awesome-repositories.com/f/networking-communication/ftp-clients/user-access-controls/device-based-access-controls.md) — Restricts or permits proxy access based on device IP, MAC address, or user group for local traffic. ([source](https://github.com/nikkinikki-org/OpenWrt-nikki/wiki))
- [Fake-IP Filters](https://awesome-repositories.com/f/networking-communication/network-reliability-diagnostics/network-filtering/ip-address-filters/fake-ip-filters.md) — Employs blacklists to prevent specific domains or regions from using fake IP addresses, returning real IPs instead. ([source](https://github.com/nikkinikki-org/OpenWrt-nikki/wiki/FAQ))
- [Proxy Configuration Profiles](https://awesome-repositories.com/f/networking-communication/proxy-configuration-profiles.md) — Manages and edits sets of network proxy configuration profiles using mixins to customize routing behavior. ([source](https://cdn.jsdelivr.net/gh/nikkinikki-org/openwrt-nikki@main/README.md))
- [Rule Injection](https://awesome-repositories.com/f/networking-communication/proxy-servers/proxy-configurations/rule-injection.md) — Enables injecting custom rules or proxy nodes into existing configuration files through a mix-in system. ([source](https://github.com/nikkinikki-org/OpenWrt-nikki/wiki))
- [Traffic Filters](https://awesome-repositories.com/f/networking-communication/traffic-filters.md) — Implements firewall-based traffic filtering using IP, MAC, and port-level rules to control proxy bypass.
- [Port-Based Filters](https://awesome-repositories.com/f/networking-communication/traffic-filters/port-based-filters.md) — Bypasses the proxy for specific target ports to ensure certain network traffic remains direct. ([source](https://github.com/nikkinikki-org/OpenWrt-nikki/wiki/FAQ))
- [Selective Traffic Routing](https://awesome-repositories.com/f/networking-communication/traffic-routing-rules/selective-traffic-routing.md) — Routes network traffic selectively by bypassing the proxy for specific IP ranges and firewall marks. ([source](https://github.com/nikkinikki-org/OpenWrt-nikki/wiki))

### Operating Systems & Systems Programming

- [OpenWrt Proxy Management](https://awesome-repositories.com/f/operating-systems-systems-programming/openwrt-proxy-management.md) — Provides a proxy client and transparent gateway specifically for OpenWrt routers to route network traffic.

### Security & Cryptography

- [Network Access Control](https://awesome-repositories.com/f/security-cryptography/network-access-control.md) — Provides network-level traffic filtering and access policy enforcement to regulate which devices use the proxy service. ([source](https://cdn.jsdelivr.net/gh/nikkinikki-org/openwrt-nikki@main/README.md))

### DevOps & Infrastructure

- [Configuration Merging](https://awesome-repositories.com/f/devops-infrastructure/configuration-management/file-based-configuration/configuration-file-loading/configuration-merging.md) — Combines static configuration files with dynamic mixin overrides to inject custom rules without altering source files.