345 líneas
8.3 KiB
Markdown
345 líneas
8.3 KiB
Markdown
# Hasher 🔐
|
|
|
|
A modern, high-performance hash search and generation tool powered by Redis and Next.js. Search for hash values to find their plaintext origins or generate hashes from any text input.
|
|
|
|
|
|
|
|
|
|
|
|
## ✨ Features
|
|
|
|
- 🔍 **Hash Lookup**: Search for MD5, SHA1, SHA256, and SHA512 hashes
|
|
- 🔑 **Hash Generation**: Generate multiple hash types from plaintext
|
|
- 💾 **Auto-Indexing**: Automatically stores searched plaintext and hashes
|
|
- 📊 **Redis Backend**: Ultra-fast in-memory storage with persistence
|
|
- 🚀 **Bulk Indexing**: Import wordlists via command-line script with resume capability
|
|
- 🎨 **Modern UI**: Beautiful, responsive interface with real-time feedback
|
|
- 📋 **Copy to Clipboard**: One-click copying of any hash value
|
|
- ⚡ **High Performance**: Lightning-fast searches with Redis indexing
|
|
|
|
## 🏗️ Architecture
|
|
|
|
```
|
|
┌─────────────┐
|
|
│ Next.js │ ← Modern React UI
|
|
│ Frontend │
|
|
└──────┬──────┘
|
|
│
|
|
↓
|
|
┌─────────────┐
|
|
│ API │ ← REST endpoints
|
|
│ Routes │
|
|
└──────┬──────┘
|
|
│
|
|
↓
|
|
┌─────────────┐
|
|
│ Redis │ ← In-memory storage
|
|
│ (Key-Value │ (localhost:6379)
|
|
│ + Hashes) │
|
|
└─────────────┘
|
|
```
|
|
|
|
## 🚀 Quick Start
|
|
|
|
### Prerequisites
|
|
|
|
- Node.js 18.x or higher
|
|
- Redis 6.x or higher running on `localhost:6379`
|
|
- npm or yarn
|
|
|
|
### Installation
|
|
|
|
1. **Clone the repository**
|
|
```bash
|
|
git clone <repository-url>
|
|
cd hasher
|
|
```
|
|
|
|
2. **Install dependencies**
|
|
```bash
|
|
npm install
|
|
```
|
|
|
|
3. **Start Redis** (if not already running)
|
|
|
|
```bash
|
|
# Using Docker
|
|
docker run -d --name redis -p 6379:6379 redis:latest
|
|
|
|
# Or using system package manager
|
|
sudo systemctl start redis
|
|
```
|
|
|
|
4. **Configure Redis** (optional)
|
|
|
|
By default, the app connects to `localhost:6379`. To change this:
|
|
|
|
```bash
|
|
export REDIS_HOST=your-redis-host
|
|
export REDIS_PORT=6379
|
|
export REDIS_PASSWORD=your-password # if authentication is enabled
|
|
export REDIS_DB=0 # database number
|
|
```
|
|
|
|
5. **Run the development server**
|
|
```bash
|
|
npm run dev
|
|
```
|
|
|
|
6. **Open your browser**
|
|
|
|
Navigate to [http://localhost:3000](http://localhost:3000)
|
|
|
|
## 📖 Usage
|
|
|
|
### Web Interface
|
|
|
|
1. **Search for a Hash**
|
|
- Enter any MD5, SHA1, SHA256, or SHA512 hash
|
|
- Click search or press Enter
|
|
- View the plaintext result if found in the database
|
|
|
|
2. **Generate Hashes**
|
|
- Enter any plaintext string
|
|
- Get instant hash values for all supported algorithms
|
|
- Hashes are automatically saved for future lookups
|
|
|
|
### Bulk Indexing Script
|
|
|
|
Index large wordlists or dictionaries:
|
|
|
|
```bash
|
|
# Basic usage
|
|
npm run index-file wordlist.txt
|
|
|
|
# With custom batch size
|
|
npm run index-file wordlist.txt -- --batch-size 500
|
|
|
|
# Skip duplicate checking (faster)
|
|
npm run index-file wordlist.txt -- --no-check
|
|
|
|
# Resume interrupted indexing
|
|
npm run index-file wordlist.txt -- --resume
|
|
|
|
# Show help
|
|
npm run index-file -- --help
|
|
```
|
|
|
|
**Input file format**: One word/phrase per line
|
|
```text
|
|
password
|
|
admin
|
|
123456
|
|
qwerty
|
|
```
|
|
|
|
**Script features**:
|
|
- ✅ Bulk indexing with configurable batch size
|
|
- ✅ Progress indicator and real-time stats
|
|
- ✅ State persistence with resume capability
|
|
- ✅ Optional duplicate checking
|
|
- ✅ Error handling and reporting
|
|
- ✅ Performance metrics (docs/sec)
|
|
|
|
## 🔌 API Reference
|
|
|
|
### Search Endpoint
|
|
|
|
**POST** `/api/search`
|
|
|
|
Search for a hash or generate hashes from plaintext.
|
|
|
|
**Request Body**:
|
|
```json
|
|
{
|
|
"query": "5f4dcc3b5aa765d61d8327deb882cf99"
|
|
}
|
|
```
|
|
|
|
**Response (Hash Found)**:
|
|
```json
|
|
{
|
|
"found": true,
|
|
"hashType": "md5",
|
|
"hash": "5f4dcc3b5aa765d61d8327deb882cf99",
|
|
"results": [{
|
|
"plaintext": "password",
|
|
"hashes": {
|
|
"md5": "5f4dcc3b5aa765d61d8327deb882cf99",
|
|
"sha1": "5baa61e4c9b93f3f0682250b6cf8331b7ee68fd8",
|
|
"sha256": "5e884898da28047151d0e56f8dc6292773603d0d6aabbdd62a11ef721d1542d8",
|
|
"sha512": "b109f3bbbc244eb82441917ed06d618b9008dd09b3befd1b5e07394c706a8bb980b1d7785e5976ec049b46df5f1326af5a2ea6d103fd07c95385ffab0cacbc86"
|
|
}
|
|
}]
|
|
}
|
|
```
|
|
|
|
**Response (Plaintext Input)**:
|
|
```json
|
|
{
|
|
"found": true,
|
|
"isPlaintext": true,
|
|
"plaintext": "password",
|
|
"hashes": {
|
|
"md5": "5f4dcc3b5aa765d61d8327deb882cf99",
|
|
"sha1": "5baa61e4c9b93f3f0682250b6cf8331b7ee68fd8",
|
|
"sha256": "5e884898da28047151d0e56f8dc6292773603d0d6aabbdd62a11ef721d1542d8",
|
|
"sha512": "b109f3bbbc244eb82441917ed06d618b9008dd09b3befd1b5e07394c706a8bb980b1d7785e5976ec049b46df5f1326af5a2ea6d103fd07c95385ffab0cacbc86"
|
|
}
|
|
}
|
|
```
|
|
|
|
### Health Check Endpoint
|
|
|
|
**GET** `/api/health`
|
|
|
|
Check Redis connection and index status.
|
|
|
|
**Response**:
|
|
```json
|
|
{
|
|
"status": "ok",
|
|
"redis": {
|
|
"connected": true,
|
|
"version": "7.0.15",
|
|
"usedMemory": 2097152,
|
|
"dbSize": 1542
|
|
},
|
|
"index": {
|
|
"exists": true,
|
|
"name": "hasher",
|
|
"stats": {
|
|
"documentCount": 1542,
|
|
"indexSize": 524288
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
## 🗄️ Redis Data Structure
|
|
|
|
### Key Structure
|
|
|
|
**Main Documents**: `hash:plaintext:{plaintext}`
|
|
- Stores complete hash document as JSON string
|
|
- Contains all hash algorithms and metadata
|
|
|
|
**Hash Indexes**: `hash:index:{algorithm}:{hash}`
|
|
- Reverse lookup from hash to plaintext
|
|
- One key per algorithm (md5, sha1, sha256, sha512)
|
|
- Value is the plaintext string
|
|
|
|
**Statistics**: `hash:stats` (Redis Hash)
|
|
- `count`: Total number of unique plaintexts
|
|
- `size`: Approximate total size in bytes
|
|
|
|
### Document Schema
|
|
|
|
```typescript
|
|
{
|
|
"plaintext": string,
|
|
"md5": string,
|
|
"sha1": string,
|
|
"sha256": string,
|
|
"sha512": string,
|
|
"created_at": string (ISO 8601)
|
|
}
|
|
```
|
|
|
|
## 📁 Project Structure
|
|
|
|
```
|
|
hasher/
|
|
├── app/
|
|
│ ├── api/
|
|
│ │ ├── search/
|
|
│ │ │ └── route.ts # Search endpoint
|
|
│ │ └── health/
|
|
│ │ └── route.ts # Health check endpoint
|
|
│ ├── layout.tsx # Root layout
|
|
│ ├── page.tsx # Main UI component
|
|
│ └── globals.css # Global styles
|
|
├── lib/
|
|
│ ├── redis.ts # Redis client & data layer
|
|
│ └── hash.ts # Hash utilities
|
|
├── scripts/
|
|
│ ├── index-file.ts # Bulk indexing script
|
|
│ └── remove-duplicates.ts # Duplicate removal utility
|
|
├── package.json
|
|
├── tsconfig.json
|
|
├── next.config.ts
|
|
└── README.md
|
|
```
|
|
|
|
## 🛠️ Development
|
|
|
|
### Build for Production
|
|
|
|
```bash
|
|
npm run build
|
|
npm run start
|
|
```
|
|
|
|
### Environment Variables
|
|
|
|
Create a `.env.local` file:
|
|
|
|
```env
|
|
REDIS_HOST=localhost
|
|
REDIS_PORT=6379
|
|
REDIS_PASSWORD=your-password
|
|
REDIS_DB=0
|
|
```
|
|
|
|
### Linting
|
|
|
|
```bash
|
|
npm run lint
|
|
```
|
|
|
|
## 🔒 Supported Hash Algorithms
|
|
|
|
| Algorithm | Length (hex) | Detection Pattern |
|
|
|-----------|--------------|-------------------|
|
|
| MD5 | 32 | `^[a-f0-9]{32}$` |
|
|
| SHA1 | 40 | `^[a-f0-9]{40}$` |
|
|
| SHA256 | 64 | `^[a-f0-9]{64}$` |
|
|
| SHA512 | 128 | `^[a-f0-9]{128}$` |
|
|
|
|
## 🚀 Performance
|
|
|
|
- **Bulk Indexing**: ~1000-5000 docs/sec (depending on hardware)
|
|
- **Search Latency**: <50ms (typical)
|
|
- **Horizontal Scaling**: 10 shards for parallel processing
|
|
- **Auto-refresh**: Instant search availability for new documents
|
|
|
|
## 🤝 Contributing
|
|
|
|
Contributions are welcome! Please feel free to submit a Pull Request.
|
|
|
|
1. Fork the repository
|
|
2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
|
|
3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
|
|
4. Push to the branch (`git push origin feature/AmazingFeature`)
|
|
5. Open a Pull Request
|
|
|
|
## 📝 License
|
|
|
|
This project is open source and available under the [MIT License](LICENSE).
|
|
|
|
## 🙏 Acknowledgments
|
|
|
|
- Built with [Next.js](https://nextjs.org/)
|
|
- Powered by [Redis](https://redis.io/)
|
|
- Icons by [Lucide](https://lucide.dev/)
|
|
- Styled with [Tailwind CSS](https://tailwindcss.com/)
|
|
|
|
## 📧 Support
|
|
|
|
For issues, questions, or contributions, please open an issue on GitHub.
|
|
|
|
---
|
|
|
|
**Made with ❤️ for the security and development community**
|
|
|