dual339/Cyber-Guard-Ransomware-awareness-lab
GitHub: dual339/Cyber-Guard-Ransomware-awareness-lab
一个交互式勒索软件安全培训平台，模拟攻击与防御流程以提升实战认知。
Stars: 2 | Forks: 0
# Cyber Guard: Ransomware Awareness Lab
Cyber Guard: Ransomware Awareness Lab 是一个交互式网络安全培训平台，在安全环境中模拟勒索软件事件。它具备恶意软件分析、加密演示、防御指导以及使用 React、TypeScript、Node.js、Socket.IO 和 Firebase 进行的实时攻防演练。
## 本地运行
**前置条件：** Node.js
1. 安装依赖：
`npm install`
2. 在 `.env.local` 中设置 `GEMINI_API_KEY` 为你的 Gemini API 密钥。
3. 可选：在 `.env.local` 中设置 `MALWAREBAZAAR_AUTH_KEY` 以启用 MD5/SHA256 恶意软件哈希查询。
4. 运行应用：
`npm run dev`
## 部署到 Cloud Run
该应用使用 Express 服务器和 Socket.IO，因此应部署到支持 Node.js 的主机，例如 Google Cloud Run。
1. 本地构建并验证：
`npm run build`
2. 认证并选择你的 Google Cloud 项目：
`gcloud auth login`
`gcloud config set project YOUR_PROJECT_ID`
3. 从源代码部署：
`gcloud run deploy cyber-guard-ransomware-awareness-lab --source . --region us-central1 --allow-unauthenticated`
4. 部署后根据需要设置运行时环境变量：
`gcloud run services update cyber-guard-ransomware-awareness-lab --region us-central1 --set-env-vars GEMINI_API_KEY=YOUR_KEY,MALWAREBAZAAR_AUTH_KEY=YOUR_KEY`
Cloud Run 将自动提供 `PORT` 环境变量，应用在生产环境中将监听该端口。
## GitHub Pages
该仓库还包含一个 GitHub Pages 工作流，可将静态前端发布至：
`https://dual339.github.io/Cyber-Guard-Ransomware-awareness-lab/`
GitHub Pages 可以托管 React/Vite 前端，但无法运行 Express API 或 Socket.IO 服务器。这意味着依赖后端的功能（例如实时房间演练和服务器端哈希查询）在需要完整在线功能时必须使用独立的后端主机。
## 部署到 Render（免费）
该项目包含一个 [render.yaml](C:\CyberGuard\ransomware-awareness-lab\render.yaml) 蓝图，可将其部署为免费的 Render Web 服务。
1. 将最新代码推送到 GitHub。
2. 打开 [Render 控制台](https://dashboard.render.com/)。
3. 点击 `New +` -> `Blueprint`。
4. 连接 GitHub 仓库：
`https://github.com/dual339/Cyber-Guard-Ransomware-awareness-lab`
5. Render 将检测到 `render.yaml` 并自动创建服务。
6. 如果希望集成功能正常工作，请在 Render 中添加以下环境变量：
`GEMINI_API_KEY`
`MALWAREBAZAAR_AUTH_KEY`
注意：
- 免费 Render 计划可能在非活动一段时间后休眠，因此首次请求可能会较慢。
- Render 可以托管 Express 应用程序和 Socket.IO 服务，这使得它比 GitHub Pages 更适合此项目。
标签：API服务, DAST, Firebase, GitHub Pages, GNU通用公共许可证, Google Cloud Run, MITM代理, Node.js, React, Render部署, Socket.IO, Syscalls, TGT, TypeScript, Web安全, 云端部署, 交互式训练平台, 前后端分离, 加密演示, 勒索ware意识, 勒索软件模拟, 在线实验室, 安全学习, 安全插件, 实时通信, 恶意软件分析, 攻击者防御者模拟, 攻防演练, 沙箱环境, 漏洞修复, 网络安全培训, 自动化攻击, 蓝队分析, 防御指导