github 291-Group/LAN-Sheriff v1.0.3

one hour ago

What changed in 1.0.3

Slow storage no longer loses observations. On an SD card or other slow storage, writes could stall for seconds at a time, and whatever was being written was dropped. Now a write that hits a busy database is retried, and the capture pipeline holds a failed batch in memory and tries again, backing off to every 30 seconds while the storage is slow. The write-ahead log is folded back into the database on a timer instead of in the middle of a write, and the Docker health check no longer opens the database at all. Thanks to @tian-sigons for the report in #9.

A damaged database is now reported. If the database file is damaged, usually by failing storage, LAN Sheriff now says so: in a banner on the dashboard, in /api/health, and through lan-sheriff health, which exits 1. All three say how to fix it. A full check of the database runs a minute after start and every six hours after that. Before, the damage only showed up as warnings in the log while the Wanted List quietly stopped growing.

A new malware list. URLhaus retired its free downloads, so new installs, including fresh Docker containers, were starting with no malware list at all, and the threat list rule could never fire. It is replaced with the HaGeZi Threat Intelligence Feed (the mini edition, about 200,000 domains, refreshed by HaGeZi every few hours). A domain on both the malware list and the ad list is now labelled malware; before, the ad list won. Expect about 15 MB more memory.

One rare-destination finding per device. A device that reaches unusual countries now raises a single finding that lists them, instead of one per country. Findings from earlier versions are merged on upgrade without notifying you again.

Four new languages. Italian, Korean, Polish and Ukrainian, for sixteen in all. They have not yet been reviewed by native speakers; corrections are welcome.

Smaller fixes.

  • The Settings dialog no longer disappears behind ad blockers that hide anything named like a pop-up.
  • Radio Chatter hides reverse lookups (.arpa) by default. Tick "Show reverse lookups" to see them. Search and export are not filtered.
  • The Start here section of Help now separates what is working from what is not available, then says how to see more.
  • The dashboard footer and the Docker image show the real build number.

Security

  • Built with Go 1.27.4, which fixes GO-2026-6859, a crash in Go's HTTP/1 server that was reachable through the dashboard's own server. The build also picks up the Go 1.27.3 certificate change, which rejects certificate chains through eight compromised intermediate CA keys. That check is compiled in, so it only reaches you through a new build.
  • golang.org/x/net 0.62.0, golang.org/x/crypto 0.58.0 and gopacket 1.7.2.
  • libpcap 1.10.7 in the capture builds, and the release build now verifies the checksums of the libpcap and Npcap SDK downloads before using them.
  • The Docker image moves to Debian 13, and its base images are pulled fresh on every build.
  • Release builds run on a fixed Ubuntu 24.04 runner instead of whatever "latest" happens to be.

Changes to know about

  • New command: lan-sheriff health. It asks a running instance whether it is alive and exits 0 if so. The Docker health check now uses it. Write stalls are reported but do not fail it; a damaged database does. It asks 127.0.0.1:2911 unless you pass --url.
  • /api/health answers without a password. It reports whether the server is up, whether writes are landing and whether the database is damaged. It contains nothing that was observed, and it does not reveal where your data is stored.
  • lan-sheriff status no longer writes. It now opens the database read-only, so it never creates or migrates one. It exits 1 if there is no database. On a database from before 1.0.3, run lan-sheriff serve once first.
  • Rare-destination scores can rise. A device that reaches several unusual countries scores up to 0.2 higher than before, which can carry it over a --notify-min-score threshold.

Don't miss a new LAN-Sheriff release

NewReleases is sending notifications on new releases.