OpenClash-Grundlagen: Kompatibilität, DNS-Konflikte und sauberes Deaktivieren

Geltungsbereich: Diese Seite behandelt Kompatibilität, DNS-Konflikte, Start/Stopp und Wiederherstellung in einer rechtmäßigen Umgebung. Sie stellt keine Proxy-Server, Abonnement-Links oder Regelsätze bereit und beschreibt keine Schritte zur Umgehung von Netzwerkkontrollen oder Dienst-/Regionsbeschränkungen. Prüfen Sie vor der Nutzung das örtliche Recht, die Bedingungen Ihres ISP und die Bedingungen des Dienstes, auf den Sie zugreifen.

Ergebnis

Sie entscheiden, ob Ihre Firmware, Architektur und Ihr Paketformat zu einem OpenClash-Release passen.
Sie prüfen, ob es auf Port 53 mit dnsmasq oder AdGuard Home in Konflikt gerät.
Sie verifizieren Prozess-, Log- und Port-Status, statt sich allein auf die LuCI-Seite zu verlassen.
Sie stellen nach dem Deaktivieren DNS und die grundlegende Konnektivität wieder her.
Sie wissen, was diese Seite bewusst nicht abdeckt.

Anwendbare Umgebung und Annahmen

OpenWrt 25.12.6 (apk) oder 24.10 (opkg); x86/ARM muss zum Release-Paket passen.
OpenClash ist eine LuCI-App eines Drittanbieters und benötigt in der Regel einen passenden Mihomo/Meta-Core; Frontend, Core und Firmware müssen zueinander kompatibel sein.
apk unter 25.12 und ipk unter 24.10 sind unterschiedliche Formate. Benennen Sie eine .ipk nicht in .apk um und erzwingen Sie kein Paket einer anderen Architektur.
Identifizieren Sie bei Hersteller-Firmware/ImmortalWrt/iStoreOS zuerst die Quelle und den Paketmanager (siehe die Seite zur Firmware-Identifikation).

Prüfungen vor der Installation

Router-ShellFirmware, Architektur und freien Speicher prüfen

ubus call system board
cat /etc/openwrt_release
uname -m
command -v apk
command -v opkg
df -h /
free -h

Notieren Sie release.target, DISTRIB_ARCH, den Paketmanager und den freien Speicher. OpenClash samt Core und Regeldaten kann mehrere Dutzend MB belegen; erzwingen Sie die Installation nicht auf einem vollen Rootfs.

ErwartetSie kennen Paketformat, CPU-Architektur und verfügbaren Speicherplatz.

Router-ShellEin passendes Release-Paket finden

Verwenden Sie ausschließlich die offizielle OpenClash-Release-Seite und prüfen Sie:

Hauptversion der Firmware (25.12 / 24.10);
Paketformat (apk / ipk);
CPU-Architektur (x86_64, aarch64 usw.);
Abhängigkeiten (Kernel-Module, bash/curl, laut Release Notes);
SHA-256/Prüfsumme von der Release-Seite.

Gibt es kein passendes Paket, brechen Sie ab. Erzwingen Sie kein „universelles“ Paket und keinen Build eines Dritten.

ErwartetSie finden ein apk/ipk für genau diese Firmware und Architektur.

Router-ShellDNS-/Port-Basiswert erfassen

netstat -lnp | grep -E ':53|:5353|:7874|:9090'
cat /tmp/resolv.conf.d/resolv.conf.auto
nslookup openwrt.org 127.0.0.1

Belegt AdGuard Home Port 53 und läuft dnsmasq auf 5353, darf OpenClash nicht ebenfalls Port 53 übernehmen. Legen Sie vor dem Start fest, wer DNS betreibt.

ErwartetSie wissen, wer Port 53 belegt und was Wiederherstellung bedeutet.

Minimale Einrichtung (ohne Proxy-Endpunkte)

LuCIZuerst Frontend und Core starten, ohne DNS-Übernahme

Gehen Sie in Dienste → OpenClash:

Wählen Sie einen Core, der zur Architektur passt.
Lassen Sie DNS-Übernahme/-Hijack vorerst deaktiviert.
Speichern und starten.
Öffnen Sie die Log-Seite und stellen Sie sicher, dass es keine Meldung wie „core mismatch / port in use / missing dependency“ gibt.

Diese Seite stellt keine Proxy-Server, Abonnements oder Regeln bereit. Haben Sie keine rechtmäßige Konfiguration, hören Sie hier auf; fügen Sie kein unbekanntes Abonnement ein, nur damit es „läuft“.

ErwartetDer Dienst startet und LuCI zeigt den Status an.

Router-ShellProzess, Ports und Logs bestätigen

ps w | grep -Ei 'openclash|mihomo|clash' | grep -v grep
netstat -lnp | grep -E ':7874|:9090|:53'
logread | grep -i openclash | tail -30

Die Ports hängen von Ihrer Konfiguration ab; die entscheidende Regel lautet: Lassen Sie niemals zwei Prozesse Port 53 belegen. Meldet das Log einen DNS-Bind-Fehler, deaktivieren Sie OpenClash, statt es wiederholt neu zu starten.

ErwartetOpenClash/Core läuft ohne Konflikt auf Port 53.

Deaktivieren und Wiederherstellen

Router-ShellDeaktivieren und grundlegende Konnektivität bestätigen

/etc/init.d/openclash stop
/etc/init.d/openclash disable
uci show openclash
/etc/init.d/dnsmasq restart
nslookup openwrt.org 127.0.0.1

Haben Sie zuvor den dnsmasq-Port oder die DHCP-Option 6 geändert, stellen Sie sie gemäß den DNS-/AGH-Seiten wieder her; stellen Sie sicher, dass Clients nicht mehr auf einen gestoppten OpenClash-DNS verweisen.

ErwartetNamensauflösung und Internet funktionieren ohne OpenClash.

Fehlerfälle und Wiederherstellung

Kein Internet nach Aktivierung von OpenClash

Erreichen Sie das Gerät über LAN/Konsole.
Stoppen Sie OpenClash.
Stellen Sie dnsmasq auf Port 53 und das DHCP-DNS wieder her.
Prüfen Sie, ob Firewall-/DNS-Hijack-Regeln zurückgeblieben sind.
Starten Sie bei Bedarf neu; stellen Sie die grundlegende Konnektivität wieder her, bevor Sie weiter suchen.

LuCI ist nicht erreichbar

Klicken Sie nicht wiederholt auf „restart“. Stoppen Sie den Dienst per SSH/Konsole:

/etc/init.d/openclash stop
/etc/init.d/openclash disable
logread | tail -50

Blockiert eine Firewall-Regel die Verwaltung, stellen Sie den Zugriff über die Konsole wieder her; setzen Sie nicht blind auf Werkseinstellungen zurück.

Paketformat/Architektur passt nicht

25.12 verwendet apk; 24.10 verwendet ipk; sie sind nicht austauschbar.
Pakete für x86_64 und aarch64 sind nicht austauschbar.
Passen Frontend- und Core-Version nicht zusammen, kehren Sie zur auf der Release-Seite genannten Kombination zurück.
Deaktivieren Sie nicht alle Signatur-/Verifizierungsprüfungen, nur um zu installieren.

DNS-Konflikt/-Schleife

Nur ein einziger DNS-Haupteinstiegspunkt darf Port 53 belegen.
AdGuard Home, dnsmasq und OpenClash-DNS dürfen nicht in einer Schleife aufeinander verweisen.
Stoppen Sie OpenClash, stellen Sie dnsmasq/AGH wieder her und fügen Sie die Komponenten dann einzeln wieder hinzu.
Testen Sie 127.0.0.1, die LAN-Adresse und den Upstream jeweils separat mit nslookup.

Compliance und Versionsgrenzen

Nutzen Sie es nur in Netzwerken und unter Dienstbedingungen, die es erlauben. Diese Seite liefert keine Umgehung, keine Umgehung von Regions-/Zugriffskontrollen und keine Inhalte zu geteilten Konten oder Abonnements.
OpenClash/Mihomo sind Drittanbieter-Projekte mit schnell wechselnden Versionen/Abhängigkeiten; lesen Sie die Release Notes und halten Sie ein Rollback-Paket bereit.
Dies ist keine Rechtsberatung; klären Sie Compliance-Fragen vor dem Einsatz.

E2-Laborlauf (2026-10-20)

Umgebung: OpenWrt 25.12.6 x86-VM 200; offizielle luci-app-openclash 0.48.002 .apk.
apk add --allow-untrusted installierte 43 Pakete (darunter luci-compat, Ruby, unzip); /etc/init.d/openclash und der LuCI-Controller sind vorhanden.
Ohne Proxy-Konfiguration/-Endpunkt meldete start den Zustand inactive; diese Seite behauptet nicht, dass „der Proxy funktioniert“.
Nach stop + disable gab nslookup openwrt.org 127.0.0.1 „connection refused“ zurück; /etc/init.d/dnsmasq restart stellte DNS wieder her und der Ping ins öffentliche Netz funktionierte.
Nicht getestet: realer Proxy-Endpunkt/Abonnement, Routing-/DNS-Treffer, Mihomo-Core, TUN/Firewall-Regeln, Leistung/Stabilität.
Recipe: tests/recipes/openclash-25.12.md.

E2-Status und Quellen

Dies ist E2 (teilweise): .apk-Installation unter 25.12, Start ohne Konfiguration, Deaktivieren und DNS-Wiederherstellung wurden getestet; tatsächlicher Proxy/Routing bleibt E1/E3.
Machen Sie ohne rechtmäßigen Endpunkt bzw. ohne rechtmäßige Konfiguration aus „installiert“ kein „Proxy funktioniert“.
Erweitern Sie diese Seite nicht zu einer Anleitung für Proxy-Abonnements/Umgehung; das liegt außerhalb des Umfangs.

Quellen

Router.Homes

Unabhängige OpenWrt-Notizen. Jede Seite nennt Firmware, Gerät, Paketmanager und den Rückweg.

Symbole: Solar by 480 Design, CC BY 4.0