Skip to content
Get packs

OpenClash

A LuCI plugin that runs the Mihomo (Clash Meta) proxy client on OpenWrt routers.

GitHub Download v0.48.002
Stars
28k
Forks
4.1k
Licence
MIT
Language
JavaScript
Last update
4 days ago
Type
App

What it is

OpenClash is a web-interface add-on for OpenWrt, a Linux-based router firmware. It manages the Mihomo (Clash Meta) proxy core so that traffic from devices on your home network can be routed through proxy servers based on rules you configure. The README says it supports protocols including Shadowsocks, VMess, VLESS, Trojan, Snell, TUIC and Hysteria, and offers transparent proxying and subscription management.

  • Route selected websites or apps through a proxy while other traffic goes direct, using rule configuration
  • Import a proxy subscription and switch between multiple configuration files from the LuCI web page
  • Use the built-in dashboards to monitor the Mihomo core
  • Back up and restore configuration files, or edit them online

Great for

  • People who already run OpenWrt on a router and want rule-based proxy routing for the whole network
  • Users who manage several proxy subscriptions and config files from one place
  • Households wanting per-device or per-site traffic split without installing software on each device
  • Users comfortable reading router network settings and firewall options

Not ideal for

  • People without OpenWrt: the plugin is installed into OpenWrt's LuCI interface and will not run on ordinary PCs or phones
  • Beginners who have never configured a router, since setup involves dependencies, firewall modes and proxy configuration
  • Users who want a simple one-click proxy app on a desktop, because the project is aimed at router deployments
Step-by-step guide: how to use OpenClashInstall, first run, examples, tips and FAQs

How to get it

  1. 1

    Install with a package manager

    You'll need: OpenWrt with LuCI (README lists Luci 19.07 or newer for luci-compat) · opkg (ipk) or apk package manager on the router · Dependencies listed in README such as bash, curl, ruby, ruby-yaml, dnsmasq-full, kmod-tun (optional)

    Update package lists (opkg)

    opkg update

    Install OpenClash ipk from the release (opkg)

    opkg install /tmp/openclash.ipk

    Update package lists (apk)

    apk update

    Install OpenClash apk from the release (apk)

    apk add -q --force-overwrite --clean-protected --allow-untrusted /tmp/openclash.apk
  2. 2

    Run it

    • Download the .ipk or .apk package for your architecture from the Releases page
    • Upload and install it under System, then Software in the LuCI web interface
    • Refresh the page and open Services, then OpenClash
    • Import a subscription or upload a configuration file, then start the service
  3. 3

    Get the most out of it

    • Use the subscription management feature to keep several providers in one place
    • Choose between redir-host, fake-ip or mixed modes and TUN mode according to your needs, as described in the README feature table
    • Use the custom firewall rules and black/white lists for access control
    • Use the modular override YAML feature to customise configuration files without editing them directly

Downloads

Source code (.zip)master branch · straight from GitHubRelease v0.48.0022 files incl. luci-app-openclash_0.48.002_all.ipk

Strengths

  • Built on the Mihomo core and supports a wide range of proxy protocols listed in the README
  • Provides a web interface inside OpenWrt's LuCI panel rather than requiring command-line control for daily use
  • Large, actively maintained project with MIT license and a sizable user base (27,982 stars)

Trade-offs

  • Requires OpenWrt and some networking knowledge; the README lists many dependencies that must match your firewall choice (iptables or nftables)
  • The first run downloads the core, so the README advises checking your network environment beforehand
  • README is largely in Chinese; the main user guide is an external Wiki link, so non-Chinese readers may find documentation harder to follow

How it compares

ProjectStarsTypeLevelUpdatedBest for
OpenClash (this)28kAppadvanced4 days agoPeople who already run OpenWrt on a router and want rule-based proxy routing for the whole network
v2ray-core46.9kOtheradvanced2 months agoDevelopers who want to read the source of a Go proxy platform
v2ray-core34.7kOtheradvanced5 days agoDevelopers who want to build and configure their own proxy server
clashctl15.1kCLIintermediate9 days agoLinux users comfortable with the terminal who want a command-driven Clash setup
gluetun16kAppintermediate8 days agoPeople who want one Docker container to run traffic through a VPN for other containers

Stats synced from GitHub. The assessment above was drafted with AI from the project's README on 2026-10-29 and may miss recent changes — check the README before relying on a command. MIT licence: free to use, modify and distribute, including commercially, as long as you keep the copyright notice.