Repository navigation
Releases
Releases · effront/OhmZ
v0.6.0 - Service Detection Major Upgrade
What's New
8 new protocol probes
- Memcached, MongoDB, MQTT, AMQP, RDP, SMB
- Elasticsearch and Docker API detection via HTTP body fingerprinting
Data-driven service signatures
- 35 signatures parsed at compile time via
@embedFile(zero runtime cost) - 5 banner signatures: POP3, IMAP, VNC, NATS, Rsync
- 30 HTTP signatures for common self-hosted apps: Grafana, GitLab, Jenkins, Portainer, Nextcloud, Keycloak, pgAdmin, MinIO, and more
- Easy to extend - just add a line to
src/data/service-probes
FastAPI auto-discovery
- Detects uvicorn + FastAPI via HTTP fingerprinting
- Automatically probes
/openapi.jsonto extract the real app title and version - Works with
-sV, no-sCneeded
TLS enhancements
- ALPN negotiation (h2, http/1.1)
- SAN (Subject Alternative Names) extraction from certificates
- TLS 1.3 cipher suites in ClientHello
Performance
- Probe reorder: NULL (1s) -> HTTP -> Redis/PostgreSQL - ~40% faster on HTTP-heavy targets
- Fixed false Redis detection on non-Redis ports (strict RESP validation)
Output fixes
- Extra field now shown in terminal output
- Fixed all output writers: XML (product/extrainfo/tunnel attributes), grepable (version slot), NDJSON (version/extra/tls/scripts)
Enhanced -sC scripts
scriptHttpOpenapi- detects OpenAPI specscriptHttpDocs- detects Swagger UI / ReDocscriptHttp404- fingerprints framework from error pages (Express, FastAPI, Spring Boot, Apache, nginx)scriptHttpProxy- detects reverse proxies (Traefik, HAProxy, Envoy, Caddy)
Testing
- 88 unit tests across banner, tls, output, ports, and sigs modules
v0.5.2 - Service Detection
What's New
Service detection improvements
- Fix case-sensitive HTTP header parsing (RFC violation) - lowercase
server: uvicornwas being missed - Add HTTP response fingerprinting:
- Go net/http (Traefik) via
X-Content-Type-Options: nosniff+ body pattern - FastAPI via uvicorn +
{"detail":...}response body - uWebSockets via custom header
- Node.js http via
Keep-Alive+Transfer-Encodingcombination
- Go net/http (Traefik) via
- Expand Redis port range to 6379-6399 (covers Docker remapped instances)
- Generic probe now falls back to Redis/PostgreSQL when HTTP detection fails
- Extract HTML
<title>as version info for unidentified HTTP services - Restrict header matching to line boundaries to prevent false positives
- Require specific Redis RESP prefixes (-ERR, -NOAUTH) instead of matching any
-response
Before/After (real scan)
| Port | Before | After |
|---|---|---|
| 6382 | unknown | Redis 7.4.8 |
| 8001 | HTTP | uvicorn |
| 8002 | HTTP | uvicorn |
| 6001 | HTTP | uWebSockets 20 |
| 80 | http | Go net/http |
v0.5.1 - ETA Fix
What's New
ETA display fix
- Remove the 99h59m59s cap on ETA display - now shows the real estimate
- Add days format when ETA exceeds 24h (e.g.
49d17h04minstead of capping at99h59m59s) - Same fix applied to elapsed duration display for consistency
README
- Change full port scan example from
/16(4.3 billion probes, ~50 days) to/24(16 million probes)
v0.5.0 - Performance & Detection
v0.5.0 - Performance & Detection
Performance
- ConnectEngine rewrite - Continuous socket pool (up to 4096 in-flight) with nanosecond token bucket rate control. Achieves ~996 pps vs ~243 pps previously on a 1000 pps target rate
- Probe loss fix - Retry on socket() failure instead of silently skipping targets. All 65535 probes now complete on a full port scan
- Dynamic poll timeout - Non-blocking poll when tokens are available, eliminating idle wait time
UI
- Adaptive progress bar - Queries terminal width via ioctl and adjusts bar width dynamically. No more line wrapping on narrow terminals
Service Detection
- SSH version - Full version string including distro info (e.g.
8.2p1 Ubuntu-4ubuntu0.13instead of8.2p1) - Generic probe HTTP fallback - Sends HTTP request when no passive banner is received, detecting web servers on non-standard ports
Fixes
- Consistent clock source (nanoTimestamp) for deadline assignment and checking
Full Changelog: v0.4.2...v0.5.0
What's Changed
- feat: ConnectEngine rewrite, adaptive UI, improved service detection by @Bulletdev in #4
Full Changelog: v0.4.2...v0.5.0
v0.4.2
v0.4.2 - Docker Fixes
Bug Fixes
- Docker build - Corrected Zig tarball URL segment order (
zig-<arch>-<os>instead ofzig-<os>-<arch>), which caused a 404 during image build - Docker build - Added Zig install directory to PATH; the tarball extracts the binary to
/usr/local/zig/, which wasn't in the default PATH
Full Changelog: v0.4.0...v0.4.2
v0.4.0
v0.4.0 - Detection & Fingerprinting
New Features
- OS Fingerprinting (
-O) - TCP SYN probe analyzing SYN-ACK (TTL, window size, TCP options) against a signature database covering Linux, Windows, macOS, FreeBSD, OpenBSD, Cisco IOS, and Solaris - Script Scanning (
-sC) - Port-based default scripts: http-title, http-robots, ssh-hostkey, smtp-commands, mysql-info - Traceroute (
--traceroute) - UDP probes with incrementing TTL and ICMP listener, with automatic stop after 5 consecutive timeouts - Aggressive Mode (
-A) - Combines OS detection + script scanning + traceroute in a single flag
Improvements
- ConnectEngine rewrite - Batch 512 concurrent non-blocking sockets with poll() loop and 3s deadline, fixing missed open ports through VPN connections
- JSON output escaping - Proper escaping of quotes, backslashes, and control characters in script output
- OS result lookup - Per-host IP matching instead of hardcoded index
- Output files - OS and traceroute results now included in -oN and -oX output formats
Security
- Pinned GitHub Actions (
mlugg/setup-zig) to SHA for supply chain safety - All Codacy and Semgrep findings resolved
Build
- x86_64 and aarch64 Linux binaries
- .deb packages for both architectures
- Docker image (multi-stage build)
Full Changelog: v0.3.0...v0.4.0
v0.3.0 - Service Detection & TLS Intelligence
What's New
Service Detection Engine (-sV)
- Protocol-specific probes for 8 services: HTTP, SSH, FTP, SMTP, MySQL, Redis, PostgreSQL, Generic
- Extracts service name, version, and extra info from banner responses
- Port-based protocol classification for targeted probing
TLS Certificate Extraction
- Raw TLS 1.2 ClientHello handshake - no OpenSSL dependency
- DER/ASN.1 X.509 parser extracts subject CN, issuer CN, expiry date
- Reports TLS version, cipher suite, and certificate validity
- Handles both TLS 1.2 and TLS 1.3 Certificate message formats
Concurrent Banner Grabbing
- Atomic work-stealing thread pool (up to 32 workers)
- Lock-free index distribution across worker threads
- Automatic worker count scaling based on open port count
Output Enhancements
- All 4 formats (JSON, XML, gnmap, nmap) now include service, version, extra, and TLS fields
- XML schema version bumped to 0.3.0
CI Fixes
- Fixed invalid GitHub Actions SHA pins across all workflows (CI, Docker, Release, Security)
Example
$ ohmz -sT -sV -p 443,6379,5432 target.com
PORT STATE SERVICE VERSION
443/tcp open example.com example.com (issuer: Let's Encrypt R3)
5432/tcp open PostgreSQL
6379/tcp open Redis 7.4.11
Full Changelog: v0.2.0...v0.3.0
What's Changed
- feat: v0.3.0 - Service detection engine with TLS cert extraction by @Bulletdev in #2
Full Changelog: v0.2.0...v0.3.0
v0.2.0
What's New
Scan Types
- TCP Connect (-sT) - full handshake via kernel
connect(), no root required - FIN (-sF) / XMAS (-sX) / NULL (-sN) - stealth scans that evade stateless firewalls
- ACK (-sA) / Window (-sW) - firewall rule mapping
Output Formats
- Normal (-oN) - human-readable nmap-style report
- XML (-oX) - nmap-compatible (Metasploit, OpenVAS, Nessus)
- Grepable (-oG) - one line per host, parseable with grep/awk
- All (-oA) - generates all formats with shared prefix
Port Selection
- Fast scan (-F) - top 100 ports
- Top ports (--top-ports N) - most common N ports (nmap frequency ranking)
Engine Improvements
- ConnectEngine - non-blocking connect + poll + getsockoptError for async TCP handshake
- Proportional drain time - adaptive post-TX wait based on scan size and rate, fixes missed open ports on high-latency targets
- Engine lifetime management with Zig optionals to prevent use-after-free
Other
- Full README with architecture diagrams, thread model, technology comparison
- CI pipeline with zig fmt checks
Assets
ohmz-linux-x86_64.tar.gz- Linux x86_64 static binaryohmz-linux-aarch64.tar.gz- Linux ARM64 static binaryohmz_0.2.0_amd64.deb- Debian/Ubuntu x86_64ohmz_0.2.0_arm64.deb- Debian/Ubuntu ARM64
Full Changelog: v0.1.0...v0.2.0
v0.1.0
Full Changelog: https://github.com/effront/OhmZ/commits/v0.1.0