cyberrange-forge - Cross-platform defensive cyber-security lab genera

项目说明

<p align="center">
<img src="assets/banner.png" alt="CyberRange Forge Banner" width="900">
</p>

> Generate realistic defensi labs in seconds.

CyberRange Forge is a cross-platform, Docker-powered cybersecurity lab generator designed for defenders, students, educators, SOC analysts, and blue teams.

Instead of downloading large machines or intentionally systems, CyberRange Forge creates lightweight, self-contained in labs using Docker and Jinja2 templates.

Every generated lab includes realistic artifacts, in exercises, documentation, Sigma detection examples, and Docker Compose files.

!
!Python
!Docker
!License
!Platform

Features

* Cross-platform (Linux, macOS, Windows)
* Docker-powered isolated en
* One-command lab generation
* Modular Jinja2 template engine
* Defensi training scenarios
* In exercises
* Sigma detection examples
* Mermaid network diagrams
* YAML lab metadata
* Export generated labs as ZIP archives
* Rich CLI with checks
* Friendly port-conflict warnings instead of raw Docker errors
* Generated lab directories owned by you, not root

Current Release

Blue Team Labs

✔ Phishing Triage
✔ Web Detection
✔ Linux Intrusion

Roadmap

Red Team Labs (Coming Soon)

* Phishing Simulation
* Web Application Assessment
* Linux Post-Exploitation

The next release, v1.1.0, will focus on a single addition: the first Red Team lab, Web Application Assessment. No other Red Team labs, Purple Team features, or scenario systems will ship until their own dedicated releases.

Current Blue Team Labs

Phishing Triage Lab

Learn to in suspicious emails using a simulated MailHog en.

Generated components:

* MailHog email server
* Simulated phishing email
* In guide
* Sigma detection example
* Network diagram

Web Detection Lab

Analyze simulated web server logs for suspicious HTTP requests.

Generated components:

* Nginx web server
* Simulated access logs
* In exercises
* Sigma detection rule
* Network diagram

Linux Intrusion Lab

In simulated Linux authentication events and persistence artifacts.

Generated components:

* Ubuntu analysis container
* Simulated SSH authentication logs
* Suspicious cron persistence
* Process snapshot
* In exercises
* Sigma detection example

Installation

Clone the repository:

Install Python dependencies:

your en:

Quick Start

List a labs:

Generate a lab:

Start the lab:

When you're finished with a lab, stop it before starting another:

Stopping labs prevents Docker port conflicts when launching another lab.

Example Workflow

Project Structure

Screenshots

The repository includes demonstrations of:

* Phishing Triage Lab
* Web Detection Lab
* Linux Intrusion Lab

Each screenshot demonstrates the full workflow from lab generation to in.

Safety

CyberRange Forge is intended solely for defensi education.

The generated labs contain only simulated data and defensi exercises.

No malware is deployed.

No exploitation occurs.

No software is installed intentionally.

AI Transparency

AI was used as an engineering assistant for:

* brainstorming ideas
* improving documentation
* re code
* suggesting project architecture
* refining templates

All concept, implementation, testing, and were completed manually.

License

MIT License

<hr>

Support the Work

![Support on Patreon]()

项目信息

开发语言：Python

Star 数：4

技术要点

该项目属于防护思路方向的开源资源，代码结构清晰，适合安全研究人员学习参考。项目围绕Cross-platform defensive cyber-security lab generator展开，提供了可运行的实现，对理解相关安全机制、工具原理与攻防技术具有较高的研究价值。

从技术实现角度看，此类项目的核心在于对底层原理的深入理解与工程化落地。开发者在研究过程中可以结合官方文档与社区讨论，梳理项目的初始化流程、核心模块职责与数据流转，逐步掌握其中的技术细节与设计思路。

使用与学习建议

1. 下载源码压缩包，解压到本地环境。

2. 根据项目类型准备对应的运行环境与依赖。

3. 按照 README 中的步骤完成配置与部署。

4. 在隔离的测试环境中运行验证，避免影响生产系统。

免责声明

本资源来源于开源社区，仅供安全研究、技术学习与合法授权范围内的攻防演练使用，请勿用于任何非法或侵害他人权益的用途。使用本项目产生的一切后果由使用者自行承担。