OpenClash Installation and Simple Usage Tutorial and Common Error Solutions (OpenWRT) (December 6, 2021)

Project Introduction#

Project Address: OpenClash
Official Documentation: wiki
Clash Kernel: Clash
TUN Mode Kernel: clash_tun
TUN Game Mode Kernel: clash_game (removes game kernel and mode, TUN kernel has more features)
Historical Version Download: Download

Installation#

Installation Environment#

Architecture: MediaTek MT7621
Firmware Version: OpenWrt R20.8.27 / LuCI Master (git-20.223.26773-d18ef13)
Kernel Version: 5.4.59

Content Updates#

2021.12.6#

Openclash Version: v0.44.03-beta
Important feature configuration suggestions

2021.6.15#

The small entertainment router can run OpenClash stably.
I noticed many comments mentioning ac2100; I bought one a while ago. I tested it here and found that after running for a while, it would lose connection. Upon entering the backend, OpenClash showed it was not running, and it had to be manually stopped or started to function normally. This indicates that running OpenClash on ac2100 is a bit more demanding; it can only be used as an AP or switch to Passthrough. Passthrough works basically normally but does not have as many features as OpenClash. It is still recommended to run these plugins on a soft router, as even a router costing over a hundred yuan can run stably.

Entering the Backend#

Enter via terminal

ssh root@192.168.1.1

If you cannot log in normally, please check if the password is correct or if SSH login is enabled in the backend.

Dependency Installation#

Update

opkg update

If there is an update error, please check if the address in System - Software - Configuration is available.
Small entertainment router software source (MT7621)

src/gz openwrt_core https://downloads.openwrt.org/snapshots/targets/ramips/mt7621/packages/
src/gz openwrt_base https://downloads.openwrt.org/snapshots/packages/mipsel_24kc/base/
src/gz openwrt_luci https://downloads.openwrt.org/snapshots/packages/mipsel_24kc/luci/
src/gz openwrt_packages https://downloads.openwrt.org/snapshots/packages/mipsel_24kc/packages
src/gz openwrt_routing https://downloads.openwrt.org/snapshots/packages/mipsel_24kc/routing
src/gz openwrt_telephony https://downloads.openwrt.org/snapshots/packages/mipsel_24kc/telephony

Install Dependencies (v0.44.03-beta)
coreutils-nohup, bash, iptables, dnsmasq-full, curl, ca-certificates, ipset, ip-full, iptables-mod-tproxy, iptables-mod-extra, libcap, libcap-bin, ruby, ruby-yaml, kmod-tun

Install the above dependencies in order, each dependency should be installed separately.

If you cannot install kmod-tun (shows kernel version mismatch)
Force install

opkg install kmod-tun --force-depends

The same method can be used to solve similar issues.

Error: opkg_conf_load: Could not lock /var/lock/opkg.lock: Resource temporarily unavailable.

rm -f /var/lock/opkg.lock

After confirming that the dependencies are successfully installed, you can proceed with subsequent operations.

Main Program Installation#

Enter the tmp directory

cd /tmp/tmp/

Download and install ipk (v0.44.03-beta)

wget https://github.com/vernesong/OpenClash/releases/download/v0.44.03-beta/luci-app-openclash_0.44.03-beta_all.ipk
opkg install luci-app-openclash_0.44.03-beta_all.ipk

Note to change the software name according to the downloaded version.

Kernel Download#

Enter the kernel directory (choose according to your hardware)

Clash Kernel

cd /etc/openclash/core/
wget https://github.com/vernesong/OpenClash/releases/download/Clash/clash-linux-mipsle-softfloat.tar.gz
tar -zxvf clash-linux-mipsle-softfloat.tar.gz
chmod 777 clash

Other kernels follow the same method.

Installation complete.