https://github.com/zetxtech/cloudflyer
A Cloudflare/Turnstile captcha bypass API server.
https://github.com/zetxtech/cloudflyer
automation bypass cloudflare python turnstile
Last synced: 3 months ago
JSON representation
A Cloudflare/Turnstile captcha bypass API server.
- Host: GitHub
- URL: https://github.com/zetxtech/cloudflyer
- Owner: zetxtech
- License: gpl-3.0
- Created: 2025-04-02T20:13:25.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-04-03T08:14:36.000Z (6 months ago)
- Last Synced: 2025-04-03T08:22:26.491Z (6 months ago)
- Topics: automation, bypass, cloudflare, python, turnstile
- Language: HTML
- Homepage:
- Size: 1.51 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Cloudflyer
Cloudflyer is a Python service that helps solve various web security challenges including Cloudflare challenges, Turnstile captchas, and reCAPTCHA Invisible.
## Features
- Cloudflare challenge solver
- Turnstile captcha solver
- reCAPTCHA Invisible solver
- Proxy support (HTTP/SOCKS)
- Concurrent task processing
- RESTful API server
## Installation
```bash
pip install cloudflyer
```
## Quick Start
### Example Script
```bash
# Run example cloudflare solving with proxy
python test.py cloudflare -x socks5://127.0.0.1:1080
# Run example turnstile solving
python test.py turnstile
# Run example recaptcha invisible solving
python test.py recaptcha
```
### Solver Server
```bash
cloudflyer -K YOUR_CLIENT_KEY
```
Options:
- `-K, --clientKey`: Client API key (required)
- `-M, --maxTasks`: Maximum concurrent tasks (default: 1)
- `-P, --port`: Server listen port (default: 3000)
- `-H, --host`: Server listen host (default: localhost)
- `-T, --timeout`: Maximum task timeout in seconds (default: 120)
### Docker
Docker:
```bash
docker run -it --rm -p 3000:3000 jackzzs/cloudflyer -K YOUR_CLIENT_KEY
```
Docker Compose:
```yaml
version: 3
services:
cloudflyer:
image: jackzzs/cloudflyer
container_name: cloudflyer
restart: unless-stopped
ports:
- 3000:3000
```
## API Endpoints for Server
### Create Task
Request:
```
POST /createTask
Content-Type: application/json
{
"clientKey": "your_client_key",
"type": "CloudflareChallenge",
"url": "https://example.com",
"userAgent": "...",
"proxy": {
"scheme": "socks5",
"host": "127.0.0.1",
"port": 1080
},
"content": false
}
```
1. Field `userAgent` and `proxy` is optional.
2. Supported task types: `CloudflareChallenge`, `Turnstile`, `RecaptchaInvisible`
3. For `Turnstile` task, `siteKey` is required.
4. For `RecaptchaInvisible` task, `siteKey` and `action` is required.
5. For `CloudflareChallenge` task, set `content` to true to get page html in `response`.
Response:
```
{
"taskId": "21dfdca6-fbf5-4313-8ffa-cfc4b8483cc7"
}
```
### Get Task Result
Request:
```
POST /getTaskResult
Content-Type: application/json
{
"clientKey": "your_client_key",
"taskId": "21dfdca6-fbf5-4313-8ffa-cfc4b8483cc7"
}
```
Response:
```
{
"status": "completed",
"result": {
"success": true,
"code": 200,
"response": {
...
},
"data": {
"type": "CloudflareChallenge",
...(input)
}
}
}
```
For `Turnstile` task:
```
"response": {
"token": "..."
}
```
For `CloudflareChallenge` tasks:
```
"response": {
"cookies": {
"cf_clearance": "..."
},
"headers": {
"User-Agent": "..."
},
"content": "..."
}
```
For `RecaptchaInvisible` tasks:
```
"response": {
"token": "..."
}
```
## WSSocks
[WSSocks](https://github.com/zetxtech/wssocks) is a socks proxy agent for intranet penetration via websocket. It can be used for connecting to the user's network.
For agent proxy:
```bash
wssocks server -r -t example_token -a -dd
```
For user side (using proxy):
```bash
wssocks client -u https://ws.zetx.tech -r -t example_token -T 1 -c example_connector_token -dd -E -x socks5://127.0.0.1:1080
```
For solver side:
```
POST /createTask
Content-Type: application/json
{
"clientKey": "your_client_key",
"type": "CloudflareChallenge",
"url": "https://example.com",
"userAgent": "...",
"wssocks": {
"url": "https://ws.zetx.tech",
"token": "example_connector_token"
}
}
```