scrlk/endlessh

Endlessh：SSH陷阱工具

镜像概述

Endlessh是一个SSH tarpit工具，通过极慢地发送无限随机的SSH banner，将SSH客户端长时间困住（数小时甚至数天）。其目的是将真实SSH服务器移至非默认端口，让脚本 kiddies陷入此陷阱，而非干扰真实服务器。该工具无需加密库，是单线程独立C程序，使用poll()处理多个客户端。

核心功能

• 极慢发送随机SSH banner，有效困住***客户端
• 无加密库依赖，轻量独立运行
• 支持多客户端同时处理
• 可配置延迟、最大行长度、最大客户端数等参数
• 支持日志输出到标准输出或syslog

使用场景

• 保护真实SSH服务器：将真实服务器端口改为非默认值（如2222），用Endlessh监听22端口拦截***扫描
• 减少服务器负载：阻止脚本 kiddies的无效连接尝试，降低系统资源消耗

配置说明

命令行参数

执行-h查看帮助：

Usage: endlessh [-vhs] [-d MS] [-f CONFIG] [-l LEN] [-m LIMIT] [-p PORT]
  -4        仅绑定IPv4
  -6        仅绑定IPv6
  -d INT    消息毫秒延迟 [10000]
  -f        加载配置文件 [/etc/endlessh/config]
  -h        打印帮助并退出
  -l INT    最大banner行长度（3-255）[32]
  -m INT    最大客户端数 [4096]
  -p INT    监听端口 [2222]
  -s        日志输出到syslog
  -v        打印诊断信息（可重复）

配置文件示例

语法类似OpenSSH：

# 监听端口
Port 2222
# 每行发送延迟（毫秒）
Delay 10000
# 最大行长度
MaxLineLength 32
# 最大同时连接数
MaxClients 4096
# 日志级别：0=安静，1=标准，2=调试
LogLevel 0
# 绑定地址族：0=双栈，4=仅IPv4，6=仅IPv6
BindFamily 0

Docker部署示例

基本运行

监听主机22端口并输出日志：

bash
docker run -d --name endlessh -p 22:2222 scrlk/endlessh -v

自定义配置

挂载本地配置文件：

bash
docker run -d --name endlessh -p 22:2222 -v /your/local/config:/etc/endlessh/config scrlk/endlessh -f /etc/endlessh/config -v