ChSSHKracker
Powerful Python SSH brute force tool with multi-threaded architecture, advanced honeypot detection, real-time statistics, and system reconnaissance. Perfect for authorized security testing and penetration testing.
Install / Use
/learn @Ch4120N/ChSSHKrackerREADME
ChSSHKracker
Advanced Multi-Threaded SSH Brute Force Tool with Honeypot Detection
</div>ChSSHKracker is a powerful, high-performance SSH brute force tool written in Python with enhanced multi-layer worker architecture, advanced honeypot detection, real-time statistics, and comprehensive system reconnaissance capabilities. Perfect for authorized security testing, penetration testing, and cybersecurity research.
📋 Table of Contents
- 👨💻 Project Programmer
- 🧠 Made For
- 🖼️ Screenshots / Preview
- ⚓ Requirements
- ⚙️ Installation Guide
- 💻 Supported Platforms
- ✨ Features
- 💻 Usage
- ⚙️ Configuration
- 🔍 Advanced Features
- 📊 Output Files
- 🏗️ Project Structure
- ❤️ Support the Project
- ⚠️ Disclaimer
- 🚨 Reporting Issues
- ❓ Frequently Asked Questions (FAQ)
- 📄 License
👨💻 Project Programmer
Ch4120N — Ch4120N@Proton.me
🧠 Made For
Security researchers, penetration testers, and cybersecurity professionals who need powerful SSH brute force capabilities with advanced honeypot detection for authorized security testing, penetration testing, and network security assessment.
🖼️ Screenshots
<div align="center">| Main Interface | Interactive Mode | Statistics Display | | :---: | :---: | :---: | | <img src="./images/screenshot1.png" alt="ChSSHKracker Main Interface - SSH brute force tool with real-time statistics" width="400" title="ChSSHKracker Main Interface"/> | <img src="./images/screenshot2.png" alt="ChSSHKracker Interactive Mode - User-friendly SSH cracker interface" width="400" title="ChSSHKracker Interactive Mode"/> | <img src="./images/screenshot3.png" alt="ChSSHKracker Statistics Display - Real-time progress tracking" width="400" title="ChSSHKracker Statistics"/> |
</div>⚓ Requirements
- Python 3.7+
- pip (Python package manager)
📦 Installing Dependencies
python -m pip install -r requirements.txt
Or install manually:
python -m pip install cryptography==40.0.2 paramiko==2.11.0 colorama==0.4.6 prompt_toolkit==3.0.52
⚙️ Installation Guide
Linux
sudo apt install python3 git -y
git clone https://github.com/Ch4120N/ChSSHKracker.git
chmod 755 -R ChSSHKracker
cd ChSSHKracker
python3 -m pip install -r requirements.txt
python3 ChSshKracker.py --help
Windows
If you have Git installed:
git clone https://github.com/Ch4120N/ChSSHKracker.git
cd ChSSHKracker
python -m pip install -r requirements.txt
python ChSshKracker.py --help
Otherwise, download the ZIP release, extract it, and run it directly.
macOS
brew install python3 git
git clone https://github.com/Ch4120N/ChSSHKracker.git
cd ChSSHKracker
python3 -m pip install -r requirements.txt
python3 ChSshKracker.py --help
💻 Supported Platforms
- [x] Linux (All distributions)
- [x] Windows (7, 8, 10, 11)
- [x] macOS (All versions)
✨ Features
🎯 Core Capabilities
- 🚀 High Performance: Multi-threaded architecture with configurable worker pools
- 🔄 Concurrent Processing: Multiple concurrent connections per worker for maximum throughput
- 📊 Real-time Statistics: Live progress tracking with detailed statistics
- 🎨 Beautiful UI: Colorful terminal interface with ASCII banners and formatted tables
- 📝 Comprehensive Logging: Detailed logs for successful connections, honeypots, and errors
🛡️ Security Features
- 🍯 Advanced Honeypot Detection: Multi-layer detection system to identify honeypot traps
- 🔍 System Reconnaissance: Automatic system information gathering after successful connection
- ⏱️ Configurable Timeouts: Customizable connection timeouts to optimize performance
- 🛑 Graceful Shutdown: Clean interruption handling with SIGINT support
🎮 User Experience
- 💬 Interactive Mode: User-friendly interactive prompts for easy configuration
- 📁 Flexible Input: Support for combo files or separate username/password lists
- 📈 Progress Tracking: Real-time progress bars and statistics display
💻 Usage
Quick Start
# Interactive mode (recommended for beginners)
python ChSshKracker.py --interactive
# Command line mode
python ChSshKracker.py -I ips.txt -U users.txt -P passwords.txt
Command Line Mode
Basic Usage
# Using separate username and password files
python ChSshKracker.py -I ips.txt -U users.txt -P passwords.txt
# Using combo file (username:password format)
python ChSshKracker.py -I ips.txt -C combo.txt
# With custom timeout and workers
python ChSshKracker.py -I ips.txt -U users.txt -P passwords.txt -t 10 -w 50
# Advanced: Custom workers and concurrent connections per worker
python ChSshKracker.py -I ips.txt -C combo.txt -w 50 --per-worker 30 -t 10
Command Line Arguments
| Argument | Short | Description | Default |
| ----------------- | ----- | ----------------------------------------- | ---------- |
| --ip-list | -I | Path to targets file (ip[:port] per line) | Required |
| --user-list | -U | Path to usernames file (one per line) | Required* |
| --password-list | -P | Path to passwords file (one per line) | Required* |
| --combo-list | -C | Generated combo file path | Optional |
| --timeout | -t | Connection timeout in seconds | 5 |
| --workers | -w | Maximum number of worker threads | 25 |
| --per-worker | | Concurrent connections per worker | 25 |
| --interactive | | Force interactive prompts | False |
| --version | -v | Show version and exit | - |
| --help | -h | Show help message | - |
* Required if not using combo file
Input File Formats
IP List (ips.txt):
192.168.1.1:22
192.168.1.2:2222
192.168.1.5:8022
Username List (users.txt):
root
admin
user
test
Password List (passwords.txt):
password
123456
admin
root
Combo File (combo.txt):
root:password
admin:admin123
user:password123
Interactive Mode
Launch the interactive mode for a guided setup:
python ChSshKracker.py --interactive
The interactive mode will prompt you for:
- IP list file path
- Username/password files or combo file
- Timeout settings
- Worker configuration
- Concurrent connections per worker
⚙️ Configuration
Default Settings
The tool uses the following default configurations (defined in core/config.py):
