← 返回列表

Hephaestus: 安全测试平台

聚合站 SecWiki技术 入库 2026-11-18T01:37:27

资产收集 · 攻击面评估 · 漏洞验证 · AI 渗透对话

把扫描编排、AI 工具调用与分布式节点,锻造进同一个安全测试工作台。

快速开始 ·
界面预览 ·
核心能力 ·
架构 ·
文档 ·
下载

English · 中文

Important

Hephaestus 仅用于已获得明确授权的安全测试。发起任何探测前,请确认目标、时间窗口与允许的手段,并阅读 授权测试与风险条款。

Hephaestus 是一个前后端一体的安全测试平台:前端使用 Next.js,后端使用 Gin,提供 Web 服务、桌面客户端和独立扫描 Agent 三种形态。它把资产收集、攻击面评估、漏洞验证与 AI 渗透对话放在同一个工作区,让一次授权测试从发现、验证到报告形成闭环。

| 组合任务编排 组合任务 · 资产摸底、端口、密码暴破、网站与 JS 扫描按阶段编排 | AI 渗透工作台 AI 工作台 · 输入授权目标与测试要求,由 Agent 规划并调用工具 |
| 请求转发 请求转发 · 编辑请求、查看响应,保存常用请求标签页 | PoC 模板库 模板管理 · 检索、调试 Nuclei 模板并做 OOB 连通性测试 |

编解码工具

分析工具 · 编解码、哈希、JWT、加解密等操作可组合成处理流水线

模块 能力
攻击面评估 子域名收集、端口与服务识别、网站指纹与漏洞、目录扫描、弱口令检测、JS/API 发现;支持组合任务与阶段编排
AI 渗透工作台 项目与会话、工具调用、图片输入、测试过程记录与证据查看;支持 AI 批量任务与队列管理
漏洞中心 汇总扫描与 AI 发现,按来源、级别与状态筛选,记录复现步骤和证据,跟踪人工处置
资产管理 资产中心、资产拓扑与地图,集中查看 IP、端口、子域名、网站等收集结果
空间引擎 FOFA、Hunter、Quake 等空间引擎的查询与聚合搜索,查看历史、配额并导出结果
企业信息 企业及关联资产收集,支持 Excel 导出与合并导出
请求转发 HTTP 请求编辑与响应查看、标签页保存、cURL/HEX 视图、Nuclei 模板润色与调试
模板管理 Nuclei 模板检索、编辑、扩展目录、调试与 OOB 连通性测试
报告管理 多任务批量导出 Word / Excel / HTML,自定义导出名称
分析工具 覆盖常见 CyberChef 场景的编解码、JWT、API 文档测试、文本比较、杀软识别、数据库信息采集与密钥管理;桌面端支持小程序反编译
任务与节点 并发控制、暂停/恢复/取消、历史与计划任务、参数模板;Agent 注册、心跳、角色容量与版本更新
系统管理 扫描设置、API密钥、AI 配置、扫描模板、字典管理、消息通知、后端日志、系统更新与配置迁移
flowchart TB
    Browser["浏览器"] --> Frontend["Next.js 前端"] --> API["Gin 主服务"]
    API --> Scan["扫描编排<br/>+ 本机 Worker"]
    API --> AI["AI 渗透工作台"]
    API --> Report["Word / Excel / HTML 报告"]
    API <--> DB[("PostgreSQL / SQLite")]
    Scan --> Tools["扫描与 AI 工具<br/>MCP · exec · Python"]
    AI --> Tools
    AI --> Model["模型服务"]
    DB <--> Agent["远程扫描 Agent"]
    Agent --> Tools

下图为 Web / 分布式部署形态。Web 服务与扫描 Agent 通过同一套 PostgreSQL 交换任务、心跳和结果;Agent 通过主服务接口使用平台工具与资源同步。桌面客户端内置同一套服务,默认使用本地 SQLite。模型服务、空间引擎与 AI 工具均按你的配置接入。

方式 适合场景 数据存储 默认入口
单二进制(推荐) 常规部署、生产环境、离线运行 PostgreSQL 或 SQLite http://localhost:18181
Docker(官方镜像 / Compose) 团队共享、服务器部署、快速体验,可直接拉取官方镜像 内置 PostgreSQL 17,可切 SQLite 或外部 PostgreSQL http://localhost:18181
桌面客户端 单机使用、本地工具整合 SQLite,可切换 PostgreSQL 桌面窗口
扫描 Agent 分布式扫描、远程网络执行 与主服务共享 PostgreSQL 无 Web 入口

常规部署推荐从源码编译单二进制。前端会静态导出并嵌入后端二进制,部署机器无需安装 Node.js 或 Go。

在仓库根目录构建并运行:

./scripts/build.sh current
./dist/hephaestus-darwin-arm64   # 以 macOS ARM64 为例

也可以从 Releases 下载对应平台的预编译压缩包。

首次运行会在 ~/.config/hephaestus/config.yaml 生成默认配置;如果默认 PostgreSQL 尚未准备好,程序会提示数据库连接失败,完成数据库配置后重启即可。

默认监听 http://localhost:18181。生产环境建议显式指定配置目录和固定的 JWT 密钥:

HEPHAESTUS_CONFIG_DIR=/opt/hephaestus \
HEPHAESTUS_JWT_SECRET='固定的随机长字符串' \
./dist/hephaestus-darwin-arm64
./scripts/build.sh all        # Windows、macOS、Linux 多平台产物
./scripts/build.sh frontend   # 只构建前端并复制到 backend/webassets/dist
./scripts/build.sh backend    # 复用已有前端产物构建后端

Linux 目标通过 Docker Buildx 构建,需要本机 Docker 服务。

官方镜像发布在 ghcr.io/qiwentaidi/hephaestus,提供 linux/amd64 与 linux/arm64,可以不编译直接拉取运行。镜像默认内置 PostgreSQL 17,启动后只有一个 hephaestus 容器。需要 Docker 24+(含 Compose V2),建议预留 2 GB 以上内存。截图和无头浏览器交互可按需安装 Chromium。

方式一:直接使用官方镜像(无需编译)

不需要克隆仓库,先拉取再运行:

docker pull ghcr.io/qiwentaidi/hephaestus:latest
docker run -d --name hephaestus \
  -p 18181:18181 \
  -v hephaestus-data:/var/lib/hephaestus \
  --shm-size=256m \
  --restart unless-stopped \
  ghcr.io/qiwentaidi/hephaestus:latest

包内 tag 与 Releases 的版本号一致(如 v0.5.7),另有浮动的 latest;生产环境建议把上面的 latest 换成具体版本。公开包可直接匿名拉取,需要登录的网络环境先执行 docker login ghcr.io。升级时重新 docker pull,再用相同参数重建容器,数据卷 hephaestus-data 会保留数据。

用 Compose 管理时,在本仓库根目录叠加 docker-compose.ghcr.yml,把本地构建替换为已发布镜像:

docker compose -f docker-compose.yml -f docker-compose.ghcr.yml up -d
# 固定版本
HEPHAESTUS_IMAGE=ghcr.io/qiwentaidi/hephaestus:v0.5.7 \
  docker compose -f docker-compose.yml -f docker-compose.ghcr.yml up -d

Compose 部署的升级方式:

docker compose -f docker-compose.yml -f docker-compose.ghcr.yml pull
docker compose -f docker-compose.yml -f docker-compose.ghcr.yml up -d

方式二:从源码构建

cp .env.example .env   # 可选:调整端口与数据库
docker compose up -d --build
curl -fsS http://localhost:18181/healthz

打开 http://localhost:18181,首次访问会引导创建管理员账号。

发布版 Compose 部署接入宿主机更新器后,可在页面内升级。详见 Docker 升级。

数据保存在 Compose 卷 hephaestus-data(默认完整名称为 <项目名>_hephaestus-data),挂载到容器内 /var/lib/hephaestus:

config.yaml     应用配置
.pg-password    内置 PostgreSQL 密码
.jwt-secret     服务端 JWT 密钥
pgdata/         PostgreSQL 数据
data/           上传文件、截图等
logs/           应用与 PostgreSQL 日志

只要继续挂载同一个数据卷,docker compose up -d --build 重建容器时就会保留内置 PostgreSQL 数据。更改 Compose 项目名可能会挂载一个新卷。

docker compose ps
docker compose logs -f hephaestus
docker compose down       # 停止并保留数据
docker compose down -v    # 停止并删除数据卷(谨慎)

SQLite:

HEPHAESTUS_DB_TYPE=sqlite docker compose up -d
SQLite 文件位于数据卷的 data/hephaestus.db。适合单机轻量使用;分布式 Agent 需要共享 PostgreSQL。

外部 PostgreSQL: 关闭内置数据库并填写连接信息:

services:
  hephaestus:
    environment:
      HEPHAESTUS_EMBEDDED_POSTGRES: "0"
      HEPHAESTUS_DB_HOST: postgres
      HEPHAESTUS_DB_PORT: "5432"
      HEPHAESTUS_DB_USER: postgres
      HEPHAESTUS_DB_PASSWORD: "你的密码"
      HEPHAESTUS_DB_NAME: hephaestus

环境变量只在数据卷中还没有 config.yaml 时生效;已有配置时以 config.yaml 为准。默认内置 PostgreSQL 只监听容器内 127.0.0.1:5432,不会占用宿主机的 5432。

docker build -t hephaestus:local .
docker run -d --name hephaestus \
  -p 18181:18181 \
  -v hephaestus-data:/var/lib/hephaestus \
  --shm-size=256m \
  --restart unless-stopped \
  hephaestus:local

容器内同样内置 PostgreSQL,不需要额外启动数据库容器。查看状态与日志:

docker ps
docker logs -f hephaestus

桌面端基于 Wails 3,内置本地服务,默认使用 SQLite,本地后端端口为 38456。安装包从 Hephaestus-Desktop 获取。

各平台需要对应的原生工具链:macOS 的 Xcode Command Line Tools、Windows 的 WebView2、Linux 的 GTK/WebKit 开发库。

开发模式:

go install github.com/wailsapp/wails/v3/cmd/wails3@v3.0.0-alpha.78
cd backend/cmd/desktop
wails3 task dev

打包当前平台:

cd backend/cmd/desktop
wails3 task package

在仓库根目录构建多平台安装包:

./scripts/build-desktop-release.sh
多平台安装包产物默认位于 dist/desktop/。

Web 与桌面使用不同配置文件,但默认配置目录相同;需要隔离数据时分别设置 HEPHAESTUS_CONFIG_DIR。

前后端分离运行,适合修改代码。在仓库根目录打开两个终端。

依赖 要求
Go 1.26.3+
Node.js 22+,带 npm
PostgreSQL 17(也可使用 SQLite)
libpcap 端口扫描依赖;macOS brew install libpcap,Ubuntu libpcap-dev,Windows 安装 Npcap
# 终端 1:后端,默认 8080
cd backend
go run -tags dev .
# 终端 2:前端,默认 3000
cd frontend
npm ci
npm run dev

打开 http://localhost:3000。前端默认连接 8080;后端端口变化时,用 NEXT_PUBLIC_BACKEND_PORT 指定:

NEXT_PUBLIC_BACKEND_PORT=8081 npm run dev

cd backend
mkdir -p .dev-config
cat > .dev-config/config.yaml <<EOF
web:
  port: 8080
database:
  type: sqlite
  path: "$(pwd)/.dev-config/hephaestus.db"
EOF
HEPHAESTUS_CONFIG_DIR="$(pwd)/.dev-config" go run -tags dev .

如果本机 5432 已被占用,可以映射到 5433:

export POSTGRES_PASSWORD="$(openssl rand -hex 24)"
docker run -d --name hephaestus-dev-pg \
  -p 127.0.0.1:5433:5432 \
  -e POSTGRES_PASSWORD \
  -e POSTGRES_DB=hephaestus \
  -v hephaestus-dev-pg:/var/lib/postgresql/data \
  postgres:17-alpine

然后在 .dev-config/config.yaml 中写入连接信息并启动后端:

mkdir -p .dev-config
(umask 077
cat > .dev-config/config.yaml <<EOF
web:
  port: 8080
database:
  type: postgres
  host: 127.0.0.1
  port: "5433"
  user: postgres
  password: "$POSTGRES_PASSWORD"
  dbname: hephaestus
  sslmode: disable
EOF
)
HEPHAESTUS_CONFIG_DIR="$(pwd)/.dev-config" go run -tags dev .

更多说明见 本地开发与原生运行。

单机部署不需要 Agent。需要把扫描或 AI 工具执行放到独立节点时,才部署 Agent。节点需要能连接主服务使用的 PostgreSQL。

Linux / macOS 安装:

curl -fsSL 'https://your-server/api/v1/agent/install.sh' -o install.sh
bash install.sh --server 'https://your-server'

Windows 可在「工作节点管理」页下载安装器,或使用:

Invoke-WebRequest -Uri 'https://your-server/api/v1/agent/install.bat' -OutFile install.bat
.\install.bat -Server 'https://your-server'

从源码构建:

cd backend
mkdir -p bin
go build -o bin/hephaestus-agent ./cmd/scan-agent
HEPHAESTUS_CONFIG_DIR=/path/to/agent-config \
AGENT_ROLES=ai,scan \
./bin/hephaestus-agent

完整要求、systemd 安装、批量更新与回滚见 Agent 下载、安装与更新 和 Hephaestus-Agent。

登录后,按需完成以下配置:

  1. 扫描资源:进入「系统设置 → 系统更新」,通过「配置文件更新」下载或更新 PoC、目录字典和弱口令字典。
  2. 空间引擎:使用 FOFA、Hunter、Quake 等服务前,在「系统设置 → API密钥」填写对应 Key。
  3. AI 工作台:在「系统设置 → AI 配置」填写渠道、API 地址、Key 和模型,并测试连接。
  4. 远程节点:使用 Agent 前,准备主服务与节点共用的 PostgreSQL,并按 Agent 文档 部署节点。

完成后即可创建扫描任务,或在 AI 工作台中新建会话并说明授权目标与测试范围。

项目 默认值
Web 生产端口 18181
本地开发后端 8080
本地开发前端 3000
桌面端本地服务 38456
配置文件(原生) ~/.config/hephaestus/config.yaml
配置目录覆盖 HEPHAESTUS_CONFIG_DIR
Docker 数据目录 /var/lib/hephaestus
健康检查 GET /healthz
变量 说明
HEPHAESTUS_CONFIG_DIR 配置、日志与数据目录
HEPHAESTUS_DB_TYPE postgres 或 sqlite
HEPHAESTUS_DB_HOST 数据库主机;Docker 中 local 表示内置 PostgreSQL
HEPHAESTUS_DB_PORT 数据库端口
HEPHAESTUS_DB_USER 数据库用户
HEPHAESTUS_DB_PASSWORD 数据库密码
HEPHAESTUS_DB_NAME 数据库名
HEPHAESTUS_DB_SSLMODE PostgreSQL SSL 模式
HEPHAESTUS_EMBEDDED_POSTGRES Docker 中设为 0 关闭内置 PostgreSQL
HEPHAESTUS_PORT 仅 Compose 使用的主机映射端口
HEPHAESTUS_JWT_SECRET JWT 签名密钥;生产环境建议固定
HEPHAESTUS_AI_ENFORCE_EGRESS 设为 1 启用 Docker 出口网关,默认关闭
HEPHAESTUS_EGRESS_IMAGE 出口网关镜像名,默认 hephaestus-egress:local
HEPHAESTUS_DESKTOP_BACKEND_PORT 桌面端首选本地端口
PORT 开发入口的 Web 端口;生产二进制读取 config.yaml 的 web.port

HEPHAESTUS_DB_* 由 Docker entrypoint 用于生成初始 config.yaml;原生二进制与 Agent 直接读取 config.yaml。已有配置时以配置文件为准。

原生二进制未设置 HEPHAESTUS_JWT_SECRET 时,每次重启会生成新的签名密钥,已登录用户需要重新登录;Docker 镜像会自动生成并持久化 .jwt-secret。

默认的 toolguard 只做调用前规则检查,不依赖 Docker。需要把命令、Python 和原生 HTTP 请求放进隔离网络执行时,才启用 Docker 出口网关。当前 Web 运行镜像未安装 Docker CLI,也没有挂载 Docker socket,建议在宿主机原生运行时启用:

./deploy/egress/build.sh
HEPHAESTUS_AI_ENFORCE_EGRESS=1 ./dist/hephaestus-darwin-arm64

执行期间可用 docker ps --filter label=hephaestus.egress=1 查看临时网关与 Worker 容器;结束后自动清理。出口镜像默认只预装 Python、pip 和 requests,可在 deploy/egress/Dockerfile 中补充工具。详见 本地开发与原生运行 的「可选的 AI 工具出口网关」一节。

docker compose logs hephaestus
docker exec hephaestus tail -n 100 /var/lib/hephaestus/logs/postgresql.log

首次初始化 PostgreSQL 和执行数据库迁移需要几十秒,等待健康检查通过即可。

确认 PostgreSQL 已启动,并在 config.yaml 中填写正确的主机、端口、用户名和密码。单机开发也可以使用上面的 SQLite 配置。

确认后端运行在 8080,或通过 NEXT_PUBLIC_BACKEND_PORT 指定实际端口。

确认构建环境安装了 libpcap / Npcap,并使用 CGO 构建;Linux 发布构建应使用 ./scripts/build.sh,而不是手动 CGO_ENABLED=0 go build。

源码构建部署可在宿主机重建镜像。需要从页面升级时,请按 Docker 升级 接入宿主机更新器。

截图依赖可用的 Chromium 浏览器及其运行环境。Linux Server 和精简容器需检查浏览器、字体及图形依赖。

当前 TCP 发现默认使用 Connect 模式。选择 SYN 时检查系统权限、抓包依赖及 SYN 能力状态,需要时通过平台授权入口启用。

backend/                 Gin 后端、扫描引擎、AI 工作台与 Agent
frontend/                Next.js 前端
docker/                  Docker entrypoint
deploy/egress/           AI 工具出口网关
docs/                    设计、部署与授权文档
scripts/                 构建、发布与安装脚本
Dockerfile               Web 运行镜像(内置 PostgreSQL)
docker-compose.yml       单容器 Compose 部署
文档 内容
Docker 部署 内置 PostgreSQL、数据卷、备份恢复、健康检查与升级
本地开发与原生运行 前后端开发、单二进制、桌面端与出口网关
Agent 下载、安装与更新 五平台安装、systemd、批量更新与回滚
构建与发布脚本 Web、Agent、桌面端构建与发布入口
授权测试与风险条款 测试前、中、后的授权与数据要求

欢迎通过 Issue 反馈问题,或提交 Pull Request。

Hephaestus 的扫描、漏洞验证、AI 工具调用和 Agent 执行都应在合法授权范围内开展。涉及客户资产或第三方系统时,测试方必须在发起任何探测前取得明确书面授权。

完整条款见 授权测试与风险条款。

原文链接:https://github.com/qiwentaidi/Hephaestus/tree/developer