OpenClash is a LuCI plugin for OpenWrt routers, managing Mihomo and gateway routing. Windows, Mac and phones cannot directly install its IPK/OpenWrt APK; use a client for that device or connect through a configured router.
Choose .ipk when the firmware uses opkg, or an OpenWrt .apk when it uses apk; this APK is not an Android installer. This site’s IPK backup is supplied as a ZIP: extract the .ipk on your computer before uploading and installing it. The all architecture label applies only to the LuCI plugin package, not to the Mihomo core. The core must still match the router’s CPU, endianness and OS. Also distinguish iptables from firewall4 when installing dependencies, and use the dependency set appropriate to your firmware.
Plugin installation may be similar, but gateway, DNS, DHCP and forwarding paths differ. A main router usually advertises the gateway and DNS; a secondary gateway needs an explicit client and DNS path. Test one device before changing network-wide DHCP and keep management access.
Identify whether the failed request is the subscription URL or a GitHub plugin/core download and inspect that download log. The router itself needs internet and DNS access. For curl (6), check router DNS; for timeouts, check the network path; for certificate errors, check time and CA certificates. Check free space and subscription validity: access from a phone does not prove router access. Once downloaded, check profile syntax or core architecture. For manual upload, open “配置管理” (Config Manage), set “上传文件类型” (Upload File Type) to “[Meta] 内核文件(.tar.gz)” (Meta Core File), choose an official .tar.gz core archive matching the CPU, then select “上传” (Upload). This upload control requires .tar.gz; renaming a .gz extension does not convert it. Do not choose the configuration or backup type, or upload a LuCI plugin as the core. Reinstalling the plugin does not diagnose DNS failures.
In OpenClash, open Config Manage and select Backup to download and save a plugin backup. Separately, use Generate archive on OpenWrt’s system backup page to save the system settings. Record the original gateway and DNS settings and current core version, and retain the previous plugin installer and working core files. Update the plugin, core and subscription separately, testing one client device after each change. If a problem occurs, disable the plugin and wait for it to stop, then roll back the plugin or core you just updated to its previous working version. To restore the plugin backup, open Config Manage, set Upload File Type to Backup File and upload the saved .tar.gz. Restore any manually changed gateway or DNS settings from your notes, then test direct internet access on the client and access to the router’s admin page. Store backups privately because they may contain subscription credentials.
Importing a subscription only retrieves a profile; starting also requires selecting that profile and having a core that can run. In Config Manage, find the target YAML in Config File List and select SwiTch to make it the current profile. If startup fails, open Server Logs and address the first error: for a profile parsing failure, fix the configuration at the location indicated by the error or obtain a compatible profile again; if the core is missing or its architecture does not match, reinstall the matching core; resolve permission or dependency errors according to the log. Change one thing at a time, then start again to verify.
Compare a direct site, your target and the router-admin page on one device, checking its actual gateway and DNS. If the router works but clients fail, inspect DHCP, forwarding and access control. If IP access works but names fail, inspect DNS. When requests appear in connection records, check their matched rules, policy group and server. To recover, turn off the plugin switch in Running Status, wait for it to stop and restore manually changed gateway/DNS values from your notes, then retest baseline networking and admin access. Disabling the plugin does not guarantee DNS recovery on every firmware. Retain redacted logs and firmware details if it still fails, and change one setting at a time.
