0x01 工具介绍

Hephaestus 是配套桌面渗透客户端，内置本地服务与 SQLite，单机开箱即用，无需额外部署数据库。支持网站、端口、子域名、目录、JS/API 组合扫描，集成资产测绘、漏洞管理、Nuclei 模板调试、HTTP 请求测试、JWT 编解码等能力。搭载 AI 渗透对话工作台，可记录测试流程与证据，也能对接远程 Agent、PostgreSQL 实现分布式任务协同。自带本地工具启动器、小程序反编译入口，兼容 FOFA、Hunter、Quake 资产查询，支持报告导出合并，适合个人授权安全测试与红队本地工作台使用。

0x02 功能介绍

核心特点

  • 组合扫描

    将网站、端口、目录、子域名及 JS/API 扫描按需组合，在同一任务中查看执行进度与结果。

  • AI 渗透对话

    围绕授权目标调用工具开展测试，支持记录发现、复现步骤与证据，方便后续复核。

  • 分布式执行

    选择本机或远程 Agent 执行任务，通过平台统一管理节点、任务与扫描结果。

主要功能模块

模块

功能

攻击面评估

网站指纹与漏洞、端口与服务、弱口令、目录、子域名及 JS/API 扫描

任务管理

并发控制、暂停与恢复、取消、扫描历史、计划任务、参数模板与结果检索

AI 工作台

项目与会话、工具调用、图片输入、测试过程记录与证据查看

AI 批量任务

批量任务创建、队列管理与执行状态查看

漏洞管理

汇总扫描与 AI 发现，查看复现步骤和证据，跟踪人工处置状态

资产管理

资产中心、资产拓扑与地图，集中查看收集结果

空间引擎

FOFA、Hunter、Quake 查询及聚合搜索，支持历史、配额查看与下载

企业信息

企业及关联资产收集，支持 Excel 导出与合并导出

请求转发

HTTP 请求编辑与响应查看，支持标签页保存及 Nuclei 模板润色、调试

PoC 管理

Nuclei 模板检索、编辑、扩展目录、调试与 OOB 连通性测试

分析工具

编解码、JWT、API 文档测试、文本比较与杀软识别；桌面端支持小程序反编译

数据与凭据

数据库连接、数据查看与密钥管理

0x03 更新介绍

AI对话资产引用超过10000条资产的任务会出现400报错同一轮多个工具调用之间插入了异步扫描提示，打断工具结果的连续顺序，触发模型的 400 校验错误智能编排Workers和主Agent侧边聊天失败智能编排任务列表计划详情中结果摘要、开始/结束时间、受阻原因为空通过有界准备和共享接口恢复来解决SYN停滞问题report_finding 新增必填 target 避免漏洞目标为空的情况智能编排在对话中worker数量只能最大显示为78

0x04 使用介绍

安装与使用指南

下载对应系统的版本，解压后在终端启动，例如 Linux AMD64：

chmod +x ./hephaestus-linux-amd64./hephaestus-linux-amd64

Web 版首次运行会生成 ~/.config/hephaestus/config.yaml。若默认 PostgreSQL 尚未准备好，程序会提示数据库连接失败；完成下一步配置后重新启动。

配置数据库

方案 A：PostgreSQL（Web 默认，分布式部署必需）

已有 PostgreSQL 时可直接使用，也可使用 Docker 启动本地测试数据库：

docker run -d \  --name hephaestus-postgres \  -e POSTGRES_USER=postgres \  -e POSTGRES_PASSWORD='replace-with-your-password' \  -e POSTGRES_DB=hephaestus \  -p 127.0.0.1:5432:5432 \  -v hephaestus-pgdata:/var/lib/postgresql/data \  postgres:15

在 config.yaml 中填写匹配的连接信息：

web:  port: 18181database:  type: postgres  host: 127.0.0.1  port: "5432"  user: postgres  password: "replace-with-your-password"  dbname: hephaestus  sslmode: disable

方案 B：SQLite（支持 SQLite 的单机产物）

无需启动 PostgreSQL，在 config.yaml 中配置：

web:  port: 18181database:  type: sqlite

省略 database.path 时，数据库默认保存到 ~/.config/hephaestus/data/hephaestus.db。可以用 path 指定绝对路径。SQLite 单机模式不适用于当前共享数据库的分布式 Agent 部署。

打开页面并完成激活与初始化

保存配置后重新启动程序，访问 http://localhost:18181。部署在服务器上时，将 localhost 替换为服务器地址；修改端口时，以 web.port 的配置为准。

  1. 按页面提示填写许可证 Key 完成在线激活，或导入离线许可证。许可证注册入口见上方官网链接。

  2. 激活后，首次使用会进入管理员账户创建页面；已初始化的实例直接登录。