Repolode
Submit
vernesong

vernesong/OpenClash

A LuCI plugin that runs the Mihomo (Clash Meta) proxy client on OpenWrt routers, with rule-based traffic splitting and transparent proxying.

View on GitHub
Stars
28,079
Forks
4,058
Open issues
57
Last commit
yesterday

What is it?

OpenClash is a LuCI web-interface plugin for OpenWrt that manages the Mihomo (formerly Clash Meta) core on a router. It supports common proxy protocols such as Shadowsocks, ShadowsocksR, VMess, VLESS, Trojan, Snell, TUIC and Hysteria, so every device on the home network can route traffic through configured proxy nodes based on flexible rules.

The plugin covers the day-to-day tasks of running a router proxy: importing and merging multiple subscriptions, including online conversion through Subconverter, switching between several configuration files, editing configs in the browser, and backing up or restoring them with optional Age encryption. It offers redir-host, fake-ip and TUN run modes, works with both iptables and nftables firewalls, and includes black and white lists for access control.

Installation is done through the LuCI package manager using ipk or apk packages, or from the command line. Building from source against the OpenWrt SDK is also supported.

Key features

  • 01Runs the Mihomo (Clash Meta) and Smart cores, with online core updates and switching.
  • 02Supports redir-host, fake-ip, mixed and TUN run modes.
  • 03Works with both iptables and nftables (Firewall4) firewalls.
  • 04Manages multiple subscriptions with Subconverter online conversion.
  • 05Switches among several configuration files, with in-browser editing and backup/restore.
  • 06Provides black/white lists and custom firewall rules.
  • 07Includes automatic node selection for streaming services such as Netflix and Disney+.

Use cases

  • Routing all devices in a home or small office network through proxy nodes without per-device setup.
  • Splitting traffic so domestic sites connect directly while overseas services use a proxy.
  • Managing several proxy subscriptions and configuration profiles on an OpenWrt router.
  • Choosing proxy nodes automatically for streaming services by region.

Quick start

  1. 1

    Download the package for your architecture from the Releases page (*.ipk or *.apk)

  2. 2

    In the OpenWrt LuCI web UI, go to System → Software, upload and install the package

  3. 3

    Refresh the page, then under Services → OpenClash import a subscription or config file and start it

Things to know

  • Runs only on OpenWrt routers, not on general desktop or server systems.
  • The first run downloads the proxy kernel, so a working network connection is required.
  • Setup involves many dependency packages and firewall-specific configuration.

Topics

#clash#openwrt#mihomo#proxy#transparent-proxy#router#luci#traffic-routing#openclash#shadowsocks

FAQ

What is OpenClash?
A LuCI plugin that runs the Mihomo (Clash Meta) proxy client on OpenWrt routers, with rule-based traffic splitting and transparent proxying. OpenClash is a LuCI web-interface plugin for OpenWrt that manages the Mihomo (formerly Clash Meta) core on a router. It supports common proxy protocols such as Shadowsocks, ShadowsocksR, VMess, VLESS, Trojan, Snell, TUIC and Hysteria, so every device on the home network can route traffic through configured proxy nodes based on flexible rules.
Is OpenClash free to use? What license does it have?
OpenClash is open source under the MIT license. Check the license terms before using it in commercial products.
Is OpenClash still maintained?
Actively maintained. The last commit to OpenClash was on Nov 6, 2026.
What can I use OpenClash for?
Routing all devices in a home or small office network through proxy nodes without per-device setup. Splitting traffic so domestic sites connect directly while overseas services use a proxy. Managing several proxy subscriptions and configuration profiles on an OpenWrt router. Choosing proxy nodes automatically for streaming services by region.
How do I install OpenClash?
Download the package for your architecture from the Releases page (*.ipk or *.apk) In the OpenWrt LuCI web UI, go to System → Software, upload and install the package Refresh the page, then under Services → OpenClash import a subscription or config file and start it
Where can I get OpenClash?
The source code and installation instructions are on GitHub: https://github.com/vernesong/OpenClash

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects