diff --git a/.gitignore b/.gitignore index f8f235b..f74a5e7 100644 --- a/.gitignore +++ b/.gitignore @@ -16,4 +16,6 @@ vendor .DS_Store */.DS_Store */.idea/% -*/vendor/% \ No newline at end of file +*/vendor/% +db/*.db +logs/*.log \ No newline at end of file diff --git a/README.md b/README.md index a1cf36e..0159863 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ - + # 介绍 @@ -6,48 +6,90 @@ **HFish** 是一款基于 Golang 开发的跨平台多功能主动诱导型蜜罐框架系统,为了企业安全防护测试做出了精心的打造 -- 多功能 不仅仅支持 HTTP(S) 蜜罐,还支持 SSH、SFTP、Redis、Mysql 等 + +- 多功能 不仅仅支持 HTTP(S) 蜜罐,还支持 SSH、SFTP、Redis、Mysql、FTP、Telnet、暗网 等 - 扩展性 提供 API 接口,使用者可以随意扩展蜜罐模块 ( WEB、PC、APP ) - 便捷性 使用 Golang 开发,使用者可以在 Win + Mac + Linux 上快速部署一套蜜罐平台 # 地址 -- Github: https://github.com/hacklcx/HFish +## Github + +- Git: https://github.com/hacklcx/HFish - Download: https://github.com/hacklcx/HFish/releases +## 码云(Gitee) + +- Git: https://gitee.com/lauix/HFish +- Download: https://gitee.com/lauix/HFish/releases + # 快速部署 -### 部署说明 +## 部署说明 - 下载当前系统二进制包 - cd 到程序根目录,修改 config.ini 配置文件 - 执行 ./HFish run 启动服务 - 浏览器输入 http://localhost:9001 打开 -### 帮助页面 +## 集群部署 + +- 复制 HFish、config.ini、web(不启动WEB蜜罐可以不复制) 目录文件到服务器上 +- 修改 config.ini -> rpc -> status 为 2 +- 修改 config.ini -> rpc -> addr 地址为 HFish 服务端地址 + +## 命令行帮助  -### 启动服务 +## 启动服务  # 部分界面展示 - +## 登录页 - + + +## 上钩页 + + + +## 分布式集群 + + + +## 邮件群发 + + # 部分功能使用演示 -### Redis 蜜罐 +## WEB 蜜罐 + + + +## SSH 蜜罐 + + + +## Redis 蜜罐  -### Mysql 蜜罐 +## Mysql 蜜罐  +## FTP 蜜罐 + + + +## Telnet 蜜罐 + + + # 注意事项 - 邮箱 SMTP 配置后需要开启方可使用 @@ -55,9 +97,13 @@ - 启动 WEB 蜜罐,请先启动 API 模块 - WEB 插件 需在 WEB 目录下 编写 - WEB 插件 下面必须存在两个目录 +- 集群 心跳为60秒,断开显示会延迟60秒 +- 暗网蜜罐是支持的,但是目前Tor服务网上找不到,无法提供演示 # API 接口 +## WEB 蜜罐 + ``` URL: http://localhost:9001/api/v1/post/report @@ -73,6 +119,33 @@ POST: sec_key 可在 config.ini 配置里修改,修改后 WEB 模板也需要同时修改 ``` +## 暗网 蜜罐 + +``` +URL: http://localhost:9001/api/v1/post/deep_report + +POST: + + name : 暗网后台蜜罐 # 项目名 + info : admin&&12345 # 上报信息,&& 为换行符号 + sec_key : 9cbf8a4dcb8e30682b927f352d6559a0 # API 安全密钥 + +特殊说明: + + URL api/v1/post/deep_report 可在 config.ini 配置里修改 + sec_key 可在 config.ini 配置里修改,修改后 暗网 模板也需要同时修改 +``` + +## 黑名单IP + +``` +URL(Get): http://localhost:9001/api/v1/get/ip + +特殊说明: + + 提供此接口为了配合防火墙使用,具体方案欢迎来讨论! +``` + # TODO - [x] 登录模块 @@ -82,21 +155,20 @@ POST: - [x] 命令行优化 - [x] 支持自定义 WEB 模板 - [x] 支持 Mysql 服务端获取连接客户端电脑任意文件 -- [x] 支持 HTTP(S)、SSH、SFTP、Redis、Mysql 协议 -- [ ] 支持 FTP、Telnet、SMTP、POP3、TFTP、Oracle、VPN 等 -- [ ] 暗网蜜罐支持 +- [x] 支持 HTTP(S)、SSH、SFTP、Redis、Mysql、FTP、Telnet、暗网 蜜罐 +- [x] 日记完善优化 +- [x] 支持分布式架构 +- [x] 支持分页 +- [x] 支持 ip 地理信息 +- [x] 提供黑名单IP接口 +- [ ] 支持 SMTP、POP3、TFTP、Oracle、VPN 等 - [ ] WIFI 蜜罐支持 - [ ] 自动化蜜罐支持 - [ ] 蜜罐报告生成 -- [ ] 支持更多的 WEB 模块 -- [ ] 日记完善优化 - [ ] 邮件发送支持编辑器 - [ ] 支持邮件模板选择 - [ ] 蜜罐高交互完善 - [ ] 支持 Ngrok 一键映射 -- [ ] 支持分布式架构 -- [ ] 支持分页 -- [ ] 支持 ip 地理信息 和 地图数据展示 - [ ] 支持更多的图表统计 - [ ] Mysql 支持 - [ ] 规划更多的功能... diff --git a/admin/colony.html b/admin/colony.html new file mode 100644 index 0000000..8c3ae76 --- /dev/null +++ b/admin/colony.html @@ -0,0 +1,177 @@ +{{template "header"}} + +
集群名称 | +集群 IP | +WEB | +暗网 | +SSH | +Redis | +Mysql | +Telnet | +FTP | + {{/*Http代理 | */}} +
---|---|---|---|---|---|---|---|---|---|
暂无数据 | +
服务状态
ADMIN
@@ -82,6 +137,12 @@WEB
{{end}} + {{if eq .deepStatus "1"}} +DEEP
+ {{else}} +DEEP
+ {{end}} + {{if eq .sshStatus "1"}}SSH
{{else}} @@ -99,18 +160,46 @@ {{else}}MYSQL
{{end}} + + {{if eq .telnetStatus "1"}} +TELNET
+ {{else}} +TELNET
+ {{end}} + + {{if eq .ftpStatus "1"}} +FTP
+ {{else}} +FTP
+ {{end}} +发布 v0.2 版本
+发布第一版
+发布 v0.1 版本