lenny-ts/caddy-analyzer
Zero-dependency analyzer for Caddy v2 access logs with threat inspection and TUI dashboard
Tested on Linux
Use it
Linux x86_64
Download install script for reading
curl -sSfL https://raw.githubusercontent.com/lenny-ts/caddy-analyzer/main/install.sh -o /tmp/caddy-install.shDownload release tarball pinned version
curl -sSfL https://github.com/lenny-ts/caddy-analyzer/releases/download/v0.8.1/caddy-analyzer_0.8.1_linux_amd64.tar.gz -o /tmp/ca.tgzDownload checksums for verification
curl -sSfL https://github.com/lenny-ts/caddy-analyzer/releases/download/v0.8.1/checksums.txt -o /tmp/ca-checksums.txtVerify checksum with correct filename
cp /tmp/ca.tgz /tmp/caddy-analyzer_0.8.1_linux_amd64.tar.gz && grep caddy-analyzer_0.8.1_linux_amd64.tar.gz$ /tmp/ca-checksums.txt | (cd /tmp && sha256sum -c)Extract and install binary to local bin
tar -xzf /tmp/caddy-analyzer_0.8.1_linux_amd64.tar.gz -C /tmp && install -m 0755 /tmp/caddy-analyze ~/.local/bin/caddy-analyze
Check that it works
caddy-analyze --versionThe output should contain “caddy-analyze version 0.8.1”.
First thing to try
curl -sSfL https://raw.githubusercontent.com/lenny-ts/caddy-analyzer/main/testdata/sample.log -o sample.log && wc -l sample.log && head -c 2000 sample.logcaddy-analyze --detect sample.logRun caddy-analyze --detect <logfile> on a Caddy v2 access log to get a security report.
What it does
- Detect 26 kinds of attacks in requestsTested
How to use it
- Run
caddy-analyze --detect <logfile>on your Caddy access log. - Read the SECURITY THREAT INSPECTION REPORT it prints.
- Run
- Analyze Caddy v2 access logsTested
How to use it
- Run
caddy-analyze --detect <logfile>for a security report. - Run
caddy-analyze top ip <logfile>to list the top remote IPs. - Run
caddy-analyze top country <logfile>to list the top countries.
- Run
- Block malicious IPs automatically with the firewallNot tested
- Open an interactive terminal dashboardNot tested
How far pickfit got
Linux x86_64
- Installs
- Starts
- 2 of 4 features work
- Works offline
macOS: the project says it runs there; pickfit hasn’t tried it.
Good for
- analyze Caddy logs with security detection
- generate standalone HTML report
- compare two log files for regressions
An alternative to goaccess, lnav and grep/awk.
How pickfit tested it
Each run starts from a clean machine and follows the steps above. How pickfit verifies
Linux x86_64
Its main function works
- Replayed from scratch
- Works offline
- Checked on 30 Oct 2026
- Version 0.8.1
Differences the test machine hit
- README: curl -sSfL .../install.sh | bash installs to /usr/local/bin (uses sudo when not writable)
In the test: manually replicate script steps: download tarball + checksums, verify sha256, extract caddy-analyze to ~/.local/bin