Sign inSign up

chrno79/endlessh-webui

By chrno79

Updated 17 days ago

Tarpit, Endlessh

Image
Networking
Security
0

363

chrno79/endlessh-webui repository overview

endlessh-webui

A single, compact container instead of a stack made up of endlessh + prometheus + grafana.

Includes:

  • The original endlessh-SSH-Tarpit (built from source, no modifications)
  • A built-in WebUI with a live ticker showing total "sunk" time, active connections, and an event log
  • GeoIP country detection (fully offline, no external API calls) with a donut chart and ranking list
  • A time range filter: Today (live), Yesterday, Last 7 Days, Current Month, and a custom date range
  • SQLite persistence — no separate Prometheus/Grafana required
  • Multilanguage (DE/EN)

Quick Start

docker run -d \
  --name endlessh-webui \
  -p 2222:2222 \
  -p 8080:8080 \
  -v endlessh-data:/data \
  <image>

docker-compose.yml

services:
  endlessh-webui:
    image: chrno79/endlessh-webui:latest
    container_name: endlessh-webui
    restart: unless-stopped
    ports:
      # Tarpit Port. Bend to the real SSH port (22), e.g. B. per 
      # iptables port forwarding or by entering "22:2222" here 
      # (then your real sshd runs on a different port).
      - "2222:2222"
      # WebUI. If necessary, put behind a reverse proxy with Auth,
      # as there is no login provided by default.
      - "8080:8080"
    environment:
      ENDLESSH_PORT: "2222"
      ENDLESSH_DELAY_MS: "10000"
      ENDLESSH_MAX_LINE_LENGTH: "32"
      ENDLESSH_MAX_CLIENTS: "4096"
      WEBUI_PORT: "8080"
      DB_PATH: "/data/endlessh.db"
    volumes:
      - endlessh-data:/data

volumes:
  endlessh-data:

The tarpit listens on port 2222, and the WebUI is available at http://<host>:8080/.


Configuration (Environment Variables)

VariableDefaultDescription
ENDLESSH_PORT2222Port the tarpit listens on
ENDLESSH_DELAY_MS10000Delay between banner bytes (in milliseconds)
ENDLESSH_MAX_CLIENTS4096Maximum concurrent connections
WEBUI_PORT8080Port for the WebUI
DB_PATH/data/endlessh.dbPath to the SQLite database file

Note

The WebUI currently does not have built-in authentication. For public internet use, place a reverse proxy with authentication in front of it.

Tag summary

Content type

Image

Digest

sha256:83ed76c71

Size

46.4 MB

Last updated

17 days ago

docker pull chrno79/endlessh-webui