v0.4.24: ZimaOS support — writable path probing + Docker bridge IP fix

Author: DAB-LABS

CHANGELOG.md

@@ -2,6 +2,15 @@
 
 All notable changes to SMART Sniffer are documented here.
 
+## v0.4.24 — 2026-03-20
+
+### Fixed
+- Zeroconf discovery now correctly selects real LAN IPs (10.x, 192.168.x) over Docker bridge IPs (172.17.x) on container-based systems like ZimaOS/CasaOS
+
+### Added
+- Installer now probes for writable paths on immutable-rootfs platforms (ZimaOS, CasaOS); falls back to `/DATA/smartha-agent/` or `/opt/smartha-agent/`
+- New doc: `docs/platform-install-paths.md` — explains platform-specific install locations and how to add new ones
+
 ## v0.4.23 — 2026-03-19
 
 ### Fixed

custom_components/smart_sniffer/config_flow.py

@@ -90,9 +90,13 @@ async def async_step_user(
     def _pick_best_ip(discovery_info: ZeroconfServiceInfo) -> str:
         """Choose the best IP from discovery info.
 
-        Prefers RFC 1918 private addresses (192.168.x, 10.x, 172.16-31.x)
-        over VPN/tunnel IPs (Tailscale 100.x, WireGuard, etc.).  Falls back
-        to whatever is available.
+        Prioritizes real LAN addresses over virtual/tunnel IPs:
+          1. 192.168.x.x, 10.x.x.x  (almost always physical LAN)
+          2. 172.16-31.x.x           (RFC 1918, but often Docker/container bridges)
+          3. 100.64-127.x.x          (CGNAT — Tailscale, WireGuard, etc.)
+          4. Anything else
+
+        Falls back to whatever is available.
         """
         # discovery_info may expose ip_address (single) and ip_addresses (list).
         candidates: list[str] = []
@@ -104,16 +108,26 @@ def _pick_best_ip(discovery_info: ZeroconfServiceInfo) -> str:
         if not candidates:
             return str(discovery_info.ip_address)
 
-        # Prefer private (RFC 1918) addresses over anything else.
-        for ip_str in candidates:
+        def _score(ip_str: str) -> int:
+            """Lower score = more preferred."""
             try:
                 addr = ipaddress.ip_address(ip_str)
-                if addr.is_private and not ip_str.startswith("100."):
-                    return ip_str
             except ValueError:
-                continue
-
-        # No private IP found — return the first candidate.
+                return 99
+            if not addr.is_private:
+                return 90
+            # 192.168.x.x and 10.x.x.x — almost always a real LAN interface.
+            if ip_str.startswith("192.168.") or ip_str.startswith("10."):
+                return 10
+            # 172.16-31.x.x — RFC 1918 but frequently Docker/container bridges.
+            if ip_str.startswith("172."):
+                return 50
+            # 100.64-127.x.x — CGNAT range (Tailscale, WireGuard, etc.)
+            if ip_str.startswith("100."):
+                return 70
+            return 80
+
+        candidates.sort(key=_score)
         return candidates[0]
 
     async def async_step_zeroconf(

custom_components/smart_sniffer/manifest.json

@@ -9,6 +9,6 @@
   "iot_class": "local_polling",
   "issue_tracker": "https://github.com/DAB-LABS/smart-sniffer/issues",
   "requirements": [],
-  "version": "0.4.23",
+  "version": "0.4.24",
   "zeroconf": [{"type": "_smartha._tcp.local."}]
 }