LizardPope1101/osint-forge
GitHub: LizardPope1101/osint-forge
OSINT Forge 是一个模块化的 OSINT 工作流管理框架，用于在 Debian/Ubuntu 上统一安装、编排和批处理各类开源情报工具。
Stars: 0 | Forks: 0
# OSINT Forge
[](https://github.com/LizardPope1101/osint-forge/actions/workflows/ci.yml)
OSINT Forge 是一个模块化工具管理器和工作流层，专为极简的
基于 Debian 的 OSINT 工作站设计。
请仅将其用于合法的研究目的。网络扫描必须仅限于您拥有
或被明确授权评估的系统。
## 全新安装 Debian/Ubuntu
```
git clone https://github.com/LizardPope1101/osint-forge.git
cd osint-forge
chmod +x bootstrap.sh
./bootstrap.sh
```
引导脚本会安装基础依赖（`python3`、`python3-venv`、
`python3-pip`、`pipx`、`git`、`sudo` 和 `ca-certificates`）并安装该
框架。各个 OSINT 工具仍为可选安装。
```
osint forge list
osint forge categories
osint forge doctor
osint forge validate
osint forge version
```
## 安装和维护工具
```
osint forge install maigret
osint forge install maigret sherlock ghunt
osint forge install usernames
osint forge install infrastructure --dry-run
osint forge update maigret
osint forge doctor
osint forge remove recon-ng
```
Dry-run（预演）模式可预览生命周期命令，而无需安装可选的工具
依赖。
## 运行单个 adapter
```
osint run maigret username example_handle -o ~/OSINT-Cases/example/maigret
osint run exiftool image photograph.jpg -o ~/OSINT-Cases/example/metadata
```
## 批处理
编辑 `~/.config/osint-forge/targets.txt`：
```
[Emails]
analyst@example.com
[Usernames]
example_handle
[Domains]
example.com
[Images]
./photograph.jpg
```
然后运行：
```
osint batch --name initial-sweep
osint batch --plugins maigret sherlock --name usernames-only
```
批处理引擎会从插件清单中发现兼容的已安装插件。
结果默认存储在 `~/OSINT-Cases/Batch-Runs/`。框架状态统一存储
在 `~/.local/state/osint-forge/`。
传递给 `--plugins` 的未知名称将被拒绝，而不会
被静默忽略。
## 模块化插件系统
每个工具都是一个独立的插件：
```
plugins//
├── manifest.json
├── install.sh
├── update.sh
├── remove.sh
└── doctor.sh
```
清单声明了类别、命令、支持的目标类型、生命周期
脚本、root 权限要求以及目标 adapter。Adapter 命令是参数
数组，而不是插值的 shell 字符串。
在不执行插件的情况下验证完整的插件契约：
```
osint forge validate
osint forge validate --json
```
复制 `docs/plugin-template` 以启动新插件。有关完整契约，请参阅
[`docs/PLUGIN-API.md`](docs/PLUGIN-API.md)。
## 卸载框架
```
sudo ./scripts/uninstall-framework.sh
```
这将移除 OSINT Forge 启动器和框架文件。已安装的
第三方工具和案例数据将保持不变。
## 安全性
请勿公开报告漏洞。请遵循项目的
[安全策略](.github/SECURITY.md) 以了解范围和私密的报告指南。
## 许可证
OSINT Forge 基于
[GNU General Public License v3.0 或更高版本](LICENSE) 授权。
版权所有 © 2026 LizardPope1101。
OSINT Forge 会安装并调用独立的第三方程序；它不会
重新许可这些程序。每个程序仍受其自身许可证的约束。请参阅
[`THIRD_PARTY_NOTICES.md`](THIRD_PARTY_NOTICES.md)。
标签：Blue Team, Debian, ESC4, GitHub, OSINT, Python, 实时处理, 应用安全, 文档结构分析, 无后门, 逆向工具