RavinduRathnayaka/LiveThreatMap-dashboard
GitHub: RavinduRathnayaka/LiveThreatMap-dashboard
一个利用 Shodan 数据与 GitHub Actions 自动生成实时全球威胁地图 SVG 的轻量工具。
Stars: 26 | Forks: 9
# 🌍 实时威胁地图仪表板
*由 Shodan 和 GitHub Actions 驱动的实时网络威胁可视化。*
## ✨ 这是什么？
**实时威胁地图仪表板**是一个自动化工具，它**从 Shodan 获取实时威胁数据**，并生成一个简洁的、基于 SVG 的全球网络活动地图。
- 📡 使用 [Shodan API](https://www.shodan.io/) 获取实时数据
- ⚡ **每 6 小时自动更新**（通过 GitHub Actions）
- 🖼️ 在你的仓库中生成 **自更新的 `threat-map.svg`**
- 🌐 轻松嵌入到 **README 文件、仪表板或网站** 中
## 🚀 快速开始
### 1️⃣ 派生此仓库
点击右上角的 **Fork** 按钮，创建你自己的副本。
### 2️⃣ 添加你的 Shodan API 密钥
1. 进入 **Settings → Secrets and variables → Actions**
2. 点击 **New repository secret**
3. 添加你的 Shodan 密钥，格式如下：
- **名称：** `SHODAN_API_KEY`
- **值：** 你的 Shodan API 密钥
### 3️⃣ 工作流自动运行
- 每 **6 小时（UTC）** 自动运行
- 将新的 `threat-map.svg` 提交到仓库根目录
- 你也可以在 **Actions** 标签页中手动运行
## ⚙️ GitHub Actions 工作流
以下是驱动地图的工作流：
```
name: Generate Live Threat Map
on:
# Runs automatically every 6 hours (UTC)
schedule:
- cron: "0 */6 * * *"
# Allows manual trigger
workflow_dispatch:
jobs:
generate_threat_map:
runs-on: ubuntu-latest
name: Generate and Commit Live Threat Map
permissions:
contents: write
steps:
- name: Check out the user's repository
uses: actions/checkout@v4
- name: Generate Threat Map SVG
uses: RavinduRathnayaka/LiveThreatMap-dashboard@main
with:
SHODAN_API_KEY: ${{ secrets.SHODAN_API_KEY }}
```
## 🖼️ 实时演示
以下是自动生成的地图在实际中的效果：
## 📦 在你自己的项目中使用
你可以将 SVG 嵌入到任意 Markdown 文件中：
```
```
或者将其作为图像源添加到仪表板/网站中：
```
```
## 🛠️ 要求
- 有效的 **[Shodan API 密钥](https://account.shodan.io/)**
- 已启用 **Actions** 的 GitHub 仓库
## 🌐 为什么要使用这个？
- ✅ **自动化** – 无需手动更新
- ✅ **可视化** – 全球地图即时洞察
- ✅ **轻量级** – 纯 SVG，无重型依赖
- ✅ **可定制** – 可派生、修改和扩展
## 📜 许可证
本项目采用 **MIT 许可证**。
欢迎使用、修改和分享！
## 💡 实用建议
- 想要更频繁的更新？调整 `.github/workflows/generate-threat-map.yml` 中的 `cron` 计划
- 使用 GitHub Pages 将 **SVG 作为实时网页提供**
- 结合其他数据源，构建一个 **安全可视化中心**
```
## 🛠️ 要求
- 有效的 **[Shodan API 密钥](https://account.shodan.io/)**
- 已启用 **Actions** 的 GitHub 仓库
## 🌐 为什么要使用这个？
- ✅ **自动化** – 无需手动更新
- ✅ **可视化** – 全球地图即时洞察
- ✅ **轻量级** – 纯 SVG，无重型依赖
- ✅ **可定制** – 可派生、修改和扩展
## 📜 许可证
本项目采用 **MIT 许可证**。
欢迎使用、修改和分享！
## 💡 实用建议
- 想要更频繁的更新？调整 `.github/workflows/generate-threat-map.yml` 中的 `cron` 计划
- 使用 GitHub Pages 将 **SVG 作为实时网页提供**
- 结合其他数据源，构建一个 **安全可视化中心**标签：API集成, DNS解析, GitHub Actions, README嵌入, SVG地图, URL抓取, 世界地图, 仪表盘, 可观测性, 地理分布, 地理可视化, 威胁情报, 定时任务, 实时数据可视化, 开发者工具, 开源项目, 持续监控, 数据可视化, 数据抓取, 网络威胁, 网络安全, 自动笔记, 自更新, 隐私保护