HFish 跨平台蜜罐系统

README

<p align="center">
  <a href="https://hfish.io/" target="_blank">
    <img width="200" src="https://web-code-img.oss-cn-shanghai.aliyuncs.com/readme/1e850955281f4ac08ae6764b.png">
  </a>
</p>


<h1 align="center">HFish </h1>
<p align="center">HFish是一款安全、简单可信赖的跨平台蜜罐软件，允许商业和个人用户免费使用。</p>

<p  align="center">
<a href="https://hfish.io/" target="_bank">官网</a>
<span>|</span>
<a href="https://hfish.io/#/?id=hfish%e8%ae%be%e8%ae%a1%e7%90%86%e5%bf%b5" target="_bank">使用手册</a>
<span>|</span>
<a href="https://github.com/hacklcx/HFish" target="_bank">Github</a>
<span>|</span>
<a href="https://gitee.com/lauix/HFish" target="_bank">Gitee</a>
<span>|</span>
<a href="https://hfish.io/docs/#/download" target="_bank">下载部署</a>
</p>

## 二维码

## 特点

+ 安全可靠：主打低中交互蜜罐，简单有效；

+ 功能丰富：支持基本网络 服务、OA系统、CRM系统、NAS存储系统、Web服务器、运维平台、无线AP、交换机/路由器、邮件系统、IoT设备等40多种蜜罐服务，支持用户制作自定义Web蜜罐，支持用户进行流量牵引到云蜜网、可开关的扫描感知能力、支持可自定义的蜜饵配置；

+ 开放透明：支持对接微步在线X社区API、五路syslog输出、支持邮件、钉钉、企业威胁、飞书、自定义WebHook告警输出；
+ 快捷管理：支持单个安装包批量部署，支持批量修改端口和服务；

+ 跨平台：支持Linux x32/x64/ARM、Windows x32/x64平台、国产操作系统、龙芯、海光、飞腾、鲲鹏、腾云、兆芯硬件；



## 快速开始

[官方网站](https://hfish.io/)：更多使用蜜罐、使用场景和玩法详见官网

[详细文档](https://hfish.io/docs/#/)：更详细的功能说明、故障排错指南



## 架构

HFish由管理端和节点端组成，管理端用来生成和管理节点端，并接收、分析和展示节点端回传的数据，节点端接受管理端的控制并负责构建蜜罐服务。

> 蜜罐工作原理

![image-20210611130621311](https://web-code-img.oss-cn-shanghai.aliyuncs.com/readme/f00ee3a63962a995238005ab.png)





> 融合在企业网络中

![image-20210611130733084](https://web-code-img.oss-cn-shanghai.aliyuncs.com/readme/4e020be932f63f514ff6151e.png)

## 注意

+ Linux 安装无需root权限，但是会导致无法监听低于TCP/1024以下端口

+ 管理端使用 TCP/4433 和 TCP/4434 端口，节点端监听端口根据模拟的服务不同而不同

+ 节点端需要可访问管理端的 TCP/4434 端口，管理端不会主动访问节点端

+ 管理端默认用户名/密码：**`admin / HFish2021`**



## 部署管理端

先部署管理端，再通过管理端的Web页面配置节点端，安装包仅包含管理端和节点端，蜜罐服务包需要部署管理端后从 **`服务管理`** 页面联网下载或离线上传



可联网环境：如果用户的环境允许联网，建议使用以下快速部署步骤：

+ Linux 环境：
  + 在shell中运行命令：**`sh | curl https://hfish.io/install.sh`**

+ Windows x64 环境：
  + 下载管理端安装包：请访问下载页面下载相应版本 https://hfish.io/#/download
  + 解压缩后双击 **`server.exe`**

离线部署：如果用户为隔离网络环境，请使用以下部署方式

+ Linux x64 环境：
  + 下载管理端安装包：请访问下载页面下载相应版本 https://hfish.io/#/download
  + 解压缩安装包：**`tar zxvf ./hfish-*-linux-*.tar.gz`**
  + 进入安装目录：**`cd hfish`**
  + 启动管理端：**`nohup ./server &`**



## 配置管理端

新部署的管理端，没有自带任何蜜罐服务，必须新增服务和节点端。管理端和节点端可以部署在同一台机器上。



+ 新增服务
  + 浏览器中输入 **`https://server_ip:4433/web/`**，登录管理端
  + 进入 **`服务管理`** 页面
  + 如果当前管理端可联网，点击服务表格右侧的下载按钮，并等待服务下载完成
  + 如果当前管理端不可联网，点击右上角 **`新增服务`** 按钮，上传服务包，服务包下载地址： **`/images/services/services-2.4.0.tar.gz`**



+ 新增节点
  + 浏览器中输入 **`https://server_ip:4433/web/`**，登录管理端
  + 进入 **`节点管理`** 页面，点击右上角新增节点按钮，根据节点操作系统和CPU架构动态创建安装包
  + Linux可以选择命令安装或下载节点程序运行，Windows只能选择下载节点程序运行



## 效果图

+ 攻击详情：记录所有对蜜罐的访问请求，包括正常请求、攻击行为、暴力破解

![image2021-6-7_13-57-19](https://web-code-img.oss-cn-shanghai.aliyuncs.com/readme/42f5df0cdb7519cf6eb22dc2.png)



+ 扫描详情：记录对所有节点主机的UDP和SYN扫描

![image2021-6-7_17-18-11](https://web-code-img.oss-cn-shanghai.aliyuncs.com/readme/16a66e5a6d90730df96bb153.png)

+ 蜜饵管理

![image2021-6-7_19-6-21](https://web-code-img.oss-cn-shanghai.aliyuncs.com/readme/21b512351761c204dd1807cd.png)

+ 节点信息

![image2021-6-7_18-0-36](https://web-code-img.oss-cn-shanghai.aliyuncs.com/readme/eb58f4d21cf847ad0724cac7.png)

+ 模板管理

![image2021-6-7_18-56-55](https://web-code-img.oss-cn-shanghai.aliyuncs.com/readme/2c8c3e736a7d61969615dee5.png)



+ 威胁情报对接

![image2021-6-7_19-0-11](https://web-code-img.oss-cn-shanghai.aliyuncs.com/readme/28c2e095b95532c0b6761eb5.png)

+ 告警配置

![image2021-6-7_19-4-10](https://web-code-img.oss-cn-shanghai.aliyuncs.com/readme/ff56e96992056f5fb960feff.png)

## 致谢

## wx群

如何大家有更多的建议希望能够更便捷的交流，可以添加我们的wx群。



![HFish官方群的qr](https://web-code-img.oss-cn-shanghai.aliyuncs.com/readme/f816bb6789ada860c2854c2b.png)