osmedeus

一键编排安全扫描，自动发现攻击面，提升渗透效率。

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署开源模型 🍴 复刻 1036 🐛 待处理 6 👀 关注 135

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 6646

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源项目，MIT许可证，可免费使用和自行部署。

项目预览

项目数据

分类开源模型

开发团队j3ssie

官网地址https://www.osmedeus.org

GitHubhttps://github.com/j3ssie/osmedeus

定价模式🏷️完全免费

价格说明开源项目，MIT许可证，可免费使用和自行部署。

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言Go

技术栈/模型agentic-ai,attack-surface-management,bugbounty,go,hacking,hacking-tool,hacktoberfest,llm,osint,penetration-testing,pentesting,reconnaissance,security,security-tools,workflow-engine,workflows

GitHub 星标★ 6646

上线时间2018-11-10 00:00:00

代码更新2026-11-06

仓库体积201.9 MB

本站数据更新2026-11-10

维护状态活跃

收录时间2026-08-09

浏览次数6

项目介绍

osmedeus 是一个用 Go 编写的现代化安全编排引擎，旨在自动化执行漏洞扫描和攻击面管理流程。它通过工作流（Workflow）的概念，将信息收集、端口扫描、漏洞检测、子域名枚举、敏感信息发现等众多安全工具串联起来，实现一键式、可定制的自动化安全评估。项目解决了安全团队在渗透测试和红队行动中手动操作大量工具、效率低下、流程难以标准化的问题。其核心能力包括：强大的工作流引擎，支持并行执行和依赖管理；内置丰富的扫描模板和插件；提供清晰的报告输出；支持 API 和 CLI 两种交互方式，便于集成到 CI/CD 管道。osmedeus 适合安全研究人员、渗透测试人员和企业安全团队，用于持续监控自身资产的安全状况。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 6646

技术标签

agentic-ai go hacking hacktoberfest llm

使用教程

ℹ 本教程由 AI 依据该项目 README 整理，个别步骤可能需要按你的环境微调。

难度：进阶约 10 分钟部署方式：命令行工具 8 步

环境要求

Linux/macOS 等可执行 Bash 脚本的环境
已安装 curl（安装脚本通过 curl 管道执行）
如需容器方式运行，需预先安装 Docker
使用 agent 功能时需要有可用的 ACP 智能体（如 codex）

安装与启动步骤

1一键安装

官方提供的安装脚本，通过 curl 下载并直接交给 bash 执行，安装完成后 osmedeus 命令即可用。
```
curl -sSL http://www.osmedeus.org/install.sh | bash
```
2安装预设仓库

从预设仓库安装 base 与 workflow 资源；加 --keep-setting 可保留已有的 osm-settings.yaml 配置。
```
osmedeus install base --preset
osmedeus install workflow --preset
```
3运行模块工作流

使用 -m 指定模块（如 recon 侦察模块），-t 指定目标域名，执行单模块任务。
```
osmedeus run -m recon -t example.com
```
4运行完整流程

使用 -f 指定 flow 流程（如 general），把多个模块串起来一次性执行完整评估。
```
osmedeus run -f general -t example.com
```
5预演模式

加上 --dry-run 只预览将要执行的流程和步骤，不会真正发起扫描，适合先确认范围。
```
osmedeus run -f general -t example.com --dry-run
```
6查询结果

query 子命令可查漏洞、运行记录和步骤；按 severity、status、run 等条件过滤。
```
osmedeus query vulns --severity high --workspace example.com
osmedeus query runs --status running
```
7交互式智能体

agent 子命令以 ACP 智能体方式交互执行任务，可用 --agent 指定具体智能体，--list 查看可用项。
```
osmedeus agent "analyze this codebase"
osmedeus agent --agent codex "explain main.go"
osmedeus agent --list
```
8Docker 方式运行

使用官方镜像 j3ssie/osmedeus:latest，把宿主机目录挂载到 /root/workspaces-osmedeus 保存结果。
```
docker run --rm -v $(pwd)/output:/root/workspaces-osmedeus j3ssie/osmedeus:latest run -f general -t example.com
```

关键配置

配置项	必填	说明	示例
`osm-settings.yaml`	否	Osmedeus 的设置文件，重新安装预设时可选择保留现有配置	`osm-settings.yaml`

如何确认成功

执行 osmedeus --usage-example，能列出全部用法示例即表示安装成功、命令可用。

常见问题

Q：重新安装预设时如何不覆盖已有配置？

A：使用 osmedeus install base --preset --keep-setting，该参数会保留现有的 osm-settings.yaml 设置。

Q：不想真正扫描，只想先看看流程？

A：在 run 命令后加 --dry-run，例如 osmedeus run -f general -t example.com --dry-run，仅预览不执行。

Q：怎么查看某次运行的执行细节？

A：用 osmedeus query steps --run <run-uuid> 查询该次运行下的步骤，run-uuid 可从 osmedeus query runs 获取。

Q：如何查看全部命令示例？

A：执行 osmedeus --usage-example 会输出所有用法示例；更多 CLI 用法参考官方 CLI Reference 文档。

Q：没有本地环境能用 Docker 跑吗？

A：可以，README 给了 Docker 示例：挂载输出目录后直接运行镜像，如 docker run --rm -v $(pwd)/output:/root/workspaces-osmedeus j3ssie/osmedeus:latest run -f general -t example.com。