uhhiss/honeygrove

!https://raw.githubusercontent.com/wiki/UHH-ISS/honeygrove/img/honeygrove_logo.png

Honeygrove是基于Python的模块化蜜罐工具，构建于https://github.com/zeek/broker%E5%92%8CTwisted%E6%A1%86%E6%9E%B6%E4%B9%8B%E4%B8%8A%E3%80%82

系统要求

Honeygrove目前需要Python 3.5+，已在Ubuntu 16.4、Debian 9.1和ArchLinux上测试通过。它也可在提供兼容Python发行版的其他Linux发行版上运行。若Broker不可用，蜜罐本身仍可使用，但无法与管理控制台或监控堆栈通信。

快速开始指南

1. 克隆仓库或下载并解压
2. 可选：创建虚拟环境以隔离依赖

   shell
   $ python3 -m venv .venv
   $ source .venv/bin/activate
   

3. 安装Python依赖

   shell
   $ pip3 install --upgrade -r requirements.txt
   

4. 可选：安装https://github.com/zeek/broker%E5%8F%8APython%E7%BB%91%E5%AE%9A%EF%BC%8C%E4%BB%A5%E4%B8%8E%E7%BD%91%E7%BB%9C%E4%BA%8B%E4%BB%B6%E7%9B%91%E6%8E%A7%E5%99%A8%E9%80%9A%E4%BF%A1
5. 创建Honeygrove主目录及所需子目录

   shell
   $ mkdir -p /var/honeygrove/{logs,resources/{quarantine,honeytoken_files}}
   

6. 复制示例资源到主目录

   shell
   $ cp -a resources /var/honeygrove
   

7. 编辑配置文件以适配需求

   shell
   $ $EDITOR honeygrove/config.py
   

8. 启动Honeygrove并验证运行状态

   shell
   $ sudo python3 -m honeygrove
   

更多信息请参见https://github.com/UHH-ISS/honeygrove/wiki%EF%BC%88%E7%9B%AE%E5%89%8D%E4%BB%85%E8%8B%B1%E6%96%87%E7%94%A8%E6%88%B7%E6%8C%87%E5%8D%97%E5%8F%AF%E7%94%A8%EF%BC%89%E3%80%82

Docker部署示例

shell
# 拉取镜像
docker pull docker.xuanyuan.run/uhhiss/honeygrove
# 运行容器（挂载日志和配置目录，需提前创建）
docker run -d --name honeygrove \
  -v /var/honeygrove/logs:/app/logs \
  -v /var/honeygrove/config:/app/config \
  docker.xuanyuan.run/uhhiss/honeygrove

相关项目

Honeygrove旨在与网络事件监控器（CIM）(https://github.com/UHH-ISS/honeygrove-cim)%E9%85%8D%E5%90%88%E4%BD%BF%E7%94%A8%EF%BC%8C%E8%BF%98%E5%8F%AF%E9%80%9A%E8%BF%87%E7%AE%A1%E7%90%86%E6%8E%A7%E5%88%B6%E5%8F%B0(https://github.com/UHH-ISS/honeygrove-console)%E8%BF%9B%E8%A1%8C%E6%8E%A7%E5%88%B6%EF%BC%8C%E8%AF%A5%E6%8E%A7%E5%88%B6%E5%8F%B0%E9%80%9A%E8%BF%87Broker%E4%B8%8EHoneygrove%E9%80%9A%E4%BF%A1%E3%80%82

许可证

Honeygrove采用MIT许可证，详情请参见LICENSE文件。