ClashDownloads & routing guides
Github 中文
Home/OpenClash routers

OpenClash OpenWrt Router Guide

Treat OpenClash as a Mihomo client running on your router: confirm the firmware and network first, then import the subscription, choose a mode and check DNS.

View setup flowSubscription checksDNS and Fake-IP
Reading tip

Identify the scenario first, then follow the checks in order. Jump to the linked download, subscription or configuration page when the issue becomes specific.

Who Should Start Here

OpenClash is useful when you want an OpenWrt router to manage proxy routing for multiple devices. Unlike a desktop client, the setup lives in LuCI and can affect the whole LAN, so each step should keep the router's normal network path recoverable.

  • If you only use one computer or phone, start with the client tutorials.
  • If TVs, NAS devices or many home devices need shared routing, OpenClash may be a better fit.
  • If storage space, CPU architecture or dependencies are unclear, do not start with advanced plugins.

Setup Flow

  1. Confirm OpenWrt architecture, free storage and normal internet access.
  2. Install OpenClash and required dependencies, then reload LuCI and check that the menu appears.
  3. Add the Clash or Mihomo subscription URL in the subscription/profile area.
  4. Update the subscription and confirm nodes, proxy groups and rules are generated.
  5. Choose a conservative operating mode first and test common websites and apps.
  6. Enable DNS, Fake-IP, TUN or transparent proxy features only after the basic path works.

Choosing an Operating Mode

ScenarioStart WithCheck First
First-time setupLeast invasive modeSubscription update and node test
Whole-home routingTransparent proxy or TUN laterDNS and gateway settings
Only some devices need itDevice groups or bypass routingWhether devices point to the router gateway

Where to Look When It Fails

  • Plugin page will not open: check LuCI compatibility, dependencies and browser cache.
  • Subscription update fails: verify the URL, plan state, provider API and router DNS.
  • Node list is empty: confirm the provider gives a Clash or Mihomo profile, not a single-node or client-specific format.
  • Network breaks after enabling it: disable OpenClash, restore normal routing, then test DNS, gateway and firewall settings one by one.

Related Guides

Reference Sources