Skip to content

v3.80.0: optional Ookla Speedtest engine (agent 1.8.2) - #17

Merged
agit8or1 merged 1 commit into
mainfrom
feature/ookla-speedtest
Nov 7, 2026
Merged

agit8or1 merged 1 commit into
mainfrom
feature/ookla-speedtest

Conversation

@agit8or1

@agit8or1 agit8or1 commented Nov 7, 2026

Copy link
Copy Markdown
Owner

Summary

Adds Ookla's official Speedtest CLI as an optional second engine for bandwidth tests. iperf3 stays the default.

  • Opt-in: the engine is off by default and is enabled per firewall under Edit Firewall → Bandwidth test.
  • Licence gate: before any firewall can use it, an administrator must record acceptance of Ookla's EULA, Terms and Privacy Policy. Ookla licenses the CLI for personal, non-commercial use. Acceptance is audited and can be withdrawn, which stops Ookla tests.
  • Binary handling: Ookla's package is not in OPNsense's repository, so agent 1.8.2 fetches Ookla's own FreeBSD package on first use, and only on enabled firewalls. It verifies pinned SHA-256 checksums of both the package and the binary inside it, then unpacks only the binary to /usr/local/opnmgr/bin. pkg is never used, and the binary needs only FreeBSD base libraries.
  • Version gating: older agents, and firewalls not enabled for Ookla, keep using iperf3.
  • Results: Ookla tests also record the Ookla server, jitter, packet loss and the speedtest.net result link. Only speedtest.net result URLs are stored.

Tests

  • tests/speedtest_test.php: 53 checks. They run the agent's real shell functions with a stub binary and a synthetic package, and cover the checksum refusals, terms and version gating, and ingest.
  • Ookla's real package was checked to extract to the pinned binary hash with both GNU tar and libarchive bsdtar.
  • Full suite: 72 files, 2,994 checks, 0 failures.

Not verified

The Ookla engine has not yet run on a live firewall.

🤖 Generated with Claude Code

Optional Ookla Speedtest CLI engine for bandwidth tests (agent 1.8.2), off by
default, enabled per firewall, and only after an administrator records
acceptance of Ookla's EULA/Terms/Privacy Policy (personal, non-commercial
licence; audited, withdrawable). The agent fetches Ookla's own FreeBSD
package only on enabled firewalls, verifies pinned SHA-256 of package and
binary, and unpacks the binary to /usr/local/opnmgr/bin without pkg. Results
store server, jitter, packet loss and the speedtest.net result link. iperf3
remains the default.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@agit8or1
agit8or1 merged commit 3e2ea8e into main Nov 7, 2026
10 checks passed
@agit8or1
agit8or1 deleted the feature/ookla-speedtest branch November 7, 2026 00:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants