百科.dev
全部条目在线工具AI 编程趋势榜开源项目技术资讯提交条目
登录
< 返回工具列表
N

Netgotchi

> 编程语言
开源

reversed pwnagotchi: netgotchi 存在于网络中,为您的网络提供保护

352 stars0 点赞1 次浏览
访问官网GitHub

工具介绍

reversed pwnagotchi: netgotchi 存在于网络中,为您的网络提供保护

️ Netgotchi

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

Get an Official Build and support the development ❤

Support the development by getting an official Netgotchi build:

  • Tindie
  • Etsy

New!

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

Netgotchi Pro version : Pro version has a keypad to access the settings, change mode like chat-device ( TEXTgotchi ) or gpio remote controller ( CTRLgotchi ) , from the device itself without re-flashing settings and a small buzzer for sound alerts!

  • Netgotchi PRO on Tindie
  • Netgotchi PRO on Etsy

️ Requirements

  • ESP8266 or ESP32
  • OLED display (SSD1306, SH1106, or SSD1305)
  • USB cable
  • Optional: 3D printed case (Community case for Wemos D1)

Wiring Diagram

ESP8266

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 :

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

  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 :

️ Headless Mode (for Cyberdecks)

  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 )

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!
  • example on esp8266:

Status and animations explained

  • 1st Page
    top left corner : date and time
    top right corner : honeypot status ("ok" or if there is an attack it will appear as "breached")
    botton left corner : how many devices are active in the wifi network
    bottom center : number of VU ( vulnerabilities ) found
    bottom right corner : status - idle /scan
    center : netgotchi face and animations, the netgotchi will start crying ( T_T ) if there was an attack and it will display the attacker ip address. Netgotchi will display an "evil twin face" if someone cloned your wifi for an evil attack "( e_t )".

  • 2nd Page : active devices - UP for recently active, DOWN recently disconnected , WNR warning if they have a vulnerability

  • 3rd Page : Network speed and network integrity ( ping, average speed, connection status )

  • 4th Page : Netgotchi IP and uptime

  • Extra: Pro only : move page and setting menu on left button / right button
    V2 and Pro only : audio alarm on attack

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

Issues· 0 开放

查看全部 Issues在 GitHub 打开

暂无开放 Issues,或尚未同步最近议题。

> 标签

C++

暂无评论,来聊聊你的看法吧

> 工具信息

发布日期2026年8月1日
最后更新2026年9月17日
分类编程语言
定价开源

> 相关工具

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言