StegoForge

StegoForge 是一款企业级的模块化隐写术框架，专为安全研究人员、CTF 参赛者和数字取证专家设计。它将秘密数据（文本、文件、图像）通过数学算法编织到普通载体（图片、音频、视频、文档）中，实现“大隐隐于市”的隐蔽通信。

不同于传统的简单 LSB 工具，StegoForge 提供了从载荷嵌入、加密保护、社会媒体生存测试到机器学习盲取证的全生命周期解决方案。

核心亮点

1. 零依赖独立二进制

• 开箱即用：提供编译好的原生可执行文件，无需安装 Python 环境或配置 PATH。
• 隐私优先：所有处理均在本地完成，Web UI 模式下数据绝不离开机器。

2. 智能隐写与加密

• 多载体支持：支持 PNG (LSB/Alpha), JPEG (DCT), WAV/MP3 (相位/频谱图), MP4 (关键帧), PDF, Office XML 甚至 ELF/PE 二进制文件。
• AES-256-GCM 加密：所有载荷在嵌入前均经过强加密，确保即使载体被截获，内容也无法被读取。
• 诱饵模式 (Decoy Mode)：支持在一个文件中隐藏两个载荷（真实秘密 + 诱饵），分别由不同密钥解锁，提供“可否认性”保护。

3. 高级盲取证与 CTF 模式

• ML 隐写分析：内置基于 HuggingFace ONNX CNN 模型的检测引擎，能识别经过复杂处理的隐写图像。
• 统计检测套件：集成 Chi-square、RS 分析、PRNU 指纹不一致检测等经典算法。
• 一键取证转储：stegoforge ctf 命令可对可疑文件进行全方位启发式扫描，自动发现异常。

4. 社会媒体生存测试

• 平台适配：模拟 Twitter、Instagram、Telegram 等平台的重新压缩机制，测试载荷在上传下载后是否依然存活。
• 死信投递 (Dead Drop)：支持将隐写图像作为 HTTP POST 请求发送，或监控远程 URL 的变化以提取秘密信息。

快速开始

方式一：下载二进制文件（推荐）

前往 Releases 页面 下载对应系统的二进制文件，直接运行即可。

方式二：源码安装

git clone https://github.com/Nour833/StegoForge.git
cd StegoForge
pip install -r requirements.txt
pip install -r requirements-web.txt
pip install -e .

基础用法示例

# 1. 编码：将 secret.pdf 隐藏到 photo.png 中
stegoforge encode -c photo.png -p secret.pdf -k "my-pass"

# 2. 解码：从隐写图中提取文件
stegoforge decode -f photo_stego.png -k "my-pass"

# 3. 取证：对可疑文件进行盲检测
stegoforge ctf -f suspicious.mp3

# 4. 差异分析：生成像素热图对比原图与隐写图
stegoforge diff -c photo.png -s photo_stego.png

# 5. 启动 Web UI
stegoforge web

高级功能详解

载荷编码

• JPEG DCT 嵌入：针对 JPEG 格式优化，更难被统计检测发现。

  stegoforge encode -c photo.jpg -p secret.bin -k "key" --method dct
  

• 频谱图艺术：将图像隐藏在音频的频谱图中，播放时仍为正常音乐。

  stegoforge encode -c music.wav -p logo.png --method spectrogram
  

• 诱饵模式：

  stegoforge encode -c photo.png -p real_secret.txt -k "realkey" \
                    --decoy decoy_message.txt --decoy-key "duresskey"
  

盲取证检测

隐蔽协议 (Dead Drop)

• POST 投递：

  stegoforge deadrop post -c cover.png -p msg.txt -k "shared_key"
  

• 远程监控：

  stegoforge deadrop monitor --url "https://example.com/image.png" -k "shared_key" --interval 20
  

交互式菜单

对于不熟悉命令行的用户，直接运行 stegoforge 即可进入电影感十足的交互式 CLI 菜单，引导你完成编码、解码和取证操作。

• 快速启动：STEGOFORGE_FAST_UI=1 stegoforge
• 调整动画节奏：STEGOFORGE_UI_STAGE_DELAY=0.45 stegoforge