miguerubsk/miku-miku-beam repository overview

⁠Miku Miku Beam 💥⚡ - Project Overview & Docker Tutorial

Original Project by: sammwyy⁠

⁠🇬🇧 English Version

⁠Project Explanation

Miku Miku Beam is a network stress testing tool (stresser) designed with a unique Hatsune Miku theme. It combines a powerful attack engine with a fun, visually appealing interface.

• What does it do? It allows users to perform various types of network traffic attacks against a target to test its resilience.
• Key Features:
  • Attack Methods: Includes HTTP Flood, HTTP Bypass (mimics real browsers), Slowloris, Minecraft Ping, and TCP Flood.
  • Real-time Visualization: Shows live statistics of the attack (packets sent, success/fail rates) on a dashboard.
  • Architecture: Built with React (Vite) for the frontend and Node.js for the backend. It uses Worker Threads to handle high-load attacks efficiently without freezing the server.
  • Theme: Features a cute UI with music and Miku aesthetics to make stress testing less boring.

⁠Running the Container

Since you are pulling the image from Docker Hub and don't have the source code, follow these steps to set up the environment.

⁠1. Preparation (Important!)

The application requires two files to work correctly: proxies.txt and uas.txt.

1. Create a folder for your project (e.g., miku-beam).
2. Inside that folder, create a subfolder named data.
3. Create two files inside data/:
   • proxies.txt (Add your proxies here, one per line)
   • uas.txt (Add User Agents here, one per line)

Structure:

miku-beam/
└── data/
    ├── proxies.txt
    └── uas.txt

⁠Option 1: Using Docker Compose (Recommended)

1. Create a file named docker-compose.yml in your miku-beam folder.
2. Paste the following content:

services:
  app:
    image: miguerubsk/miku-miku-beam:latest
    restart: unless-stopped
    ports:
      - "3000:3000"
    volumes:
      - ./data:/app/data
    environment:
      - NODE_ENV=production

1. Run the container:

   docker-compose up -d
   

   Copy

⁠Option 2: Using Docker Run Command

If you don't want to create a compose file, you can run it with a single command. Make sure you are in the folder containing the data directory.

docker run -d \
  -p 3000:3000 \
  -v "$(pwd)/data:/app/data" \
  --name miku-beam \
  miguerubsk/miku-miku-beam:latest

⁠🇪🇸 Versión en Español

Proyecto original por: sammwyy⁠

⁠Explicación del Proyecto

Miku Miku Beam es una herramienta de pruebas de estrés de red (stresser) diseñada con una temática única de Hatsune Miku. Combina un potente motor de ataques con una interfaz divertida y visualmente atractiva.

• ¿Qué hace? Permite a los usuarios realizar varios tipos de ataques de tráfico de red contra un objetivo para probar su resistencia.
• Características Principales:
  • Métodos de Ataque: Incluye HTTP Flood, HTTP Bypass (imita navegadores reales), Slowloris, Minecraft Ping y TCP Flood.
  • Visualización en Tiempo Real: Muestra estadísticas en vivo del ataque (paquetes enviados, tasas de éxito/fallo) en un panel de control.
  • Arquitectura: Construido con React (Vite) para el frontend y Node.js para el backend. Utiliza Worker Threads (hilos de trabajo) para manejar ataques de alta carga eficientemente sin congelar el servidor.
  • Temática: Cuenta con una interfaz "cute" con música y estética de Miku para hacer las pruebas de estrés menos aburridas.

⁠Ejecutando el Contenedor

Como vas a descargar la imagen desde Docker Hub y no tienes el código fuente, sigue estos pasos para preparar el entorno.

⁠1. Preparación (¡Importante!)

La aplicación necesita dos archivos para funcionar correctamente: proxies.txt y uas.txt.

1. Crea una carpeta para tu proyecto (ej. miku-beam).
2. Dentro de esa carpeta, crea una subcarpeta llamada data.
3. Crea dos archivos dentro de data/:
   • proxies.txt (Añade tus proxies aquí, uno por línea)
   • uas.txt (Añade tus User Agents aquí, uno por línea)

Estructura:

miku-beam/
└── data/
    ├── proxies.txt
    └── uas.txt

⁠Opción 1: Usando Docker Compose (Recomendado)

1. Crea un archivo llamado docker-compose.yml en tu carpeta miku-beam.
2. Pega el siguiente contenido:

services:
  app:
    image: miguerubsk/miku-miku-beam:latest
    restart: unless-stopped
    ports:
      - "3000:3000"
    volumes:
      - ./data:/app/data
    environment:
      - NODE_ENV=production

1. Inicia el contenedor:

   docker-compose up -d
   

   Copy

⁠Opción 2: Usando el comando Docker Run

Si no quieres crear un archivo compose, puedes ejecutarlo con un solo comando. Asegúrate de estar en la carpeta que contiene el directorio data.

docker run -d \
  -p 3000:3000 \
  -v "$(pwd)/data:/app/data" \
  --name miku-beam \
  miguerubsk/miku-miku-beam:latest