github.com/aifred0729-TW/Minerva @v2.1.2

繁體中文 | English

Next-Generation Mythic C2 Interface

為高階紅隊 Operator 打造的 Cyberpunk 風、即時、可協作 Command & Control 介面

---

目錄

• 概述
• Screenshots
• 功能總覽
• Application Map
• Tech Stack
• Quick Start（Production）
• Development Mode（Hot Reload）
• Metasploit Integration
• Setup Script（minerva_install.sh）
• Mythic 原始碼修補（mythic_change.sh）
• Project Structure
• Architecture
• Routing & Sidebar
• Nginx Proxy Layout
• Theme System
• Battle Mode
• Audio System
• Custom Graph Nodes
• Authentication & Sessions
• Environment Variables
• Troubleshooting
• License

---

概述

Minerva 是一款為 Mythic C2 Framework 打造的現代化 Cyberpunk 風 Web 介面，可作為 Mythic 內建 MythicReactUI 的直接替代品。設計目標是給長時間執行紅隊任務、需要高資訊密度與低操作摩擦的 Operator 使用。

相較於原版 Mythic UI，Minerva 提供：

• Real-time Collaborative Graph — ReactFlow 驅動的 Callback Topology，支援多 Operator 共享的 Custom Node（用來描述 Relay／Proxy 等 Mythic 原生不認識的基礎設施），透過 Hasura 每 5 秒同步。
• 3D Cyber-Topology — Three.js 場景，含 Orbit Controls、Subnet（CIDR）Grouping、物理排版、P2P 虛線、Tunnel 圖層與 Context Menu。
• Rich Interactive Console — 多分頁 Terminal，含結構化 Output Block、Mimikatz Parsing、Process List 渲染、File Browser 疊加，以及內嵌的 Tasking 表單。
• Quick Hack 工作流 — 一鍵套用的紅隊工作流模板（recon／persistence／dumping／lateral movement），將指令串成 macro 對選取的 Callbacks 批次下發。
• 原生 Metasploit 整合 — 內建 MSF-RPC Client，包含 Launch Dashboard、Session 生命週期管理、可永續保存的 Execution History、以及即時 Task Browser Output 解析。
• MITRE ATT&CK Matrix — 完整 T-id 矩陣，疊加 Task／Command／Tag 資料，讓 Operator 即時看到 Technique 覆蓋率。
• Eventing 工作流 — 視覺化 Eventing Instance Builder，含 Keyword Trigger 與條件式步驟。
• Battle Mode — 戰術 UI 模式（Combat／Recon／Normal），即時調整 Density、Animation Speed 與 Ambient SFX 的強度。
• Theming & Audio — CSS 變數驅動的 Dark／Light Theme、可自訂背景圖、JetBrains Mono／Inter 字型、IndexedDB 儲存的音樂庫、每事件對應的 SFX。

Minerva 可以用兩種方式部署：

1. 獨立 Docker 容器 — 自己一個 minerva 容器（Nginx + 靜態 Build），把 /graphql、/auth、/refresh、/msf-rpc、/direct 反向代理到既有的 Mythic Instance。適合 Production／封閉部署。
2. 取代 mythic_react — 透過 scripts/minerva_install.sh 把 Minerva 灌進 Mythic 的 MythicReactUI 目錄，讓它跟著 Mythic 原本的 ./mythic-cli 生命週期一起運轉。

---

Screenshots

1 · Authentication

Login

Cyberpunk 風 Authentication 介面，含即時 Server Status 監控、HTTPS Encryption Indicator、Session State Tracker。

2 · Command & Control

Dashboard

Central Command 概覽 — 顯示 Active Callbacks、Total Payloads、C2 Infrastructure 狀態、Operation 詳情、Command Statistics、Asset Collection Metrics、Top Commands 與 Recent Activity Feed。

Event Feed

即時事件串流與 Alert Counter。連動 Sidebar 的通知鈴鐺，並把新的 Callback、Alert、Custom Event、Feedback、Startup 事件即時呈現。

Operations Manager

Operation Lifecycle 管理，支援 Status Tracking（Active／Complete／Deleted）、Operator 指派與每 Operation 專屬的 OPSEC Command Blocklist。

OPSEC

每 Operation 的 OPSEC 控制 — Command Blocklist、Role-based Gate、Tasking 時的執行檢查。

3 · Callbacks & Tasking

Active Callbacks

ReactFlow Graph 顯示 Minerva Core Node 與 Active Agents 的連線。Custom Nodes 用來模擬 Relay／Proxy 基礎設施。下方為可排序的 Data Table，支援 Bulk Actions、Sleep／Jitter 編輯、Grouping 與最後 Checkin 標記。

Console Selection

多 Callback 互動式 Console 的分頁選擇器，列出所有 Operator 先前開啟過的分頁，讓你不丟 Context 就能在 Callback 間切換。

Interactive Console

豐富的 Command Tasking — 結構化 Output Block、Mimikatz Parsing、Process List 渲染、File Browser 疊加、內嵌 Tasking 表單、Drag-and-drop Upload 與即時 Streaming Task Block。

Tasks

單一 Task 的深度檢視 — 完整 Host Tree、Parameter Inspector、結構化 Output Viewer 與前後 Task 切換。

4 · Payloads

Payloads Overview

Payload 列表 + 多步驟 Create-Payload Wizard + Wrapper 流程的整合頁。支援 Payload Configuration 的 Import／Export 與從既有 Payload 重 Build。

Create Payload Wizard

逐步 Build 流程：OS → Type → Commands → C2 → Build。每步驟都會保留狀態，Operator 可隨時退回修改而不丟進度。

Payload Types

所有已安裝 Agent／Wrapper／Translator／Consuming Service／Custom Browser 的統一檢視。頁首工具列新增搜尋、排序（依名稱／狀態／命令數）、Online Only 篩選與 Show Deleted 切換。每張卡片顯示 Agent SVG 圖示、容器狀態、Build Parameter Inspector、Command Browser、Container File Editor，以及一鍵測試 Webhook／Logger 事件。

5 · Files、Credentials & Intel

File Manager

集中式 File Management，側欄分類為 Downloads、Uploads、Screenshots 與 Eventing Workflow Files。包含 Target Machine File Browser Tree。

Credentials Vault

Credential 儲存，支援多欄位搜尋（Account、Realm、Credential、Comment、Tag），追蹤 Verified 與 Harvested 數量，並把每筆 Credential 連回原始來源 Task。

Artifacts

IoC／Artifact Viewer，可連回 Task 來源並標記主機歸屬。

Search

跨 Tasks／Files／Credentials／Callbacks／Artifacts 的全域搜尋與進階過濾。

6 · Infrastructure

C2 Profiles

C2 Communication Profile 管理，列出所有已安裝的 Profile（discord、dns、github、http、https、tcp、websocket），含版本資訊、Status Indicator、Container File 列表／編輯與 Start／Stop 控制。

Tunnel Manager

Tunnel 管理介面，含視覺化 Flow Diagram 顯示 Operator-side Proxy、C2 Server Relay 與 Target-side Endpoint。即時顯示 Tunnel 狀態、Port Mapping 與完整連線鏈。

3D Cyber-Topology

完整 Three.js 驅動的 3D Network Map，含 Orbit Control。Nodes 依類型（Core／Alive／Dead／Custom）以顏色區分，虛線代表 P2P 關係，Tunnel Layer 疊加目前的 SOCKS／RPORTFWD 鏈，並提供 Legend Overlay 與 Real-time Status Bar 顯示 Node 計數。

7 · Automation & Frameworks

Quick Hacks

一鍵紅隊工作流庫（recon／persistence／dumping／lateral），把指令串成 macro 批次下發給選取的 Callbacks。工作流以 JSON 定義，Operator 可自行擴充。

Metasploit

原生 MSF-RPC Client。Tabs 涵蓋 Dashboard（Session／Job／Module 統計）、Launch Attack（Module Browser + 參數表單）、Operations（活躍 Session、Job、Route）與 Task History（永久 Execution History 含完整輸出）。

Eventing

Mythic Eventing 的視覺化 Workflow Builder — Event Group、Instance、Keyword Trigger、條件式步驟、即時事件串流。

8 · Intel & MITRE

MITRE ATT&CK

完整 ATT&CK Matrix Visualization，涵蓋全部 Tactic 與 637 項 Technique。可依 Tasks、Tasks/PT、Commands、Tags 篩選 — Cell 會即時亮起以顯示 Technique 執行覆蓋率。

9 · Admin & Customization

Users

Operator 管理：建立、編輯、停用、改密碼與切換 Admin 角色。

Reporting

從 Operation Data 出發的 Report Builder，支援 Analytics、Filter 與 Export 選項。

Browser Scripts

可編輯的 Browser Script 庫，含虛擬化 Table、可排序欄位、tabs 渲染與 Per-PT Scoping。

Tags

跨所有 Entity 的 Tag-based Organization 與 Filtering。

Settings

完整 Preferences Panel，涵蓋 Operator Preferences、Display Toggle、Timestamp Formatting、Task Interaction Mode、Browser Script Option、Audio／Music Library、Theme Palette、Sidebar Shortcut 排序等。

---

功能總覽

Core Operations

功能	說明
Callbacks	即時 Callback Tracking，含 Health Indicator（alive／dead／streaming）、Bulk Operations、Grouping、最後 Checkin 標記與 Sleep／Jitter 編輯
Console	多分頁互動式 Command Tasking，支援語法高亮 Output Block、Split-view DB Output、Command History、autoScroll 切換、Drag-and-drop File Upload、Streaming 結果
Tasks	專屬 Single Task View，含完整 Host Tree、Parameter Inspector、Output Viewer 與 Task 切換
Payloads	多步驟 Create-Payload Wizard（OS → Type → Commands → C2 → Build）、Wrapper 流程、Payload Import／Export、從既有 Payload 重 Build、Browser Script tabs 輸出的最大數限制
Files	Download／Upload 追蹤、Screenshot 縮圖瀏覽、Keylog 搜尋、Modal Drag-and-drop Upload、Artifact 整理
Credentials	Vault，支援 Deduplication、Hash Management、Account Linking、多欄位搜尋
Search	跨 Tasks／Files／Credentials／Callbacks／Artifacts 的全域搜尋與進階過濾
Artifacts	IoC／Artifact Viewer，可連回 Task 來源
Tags	跨所有 Entity 的 Tag-based Organization 與 Filtering

Visualization

功能	說明
Callback Graph	ReactFlow 互動式 2D Graph，含 ELK 自動排版、Custom Node 建立、Edge 管理、PNG Export 與 Graph Config Panel
3D Topology	Three.js 3D Network Map，含 Orbit Control、CIDR Grouping、物理排版、Tunnel 圖層與右鍵 Context Menu
Custom Nodes	Operator 自訂的 Relay／Proxy Node，存在 Hasura agentstorage，每 5 秒在所有連線 Operator 間同步
MITRE ATT&CK	完整 ATT&CK Matrix，疊加 Tasks／Commands／Tags 以顯示 Technique 執行覆蓋率
Tunnel Map	Cyberpunk Flow Diagram 顯示 Parent-child Tunnel 關係、Port Mapping 與即時狀態

Advanced

功能	說明
Battle Mode	Combat／Recon／Normal 模式切換，Combat 模式 2× Animation Speed，Recon 模式淡化非關鍵 Chrome
Eventing	Mythic Eventing 的視覺化 Workflow Builder — Event Group、Instance、Keyword Trigger、條件式步驟、即時事件串流
Quick Hack	一鍵紅隊工作流庫（recon／persistence／dumping／lateral），把指令串成 macro 批次下發給選取的 Callbacks
Metasploit	原生 MSF-RPC Client，含 Launch Dashboard、Session 列表、Job 控制、儲存 Credential、可永續保存的 Execution History
Operations	Operation Lifecycle 管理，支援 Role-based Access 與每 Operation 的 OPSEC Command Blocklist
Reporting	從 Operation Data 生成 Report 與 Analytics
C2 Profiles	Profile Configuration、Container File 列表／編輯、Start／Stop 控制
PayloadTypes	統一檢視所有已安裝的 Agent／Wrapper／Translator／Consuming Service／Custom Browser，含即時狀態、Build Parameter Inspector、Command Browser、Container File Editor，以及一鍵測試 Webhook／Logger 事件
Browser Scripts	可編輯的 Browser Script 庫，含虛擬化 Table、可排序欄位、tabs 渲染、Per-PT Scoping
Audio System	Global Music Player（IndexedDB 儲存）、每事件 SFX（Callback、Tunnel、Auth、Error）、單一 SFX 個別開關
Theme & Palette	Dark／Light Theme、可自訂 Accent 顏色、自訂背景圖、JetBrains Mono／Inter 字型

---

Application Map

整個 UI 都掛在 /new/... 之下（可以與原版 mythic_react 並存）。Route 對照：

Path	Page	用途
/new/login	Login	JWT 登入 + Server Status／SSL Indicator
/new/invite	Invite	Operator Invite 連結註冊
/new/dashboard	Dashboard	作戰總覽與活動 Feed
/new/events	EventFeed	即時事件串流與 Alert Counter
/new/callbacks	Callbacks	活躍 Callback 表格 + Graph View
/new/callbacks/:displayId	Callbacks	聚焦特定 Callback（Deep Link）
/new/console	ConsoleSelection	Console 分