Files
cf-bypass-fast/README.md
2025-09-23 12:42:47 +05:30

180 lines
4.1 KiB
Markdown

# cloudflare bypass with super fast speed 🚀🚀
A Node.js service that automates Chromium to bypass **Cloudflare IUAM** and **Turnstile challenges**, returning valid `cf_clearance` cookies or tokens with proxy support.
## 🚀 Features
- **Cloudflare IUAM Bypass**: Automatically solves "I'm Under Attack Mode" challenges super fast within 3.337 seconds 💖
- **Turnstile Challenge Solver**: Handles Cloudflare Turnstile captchas
- **Proxy Support**: Full HTTP proxy integration with authentication
- **Smart Timeout**: 20-second timeout with graceful null responses
- **Browser Management**: Concurrent browser limit control
- **Caching System**: 5-minute TTL cache for IUAM responses
- **Production Ready**: Built with Express.js and error handling
## 📦 Installation
### VPS Installation (Ubuntu/Debian)
```bash
# Update system
sudo apt update && sudo apt upgrade -y
# Install Node.js
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs
# Install Chrome
sudo apt install -y google-chrome-stable
# Install Xvfb for headless display
sudo apt install -y xvfb
# Clone and setup
git clone <repository-url>
cd cf-bypass
npm install
# Start Xvfb (virtual display)
Xvfb :99 -screen 0 1024x768x24 > /dev/null 2>&1 &
export DISPLAY=:99
# Run with PM2 (recommended)
npm install -g pm2
pm2 start index.js --name "cf-bypass"
pm2 startup
pm2 save
# Or run directly
npm start
```
### VPS Installation (Ubuntu/Debian)
```bash
# Update system
sudo apt update && sudo apt upgrade -y
# Install Node.js 18+
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs
# Clone and setup
git clone <repository-url>
cd cf-bypass
npm install
# Run with PM2 (recommended)
npm install -g pm2
pm2 start index.js --name "cf-bypass"
pm2 startup
pm2 save
# Or run directly
npm start
```
### Local Development
```bash
npm install
npm run dev # Development mode
npm start # Production mode
```
## 🔧 Environment Variables
| Variable | Default | Description |
|----------|---------|-------------|
| `PORT` | `8080` | Server port |
| `authToken` | `null` | API authentication token |
| `browserLimit` | `20` | Max concurrent browsers |
| `timeOut` | `60000` | Global timeout (ms) |
## 📡 API Endpoints
### POST /cloudflare
Bypass Cloudflare protection and get cookies/tokens.
#### Request Body
```json
{
"mode": "iuam",
"domain": "https://olamovies.watch/generate",
}
```
#### Parameters
- **`mode`** (required): `"iuam"` or `"turnstile"`
- **`domain`** (required): Target website URL
- **`proxy`** (optional): Proxy configuration object
#### Response (Success)
```json
{
"cf_clearance": "eNm9UOgqoNDTP.fmAK9JfvirEmLVpmd.ZWIfdqQxuTc-1758610092-1.2-2NwZwW6nK23HrAH71MtvOek9vCiiS7pUBGIPtra_gSBxYxY2csa6hW0j7i...",
"user_agent": "Mozilla/5.0...",
"elapsed_time": 3.05
}
```
#### Response (No Cookie Found)
```json
{
"cf_clearance": null,
"user_agent": "Mozilla/5.0...",
"elapsed_time": 0.0
}
```
#### Response (Turnstile)
```json
{
"token": "0.xsFjuaQe-ahOJOCPBca6_gO_PYmF6LRrkxMX7s9XY6hdkCydEQocV3IlhGNgxa-X9KGS1lPoWScPSAPsUieuG-gyAazbguBUogGpqX9Ft..."
}
```
## 🌐 Proxy Configuration
The service supports HTTP proxies with authentication:
**Proxy Format**: `username:password@hostname:port`
## 📝 Usage Examples
### run test
```bash
python api_test.py
```
## ⚡ Key Features
### Caching System
- **5-minute TTL** for IUAM responses
- Reduces server load and response time
- Cache key based on request parameters
### Browser Management
- Configurable concurrent browser limit
- Resource optimization (blocks images, CSS, fonts)
## 🛠 Development
### Project Structure
```
cf-bypass/
├── endpoints/
│ ├── cloudflare.js # IUAM bypass logic
│ └── turnstile.js # Turnstile solver
├── cache/
│ └── cache.json # Response cache
├── index.js # Main server
├── api_test.py # Test script
└── package.json
```
[credit](https://github.com/ZFC-Digital/cf-clearance-scraper)
educational / research — use responsibly and lawfully.
my telegram: https://t.me/rex_update
---
Made with ❤️ for bypass community