Skip to content

OpenClash Download & Setup Guide | OpenWrt Network Traffic Control Plugin

OpenClash is a Clash client plugin running on the OpenWrt router system. It has a full-featured LuCI interface, supports Clash.Meta (Mihomo) core, can achieve transparent proxy for all devices in the house, and is the preferred tool for soft router users. Official Repository ↗

OpenClash

OpenWrtRouter Plugin

Features

  • Full House Takeover: Deployed on the router side, no need to configure clients on each device separately.
  • Rich Strategies: Supports advanced routing strategies such as access control, dynamic DNS, and failover.
  • Kernel Switching: Supports one-click switching and updating of multiple Clash kernels such as Dev/Premium/Meta.
  • Visual Panel: Provides powerful Yacd/Metacubexd control panels, making traffic monitoring clear at a glance.

OpenClash Program Download

OpenClash is released as an .ipk plugin package, usually only the universal package is needed.

ArchitectureDescriptionOfficial DownloadFast Download
Universalluci-app-openclashDirect⚡️ Fast

💡 Tip: The plugin package is usually universal (all.ipk) and does not distinguish between CPU architectures. The version number may update over time, it is recommended to check GitHub Releases for the latest version.

Installation Tutorial

1. Environment Preparation and Dependencies

Connect to the router terminal via SSH and execute the following commands to update the software source and install necessary dependencies (ensure the router is connected to the internet):

bash
opkg update
opkg install coreutils-nohup bash dnsmasq-full curl ca-certificates ipset ip-full libOpkg-full libcap libcap-bin ruby ruby-yaml kmod-tun

If dnsmasq prompts a conflict, you may need to uninstall dnsmasq first and then install dnsmasq-full. This operation has the risk of disconnection, please proceed with caution.

2. Upload and Install Plugin

Upload the downloaded luci-app-openclash...ipk file to the /tmp directory of the router (using WinSCP or SCP command). Then execute the installation:

bash
cd /tmp
opkg install luci-app-openclash_*.ipk

After installation, log in to the OpenWrt background refresh page, and you should see "Services" -> "OpenClash".

Configuration and Startup

1. Get Configuration

Get the subscription address (Clash format) from the service provider.

2. Import Configuration File

  1. Enter OpenClash -> Config Subscribe.
  2. Click Add.
  3. Config Alias: Any name.
  4. Subscribe Address: Paste the subscription link provided by the airport.
  5. Click Commit Settings.
  6. Click Update Config to download the configuration file.

3. Kernel Download and Start

OpenClash usually automatically downloads the kernel on the first startup. If the download fails, you can download the kernel manually.

  1. Go to Global Settings -> Version Update.
  2. Click Update Core.
  3. After the download is complete, go to the Overviews page and click Enable OpenClash.

Wait a moment, if Main Program displays "Running", the proxy is successfully started.

Panel Management

Click the Open Panel button on the overview page to enter the dashboard (such as Yacd) to manage proxies and view traffic.

All resources are from the open-source community. Disclaimer