wildwildangel/ssh-honeypotd

ssh-honeypotd

用C语言编写的低交互SSH蜜罐。

命令行选项

用法：ssh-honeypotd [选项]...

长选项的必填参数对于短选项也是必填的。

• -k, --host-key FILE：包含私有主机密钥的文件（RSA、DSA、ECDSA、ED25519）
• -b, --address ADDRESS：要绑定的IP地址（默认：0.0.0.0）
• -p, --port PORT：要绑定的端口（默认：22）
• -P, --pid FILE：PID文件（如果未指定，守护进程将在前台运行）
• -n, --name NAME：用于syslog的守护进程名称（默认：ssh-honeypotd）
• -u, --user USER：放弃权限并切换到该用户（默认：daemon或nobody）
• -g, --group GROUP：放弃权限并切换到该组（默认：daemon或nogroup）
• -x, --no-syslog：仅将消息记录到stderr（仅与--foreground一起使用）
• -f, --foreground：不后台运行
• -h, --help：显示帮助信息并退出
• -v, --version：输出版本信息并退出

如果ssh-honeypotd是针对0.8.0之前的libssh版本编译的（注意在Ubuntu（可能还有Debian）中，由于libssh.h中的bug，libssh 0.8.0会被检测为0.7.0），则必须至少指定一次-k选项。对于较新的libssh版本，会自动生成主机密钥（RSA 2048位）。

支持的最低libssh版本为0.7.0。

Docker使用方法

bash
docker run -d \
    --network=host \
    --cap-add=NET_BIND_SERVICE \
    --restart=always \
    --read-only \
    --name=ssh-honeypotd \
    -e ADDRESS=0.0.0.0 \
    -e PORT=22 \
    wildwildangel/ssh-honeypotd:latest

bash
docker run -d \
    --network=host \
    --cap-add=NET_BIND_SERVICE \
    --restart=always \
    --read-only \
    wildwildangel/ssh-honeypotd-min:latest

Kubernetes使用方法

ssh-honeypotd.yaml：

yaml
---
apiVersion: v1
kind: Namespace
metadata:
  name: honeypots
---
apiVersion: apps/v1
kind: DaemonSet
metadata:
  name: ssh-honeypotd
  namespace: honeypots
spec:
  selector:
    matchLabels:
      name: ssh-honeypotd
  template:
    metadata:
      labels:
        name: ssh-honeypotd
    spec:
      hostNetwork: true
      containers:
        - name: ssh-honeypotd
          image: wildwildangel/ssh-honeypotd-min # 或 wildwildangel/ssh-honeypotd
          resources:
            limits:
              cpu: 100m
              memory: 12Mi
            requests:
              cpu: 100m
              memory: 12Mi
          securityContext:
            capabilities:
              drop:
                - all
              add:
                - NET_BIND_SERVICE
            readOnlyRootFilesystem: true
            allowPrivilegeEscalation: false
            seccompProfile:
              type: RuntimeDefault
          ports:
            - containerPort: 22
              hostPort: 22
              protocol: TCP

bash
kubectl apply -f ssh-honeypotd.yaml

在容器（wildwildangel/ssh-honeypotd镜像）中，可以通过以下环境变量控制ssh-honeypotd的行为：

• ADDRESS（默认：0.0.0.0）：要绑定的IP地址；
• PORT（默认：22）：要绑定的端口。

这些变量便于在同一台机器上运行多个ssh-honeypotd实例（如果需要）。

Docker镜像变体

ssh-honeypotd的Docker镜像有两种类型：

1. 基于最新稳定Alpine的标准镜像：https://hub.docker.com/repository/docker/wildwildangel/ssh-honeypotd
2. 基于scratch Docker镜像的最小化镜像：https://hub.docker.com/repository/docker/wildwildangel/ssh-honeypotd-min

ssh-honeypotd-min镜像仅包含静态链接的ssh-honeypotd二进制文件和一组预生成的SSH密钥。该镜像比ssh-honeypotd略小，但目前处于实验阶段。ssh-honeypotd-min镜像中的ssh-honeypotd二进制文件不支持以下命令行选项：--pid、--name、--user、--group、--no-syslog、--foreground。