/Netgotchi

reversed pwnagotchi : netgotchi lives to protect your network

Primary LanguageC++GNU General Public License v3.0GPL-3.0

🛡️ Netgotchi

Netgotchi Image

Netgotchi: Your network's loyal guardian! 🐾

A small arduino .ino script with some great functions to detect intruders or breaches in the network, it pings periodically the network and reports if any new device. It also has a rudimental "Honeypot" functionality with a rudimental exposed service, once someone reaches the honeypot it will trigger an alarm. Please contribute to the repository via pull requests!

Tested with Nmap, service scan / intense scan will trigger the alert.

🌟 Features

  • 🔍 Periodic network scanning
  • 🍯 Built-in "Honeypot" functionality
  • 🚨 Intrusion detection and alerting
  • 🖥️ Support for multiple OLED display types
  • 🔄 Supports both ESP8266 and ESP32

Netgotchi Screen 1 Netgotchi Screen 2

🛒 Get an Official Build and support the development ❤

Support the development by getting an official Netgotchi build:

Note : for security purpose make sure you buying from from official the link above, you will receive the latest version of this repository, without any modification.

PRO version & Prototypes

IMG_20240829_1519522

Netgotchi Pro version : Pro version has a keypad to access the settings from the device itself without re-flashing settings and a small buzzer for sound alerts!

🛠️ Requirements

📊 Wiring Diagram

ESP8266 Netgotchi Diagram ESP32 esp32

📚 Libraries

  • ESP8266/ESP32 core libraries
  • Modified FTP Server library (ESP8266FtpServer or ESP32FtpServer) -- you need to install the one provided in the "/libraries" folder in this repo
  • Adafruit_GFX
  • Adafruit_SSD1306, Adafruit_SH110X, or Adafruit_SSD1305 (based on your OLED type)
  • ESPping
  • NTPClient
  • WiFiManager
  • Button2

🚀 How to Use

  1. Open the .ino file in the Arduino IDE, make sure you have all files open like the image below : immagine

  2. Select your OLED display type by setting the appropriate flag to 1 (e.g., #define oled_type_ssd1306 1).immagine

  3. Install the required libraries via the Arduino Library Manager.

  4. Select your board (ESP8266 or ESP32) in the Arduino IDE.

  5. Flash the code to your board.

  6. On the first boot, Netgotchi will create a WiFi hotspot named "AutoConnectAP" for you to set up your WiFi credentials.

  7. Once connected, Netgotchi will start guarding your network!

Netgotchi Pro configuration :

immagine

🖥️ Headless Mode (for Cyberdecks)

Headless Mode

  1. Open utils/cyberdeck/pyserial_cyberdeck.py
  2. Change the COM port on line 5 (e.g., /dev/ttyUSB0 for Linux, COMx for Windows)
  3. Run the script

🔎 Vulnerability Scanning

Netgotchi scans for potentially vulnerable services including:

  • Telnet (23)
  • FTP (21)
  • SSH (22)
  • VNC (5900)
  • RDP (3389)
  • SMB (445)
  • HTTP (80)
  • HTTPS (443)

Vulnerable hosts are marked with "WRNG!". This feature can be toggled with the securityScanActive flag.

🖥️ Web Interface ( v.1.4 update)

Visit your netgotchi ip address at the port :80 ( the IP will be visible on the screen once connected ) netgotchi222

How to flash ( webmode - easy mode )

  • Connect your ESP8266 or ESP32 or Netgotchi via USB cable ( Data cable)
  • Use Chrome to go https://espressif.github.io/esptool-js/
  • Press "Connect"
  • Press "Add File" , select Netgotchi.ino.bin ( Find it in "Release")
  • Press "Flash"
  • Restart your Netgotchi , Enjoy!

😊 Join us on Discord

Discord Server: Join Now!

🤝 Contributing

We welcome contributions! Please submit your pull requests to help make Netgotchi even better.

Join our Reddit community!

📜 License

GNU General Public License v3.0

Created with ❤️ by MG MXZZ | ESP32 Port Created by itsOwen