Fehlerbehebung und häufige Fragen

1. Bevor Sie eine Meldung erstellen

1. Öffnen Sie das Menü von MultihomingGuard. Die Fußzeile zeigt Quelle: Daemon, wenn der Hintergrunddienst antwortet. Steht dort lokal (kein Daemon), läuft der Dienst nicht – die App zeigt dann nur ihre eigene Einschätzung und schaltet nichts. Prüfen Sie im Terminal: sudo launchctl print system/com.feichtiq.multihomingguard.daemon.
2. Prüfen Sie in der Schnittstellenliste, ob Ihr Kabeladapter erkannt wird: grüner Punkt = Link und gültige Adresse, gelber Punkt = Link ohne gültige Adresse (z. B. 169.254.x.x), grau = kein Link.
3. Wählen Sie Aktualisieren, um den Zustand neu zu lesen.
4. Stellen Sie sicher, dass Sie die aktuelle Version verwenden (steht unter dem App-Namen im Menü). Nur die aktuelle Version erhält Fehlerkorrekturen.
5. Kopieren Sie mit Diagnose die letzten Entscheidungen des Dienstes in die Zwischenablage und fügen Sie sie der Meldung bei.

2. WLAN bleibt eingeschaltet, obwohl das Kabel steckt

• Ein Kabel gilt erst als funktionierend, wenn Link, eine gültige IPv4- oder IPv6-Adresse mit Gateway und eine Antwort des DNS-Servers des Kabelnetzes über diesen Adapter vorliegen. Zeigt das Menü Kabel wird geprüft, fehlt noch eines davon – meist DHCP oder DNS. Bleibt es dabei, zeigt das Menü Kabel ohne Internet, und WLAN bleibt absichtlich an, damit Sie nicht ohne Verbindung dastehen.
• Der Netzwerkdienst des Adapters muss in Systemeinstellungen > Netzwerk vorhanden sein. Neue Docks oder Adapter legt macOS manchmal erst nach dem ersten Anstecken als Dienst an; stecken Sie kurz ab und wieder an.
• Haben Sie WLAN selbst ausgeschaltet und wieder eingeschaltet, während das Kabel steckte, wird das respektiert, bis sich die Kabelsituation ändert (siehe Punkt 4).
• Der Schutz ist möglicherweise pausiert (Symbol Pause im Menü) oder in der Konfiguration abgeschaltet (Symbol durchgestrichenes Schild).
• Virtuelle Adapter, VPN-Tunnel, Thunderbolt-Bridge und Bluetooth PAN werden bewusst nicht als Kabel gewertet.

3. WLAN kommt nach dem Abstecken nicht zurück

• Normalerweise ist WLAN innerhalb einer Sekunde wieder an. Stecken Sie das Kabel ab und wieder an und wählen Sie Aktualisieren.
• Steht dort „Keine Verbindung“ mit orangefarbenem Symbol, ist WLAN eingeschaltet, hat aber noch keine Adresse – etwa weil kein bekanntes Netz in Reichweite ist. Das ist eine ehrliche Meldung, kein Fehler der App: Sie behauptet in diesem Fall bewusst nicht „WLAN aktiv“. Wählen Sie ein Netz aus, oder warten Sie den Beitritt ab.
• Steht in der Fußzeile lokal (kein Daemon), läuft der Dienst nicht und kann WLAN nicht einschalten. Schalten Sie WLAN im Kontrollzentrum oder in den Systemeinstellungen ein und melden Sie den Fall mit der Diagnose.
• Beenden im Menü beendet nur die Menüleisten-App; der Hintergrunddienst und damit der Schutz laufen weiter. Die App startet bei der nächsten Anmeldung wieder oder sofort über /Programme/MultihomingGuard.app.

4. Ich habe WLAN selbst ausgeschaltet – warum bleibt es aus?

Das ist gewollt: Ein von Ihnen ausgeschaltetes WLAN (Kontrollzentrum, Systemeinstellungen) wird respektiert; das Menü zeigt WLAN von Ihnen ausgeschaltet. Der Dienst schaltet es erst wieder ein, wenn Sie es selbst einschalten oder sich die Kabelsituation ändert (Kabel gesteckt oder gezogen).

5. Fragt die App nach einem Passwort?

Nein. Die Installation erfolgt als Paket per Doppelklick und verlangt einmal Administratorrechte, wie bei jedem Installationspaket; im Alltag wird niemand nach einem Passwort gefragt. Nur der versteckte Admin-Bereich (⌥ beim Öffnen des Menüs gedrückt halten, dann Admin-Modus öffnen…) verlangt für eine Pause eine Administrator-Anmeldung über den macOS-Dialog. Die App sieht das Passwort nie.

6. Schutz vorübergehend anhalten (Pause)

• Halten Sie ⌥ gedrückt, während Sie das Menü öffnen, und wählen Sie Admin-Modus öffnen….
• Dauer wählen und Als Admin aussetzen: macOS fragt nach Name und Passwort eines Administrators. Das eigene Kennwort eines Standardbenutzers genügt nicht.
• Die Pause endet automatisch nach der gewählten Dauer (höchstens vier Stunden) oder über Fortsetzen. Jede Pause wird im Systemprotokoll vermerkt.

7. Der WLAN-Name wird nicht angezeigt

macOS gibt den Netzwerknamen nur an Apps mit Standortfreigabe heraus. Beim ersten Öffnen des Menüs fragt macOS danach; alternativ wählen Sie Netzwerkname anzeigen… im Menü. Wurde die Freigabe abgelehnt, hilft Systemeinstellungen > Datenschutz & Sicherheit > Ortungsdienste > MultihomingGuard. Band und Kanal werden auch ohne Freigabe angezeigt; die Funktion des Schutzes ist davon unabhängig.

7a. Apple Watch, AirDrop und Handoff am Kabel

Wenn das Menü Kabel aktiv – WLAN aus zeigt, wird nur die WLAN-Verbindung entfernt (IPv4 und IPv6 des WLAN-Dienstes stehen auf „Aus“). Das WLAN-Modul bleibt eingeschaltet, deshalb funktionieren Entsperren mit der Apple Watch, Bestätigen mit der Apple Watch, AirDrop, Handoff, Sidecar und Universal Control unverändert weiter.

In den Systemeinstellungen > Netzwerk steht WLAN in diesem Zustand auf „Nicht verbunden“ bzw. ohne IP-Adresse – das ist gewollt. Sobald das Kabel weg ist, wird die vorherige Konfiguration automatisch wiederhergestellt.

8. iPhone per USB

• Ein per USB angestecktes iPhone mit aktivem Persönlichem Hotspot zählt als Kabelweg: Es wird wie ein LAN geprüft, danach wird die WLAN-Verbindung abgeschaltet.
• Steckt zusätzlich ein echtes LAN-Kabel, wird der iPhone-Dienst geparkt (in den Netzwerkeinstellungen deaktiviert), damit kein Mobilfunk-Datenvolumen verbraucht wird. Fällt das LAN weg, wird er automatisch wieder freigegeben.
• Soll das iPhone parallel aktiv bleiben: ⚙ im Menü, iPhone-Tethering bei LAN erlauben. Ist der Schalter ausgegraut, läuft der Hintergrunddienst nicht.

8a. Updates

• Liegt eine neue Version vor, zeigt das Menü „Version … verfügbar“ mit Update installieren…. Ein Klick lädt das Paket, prüft es und installiert es ohne Passwortabfrage; die App startet danach neu und meldet einmal „Update auf … installiert“.
• Manuell prüfen: ⚙ → Jetzt prüfen. Die Prüfung braucht Internet.
• „Download blockiert von …“. Manche Firmennetze prüfen Downloads und signieren sie dabei mit einem eigenen Zertifikat neu. Die Meldung nennt, wer blockiert – den Namen aus diesem Zertifikat, also in der Regel den Proxy Ihrer Organisation. Die App lädt dann bewusst nicht weiter – nicht, weil das Paket schlecht wäre, sondern weil sie nicht unterscheiden kann, wer da eingreift. Die kleine Update-Prüfung selbst kommt oft durch, nur das Paket nicht; deshalb wird ein Update gemeldet, das sich nicht laden lässt. Abhilfe: in einem anderen Netz laden (etwa über einen iPhone-Hotspot), oder das Paket von der App-Seite laden und per Doppelklick installieren. Die Echtheit hängt nicht am Übertragungsweg: Prüfsumme und Signatur des Pakets werden in jedem Fall geprüft.
• „Paket ist nicht von FEICHTIQ signiert“: Das Paket wurde unterwegs verändert oder stammt nicht vom Entwickler; die App installiert es bewusst nicht. Erneut versuchen oder von der App-Seite laden.

9. Dock oder USB-Adapter wird nicht erkannt

• Prüfen Sie, ob der Adapter unter Systemeinstellungen > Netzwerk erscheint. Wenn nicht, fehlt gegebenenfalls ein Treiber des Herstellers.
• Erkannt werden Ethernet, USB-Ethernet, Thunderbolt-Ethernet, Dock-Adapter und iPhone-USB-Tethering, auch mehrere gleichzeitig (z. B. an fremden Dockingstations). Nennen Sie in einer Meldung Hersteller und Modell und den Namen des Netzwerkdienstes.

10. Verhalten mit VPN

VPN-Tunnel werden nicht als Kabel gewertet und nicht verändert. Wechselt der Dienst von WLAN auf Kabel, muss sich ein VPN-Client in der Regel neu verbinden; das ist Verhalten des VPN-Clients, nicht der App.

• „VPN aktiv“ im Menü. Läuft ein Tunnel, zeigt das Menü „VPN aktiv“ mit dem Tunnelgerät (z. B. utun12). Erkannt wird das herstellerunabhängig an einem Tunnelanschluss mit erreichbarer Adresse – die leeren Tunnel, die macOS selbst betreibt, zählen nicht.
• Interne Adressen lassen sich nicht auflösen. Ursache ist fast immer ein Gerät am Kabel – typischerweise ein iPhone –, das einen eigenen Namensdienst anmeldet. macOS stellt diesen vor den des Firmen-VPN, und weil er die interne Zone mit „gibt es nicht“ beantwortet, fragt macOS den VPN-Server gar nicht mehr.
• Was die App dagegen tut. Bei aktivem Schalter Firmen-DNS bei aktivem VPN schützen (⚙, standardmäßig aktiv) fragt sie den Namen gezielt über die verdächtige Leitung ab und greift nur ein, wenn er dort wirklich unbeantwortet bleibt. Dann wird IPv6 dieses einen Anschlusses abgeschaltet; sobald das VPN getrennt ist, kommt es zurück. In der Diagnose steht, was geprüft und was geändert wurde.
• Bleibt es dabei, schalten Sie den Schalter aus und melden Sie den Fall mit der Diagnose – dann greift die App nicht mehr ein, und die Auflösung lässt sich von Hand prüfen.

11. Die Menüleisten-App startet nicht automatisch

Der Autostart wird bei der Installation über /Library/LaunchAgents/com.feichtiq.multihomingguard.menu.plist eingerichtet und erscheint unter Systemeinstellungen > Allgemein > Anmeldeobjekte & Erweiterungen als „MultihomingGuard“. Ist er dort ausgeschaltet, schalten Sie ihn ein oder starten Sie die App aus /Programme. Der Schutz selbst läuft unabhängig von der App.

12. Vollständig deinstallieren

Entfernen im Terminal (Administratorrechte nötig):

sudo launchctl bootout system/com.feichtiq.multihomingguard.daemon
sudo launchctl bootout gui/$(id -u)/com.feichtiq.multihomingguard.menu
sudo rm -f /Library/LaunchDaemons/com.feichtiq.multihomingguard.daemon.plist /Library/LaunchAgents/com.feichtiq.multihomingguard.menu.plist
sudo rm -f /usr/local/libexec/MultihomingGuardDaemon /Library/Preferences/com.feichtiq.multihomingguard.plist
sudo rm -rf /Applications/MultihomingGuard.app "/Library/Application Support/MultihomingGuard"
sudo pkgutil --forget com.feichtiq.multihomingguard

Schalten Sie WLAN danach bei Bedarf in den Systemeinstellungen wieder ein. Siehe auch Datenschutz-Einstellungen, Abschnitt 5.

1. Before you file a report

1. Open the MultihomingGuard menu. The footer shows Source: Daemon when the background service answers. If it says local (no daemon), the service is not running – the app then only shows its own estimate and switches nothing. Check in Terminal: sudo launchctl print system/com.feichtiq.multihomingguard.daemon.
2. Check the interface list for your wired adapter: green dot = link and valid address, yellow = link without a valid address (e.g. 169.254.x.x), grey = no link.
3. Choose Refresh to re-read the state.
4. Make sure you run the latest version (shown under the app name in the menu). Only the latest version receives fixes.
5. Use Diagnostics to copy the service's last decisions to the clipboard and paste them into the report.

2. Wi-Fi stays on although the cable is plugged in

• A cable counts as working only with link, a valid IPv4 or IPv6 address with a gateway and an answer from the wired network's DNS server over that adapter. Verifying cable in the menu means one of these is still missing – usually DHCP or DNS. If it stays that way the menu shows Cable without internet and Wi-Fi deliberately stays on so you are never left without a connection.
• The adapter's network service must exist under System Settings > Network. macOS sometimes creates the service for a new dock or adapter only after the first plug-in; unplug and plug again.
• If you turned Wi-Fi off and on yourself while the cable was in, that is respected until the cable situation changes (see section 4).
• The guard may be paused (pause symbol in the menu) or switched off in its configuration (crossed-out shield).
• Virtual adapters, VPN tunnels, Thunderbolt Bridge and Bluetooth PAN are deliberately not treated as cables.

3. Wi-Fi does not come back after unplugging

• Normally Wi-Fi is back within a second. Unplug and plug the cable again and choose Refresh.
• If it says "No connection" with an orange symbol, Wi-Fi is on but has no address yet – for instance because no known network is in range. That is an honest report, not a fault of the app: it deliberately does not claim "Wi-Fi active" in this case. Pick a network, or wait for the join to complete.
• If the footer says local (no daemon), the service is not running and cannot turn Wi-Fi on. Turn Wi-Fi on in Control Center or System Settings and report the case with the diagnostics.
• Quit in the menu only quits the menu-bar app; the background service and the guard keep running. The app returns at the next login or immediately from /Applications/MultihomingGuard.app.

4. I turned Wi-Fi off myself – why does it stay off?

By design: Wi-Fi you turned off yourself (Control Center, System Settings) is respected; the menu shows Wi-Fi turned off by you. The service turns it on again only when you do or when the cable situation changes (cable plugged in or removed).

5. Does the app ask for a password?

No. Installation happens as a package by double-click and asks for administrator rights once, like any installer package; in daily use nobody is asked for a password. Only the hidden admin area (hold ⌥ while opening the menu, then Open admin mode…) requires an administrator login through the macOS dialog to pause the guard. The app never sees the password.

6. Pause the guard temporarily

• Hold ⌥ while opening the menu and choose Open admin mode….
• Choose a duration and Pause as admin: macOS asks for an administrator's name and password. A standard user's own password is not enough.
• The pause ends automatically after the chosen duration (at most four hours) or via Resume. Every pause is recorded in the system log.

7. The Wi-Fi name is not shown

macOS discloses the network name only to apps with Location permission. macOS asks when the menu is first opened; alternatively choose Show network name… in the menu. If the permission was declined, use System Settings > Privacy & Security > Location Services > MultihomingGuard. Band and channel are shown without the permission; the guard itself does not depend on it.

7a. Apple Watch, AirDrop and Handoff on a cable

When the menu shows Cable active – Wi-Fi off, only the Wi-Fi connection is removed (the Wi-Fi service's IPv4 and IPv6 are set to "Off"). The Wi-Fi radio stays on, so unlocking and approving with Apple Watch, AirDrop, Handoff, Sidecar and Universal Control keep working as before.

In System Settings > Network, Wi-Fi then shows as not connected or without an IP address – that is intended. As soon as the cable is gone, the previous configuration is restored automatically.

8. iPhone over USB

• An iPhone connected over USB with Personal Hotspot enabled counts as a wired path: it is verified like a LAN, then the Wi-Fi connection is switched off.
• If a real LAN cable is connected as well, the iPhone service is parked (disabled in Network settings) so no mobile data is used. When the LAN goes away it is released automatically.
• To keep the iPhone active in parallel: ⚙ in the menu, Allow iPhone tethering while on LAN. If the switch is greyed out, the background service is not running.

8a. Updates

• When a new version exists, the menu shows "Version … available" with Install update…. One click downloads, verifies and installs the package without a password prompt; the app restarts afterwards and reports "Updated to …" once.
• Check manually: ⚙ → Check now. The check needs internet access.
• "Download blocked by …". Some corporate networks scan downloads and re-sign them with their own certificate. The message names who blocks – the name from that certificate, usually your organisation's proxy. The app then deliberately stops – not because the package is bad, but because it cannot tell who is intervening. The small update check itself often passes while the package does not, which is why an update is announced that cannot be loaded. Remedy: load it on another network (an iPhone hotspot, for instance), or download the package from the app page and install it by double-click. Authenticity does not rest on the transport: the package's checksum and signature are verified either way.
• "Package is not signed by FEICHTIQ": the package was altered in transit or does not come from the developer; the app deliberately refuses it. Try again or download from the app page.

9. Dock or USB adapter is not detected

• Check whether the adapter appears under System Settings > Network. If not, a vendor driver may be missing.
• Ethernet, USB Ethernet, Thunderbolt Ethernet, dock adapters and iPhone USB tethering are detected, several at once as well (e.g. at third-party docking stations). In a report, name vendor and model and the network service name.

10. Behaviour with VPN

VPN tunnels are not treated as cables and are not changed. When the service switches from Wi-Fi to cable, a VPN client usually has to reconnect; that is the VPN client's behaviour, not the app's.

• "VPN active" in the menu. While a tunnel is up, the menu shows "VPN active" with the tunnel device (e. g. utun12). This is recognised vendor-independently by a tunnel interface carrying a routable address – the empty tunnels macOS runs itself do not count.
• Internal addresses cannot be resolved. The cause is almost always a device on the cable – typically an iPhone – announcing its own name service. macOS puts it ahead of the company VPN's, and because it answers the internal zone with "does not exist", macOS stops asking the VPN's server at all.
• What the app does about it. With Protect company DNS while a VPN is active switched on (gear menu, on by default), it asks for the name over the suspect link and only steps in when the name really goes unanswered there. It then switches off IPv6 of that one connection; as soon as the VPN is disconnected, it comes back. The diagnostics record what was checked and what was changed.
• If it persists, switch the option off and report the case with the diagnostics – the app then stops intervening and resolution can be checked by hand.

11. The menu-bar app does not launch automatically

Launch at login is set up by the installer through /Library/LaunchAgents/com.feichtiq.multihomingguard.menu.plist and appears under System Settings > General > Login Items & Extensions as "MultihomingGuard". If it is off there, turn it on or start the app from /Applications. The guard itself runs independently of the app.

12. Uninstall completely

Removal in Terminal (administrator rights required):

sudo launchctl bootout system/com.feichtiq.multihomingguard.daemon
sudo launchctl bootout gui/$(id -u)/com.feichtiq.multihomingguard.menu
sudo rm -f /Library/LaunchDaemons/com.feichtiq.multihomingguard.daemon.plist /Library/LaunchAgents/com.feichtiq.multihomingguard.menu.plist
sudo rm -f /usr/local/libexec/MultihomingGuardDaemon /Library/Preferences/com.feichtiq.multihomingguard.plist
sudo rm -rf /Applications/MultihomingGuard.app "/Library/Application Support/MultihomingGuard"
sudo pkgutil --forget com.feichtiq.multihomingguard

Turn Wi-Fi back on in System Settings afterwards if needed. See also Privacy choices, section 5.