Upload 11 files

.dockerignore

@@ -0,0 +1,45 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+venv/
+env/
+ENV/
+.venv
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# Git
+.git/
+.gitignore
+
+# Docker
+Dockerfile
+.dockerignore
+
+# Documentation
+README.md
+*.md
+
+# Logs
+*.log
+
+# Database
+*.db
+*.sqlite
+*.sqlite3
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Temporary files
+*.tmp
+*.temp

DEPLOY_HF.md

@@ -0,0 +1,196 @@
+# Hugging Face Spaces 部署指南
+
+本指南将帮助您将 Turnstile Solver 部署到 Hugging Face Spaces。
+
+## 📋 前提条件
+
+1. 拥有 Hugging Face 账号
+2. 已安装 Git
+
+## 🚀 部署步骤
+
+### 1. 创建新的 Space
+
+1. 访问 [Hugging Face Spaces](https://huggingface.co/spaces)
+2. 点击 "Create new Space"
+3. 填写以下信息：
+   - **Space name**: 您的项目名称（例如：turnstile-solver）
+   - **License**: MIT
+   - **Select the Space SDK**: Docker
+   - **Space hardware**: CPU basic（免费）或更高配置
+4. 点击 "Create Space"
+
+### 2. 准备文件
+
+确保您的项目包含以下文件：
+
+```
+.
+├── Dockerfile              # Docker 配置文件
+├── api_solver.py          # 主程序文件
+├── browser_configs.py     # 浏览器配置
+├── db_results.py          # 数据库操作
+├── requirements.txt       # Python 依赖
+├── proxies.txt           # 代理列表（可选）
+└── README_HF.md          # HF Spaces 说明文档（重命名为 README.md）
+```
+
+### 3. 上传到 Hugging Face
+
+#### 方法 A: 使用 Git（推荐）
+
+```bash
+# 克隆您的 Space 仓库
+git clone https://huggingface.co/spaces/YOUR_USERNAME/YOUR_SPACE_NAME
+cd YOUR_SPACE_NAME
+
+# 复制项目文件到仓库
+cp /path/to/your/project/* .
+
+# 重命名 README_HF.md 为 README.md
+mv README_HF.md README.md
+
+# 提交并推送
+git add .
+git commit -m "Initial deployment"
+git push
+```
+
+#### 方法 B: 使用 Web 界面
+
+1. 在 Space 页面点击 "Files and versions"
+2. 点击 "Add file" > "Upload files"
+3. 上传所有必需的文件
+4. 确保将 `README_HF.md` 重命名为 `README.md`
+
+### 4. 配置 Space
+
+在 Space 的设置中：
+
+1. **Hardware**: 
+   - 免费版：CPU basic（2 vCPU, 16GB RAM）
+   - 推荐：CPU upgrade（8 vCPU, 32GB RAM）用于更好的性能
+
+2. **Environment variables**（可选）:
+   - 如果需要，可以添加环境变量
+
+### 5. 等待部署
+
+- Space 会自动构建 Docker 镜像
+- 首次构建可能需要 5-10 分钟
+- 构建完成后，服务会自动启动
+- 浏览器池初始化需要额外 30-60 秒
+
+### 6. 验证部署
+
+部署完成后，访问以下端点验证：
+
+```bash
+# 健康检查
+curl https://YOUR_USERNAME-YOUR_SPACE_NAME.hf.space/health
+
+# 就绪检查
+curl https://YOUR_USERNAME-YOUR_SPACE_NAME.hf.space/ready
+
+# 主页
+https://YOUR_USERNAME-YOUR_SPACE_NAME.hf.space/
+```
+
+## 🔧 配置选项
+
+### 修改浏览器线程数
+
+在 `Dockerfile` 中修改启动命令：
+
+```dockerfile
+CMD ["python", "api_solver.py", "--host", "0.0.0.0", "--port", "7860", "--thread", "8"]
+```
+
+### 启用代理支持
+
+1. 在 `proxies.txt` 中添加代理
+2. 修改 `Dockerfile` 启动命令：
+
+```dockerfile
+CMD ["python", "api_solver.py", "--host", "0.0.0.0", "--port", "7860", "--proxy", "--random"]
+```
+
+### 启用调试模式
+
+```dockerfile
+CMD ["python", "api_solver.py", "--host", "0.0.0.0", "--port", "7860", "--debug"]
+```
+
+## 📊 监控和日志
+
+### 查看日志
+
+1. 在 Space 页面点击 "Logs"
+2. 查看实时日志输出
+3. 检查浏览器初始化状态
+
+### 常见日志消息
+
+- `"Application startup completed, browser initialization in progress..."` - 服务已启动，浏览器正在初始化
+- `"Browser pool initialized and ready to accept requests"` - 服务完全就绪
+- `"Successfully solved captcha"` - 成功解决验证码
+
+## ⚠️ 注意事项
+
+1. **启动时间**: 
+   - 服务启动后需要 30-60 秒初始化浏览器池
+   - 在此期间，API 请求会返回 503 错误
+   - 使用 `/ready` 端点检查就绪状态
+
+2. **资源限制**:
+   - 免费版 CPU 可能导致性能较慢
+   - 建议使用 CPU upgrade 以获得更好性能
+
+3. **超时设置**:
+   - HF Spaces 有 60 秒的请求超时限制
+   - 确保验证码求解在此时间内完成
+
+4. **持久化存储**:
+   - Space 重启后数据会丢失
+   - 数据库结果仅在运行期间保存
+
+## 🐛 故障排除
+
+### Space 一直处于 "Starting" 状态
+
+**原因**: 服务未能在规定时间内响应健康检查
+
+**解决方案**:
+1. 检查 Dockerfile 是否正确暴露端口 7860
+2. 确保 `api_solver.py` 监听 0.0.0.0:7860
+3. 查看日志确认是否有错误
+
+### 浏览器初始化失败
+
+**原因**: 系统依赖缺失或资源不足
+
+**解决方案**:
+1. 检查 Dockerfile 中的系统依赖是否完整
+2. 升级到更高配置的硬件
+3. 减少线程数（`--thread 2`）
+
+### API 返回 503 错误
+
+**原因**: 浏览器池尚未初始化完成
+
+**解决方案**:
+1. 等待 30-60 秒后重试
+2. 使用 `/ready` 端点检查就绪状态
+3. 查看日志确认初始化进度
+
+## 📞 获取帮助
+
+如果遇到问题，请访问：
+
+- 📢 **Telegram 频道**: [https://t.me/D3_vin](https://t.me/D3_vin)
+- 💬 **Telegram 聊天**: [https://t.me/D3vin_chat](https://t.me/D3vin_chat)
+- 📁 **GitHub Issues**: [https://github.com/D3-vin](https://github.com/D3-vin)
+
+## 📄 许可证
+
+本项目仅供教育用途。使用风险自负。

Dockerfile

@@ -52,8 +52,8 @@ COPY . .
 # 创建 proxies.txt 文件（如果不存在）
 RUN touch proxies.txt
 
-# 暴露 API 端口
-EXPOSE 6080
+# 暴露 API 端口（Hugging Face Spaces 使用 7860）
+EXPOSE 7860
 
-# 设置启动命令
-CMD ["python", "api_solver.py", "--host", "0.0.0.0", "--port", "6080"]
+# 设置启动命令（使用 HF Spaces 标准端口 7860）
+CMD ["python", "api_solver.py", "--host", "0.0.0.0", "--port", "7860"]

README.md

@@ -1,267 +1,99 @@
----
-title: G3 E
-emoji: 📉
-colorFrom: yellow
-colorTo: purple
-sdk: docker
-pinned: false
----
-
-
-# Cloudflare - Turnstile Solver NEW
-
-## 📢 Connect with Us
-
-- **📢 Channel**: [https://t.me/D3_vin](https://t.me/D3_vin) - Latest updates and releases
-- **💬 Chat**: [https://t.me/D3vin_chat](https://t.me/D3vin_chat) - Community support and discussions
-- **📁 GitHub**: [https://github.com/D3-vin](https://github.com/D3-vin) - Source code and development
-
-![Python](https://img.shields.io/badge/Python-3.6+-blue)
-![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey)
-![License](https://img.shields.io/badge/License-Educational%20Use-green)
-
-
-❤️ Support the Project
-If you find this collection valuable and appreciate the effort involved in obtaining and sharing these insights, please consider supporting the project. Your contribution helps keep this resource updated and allows for further exploration.
-
-You can show your support via:
-
-Cryptocurrency:
-- **EVM:** 0xeba21af63e707ce84b76a87d0ba82140048c057e  (ETH,BNB,etc)
-- **TRON:** TEfECnyz5G1EkFrUqnbFcWLVdLvAgW9Raa
-- **TON:** UQCJ7KC2zxV_zKwLahaHf9jxy0vsWRcvQFie_FUBJW-9LcEW
-- **BTC:** bc1qdag98y5yahs6wf7rsfeh4cadsjfzmn5ngpjrcf
-- **SOL:** EwXXR4VqmWSNz1sjhZ8qcQ882i4URwAwhixSPEbDzyv6
-- **SUI:** 0x76da9b74c61508fbbd0b3e1989446e036b0622f252dd8d07c3fce759b239b47d
-
-
-🙏 Thank you for your support!
-
-A Python-based Turnstile solver using the patchright and camoufox libraries, featuring multi-threaded execution, API integration, and support for different browsers. It solves CAPTCHAs quickly and efficiently, with customizable configurations and detailed logging.
-
-## 🚀 Features
-
-- **Multi-threaded execution** - Solve multiple CAPTCHAs simultaneously
-- **Multiple browser support** - Chromium, Chrome, Edge, and Camoufox
-- **Proxy support** - Use proxies from proxies.txt file
-- **Random browser configurations** - Rotate User-Agent and Sec-CH-UA headers
-- **Detailed logging** - Comprehensive debug information
-- **REST API** - Easy integration with other applications
-- **Database storage** - SQLite database for result persistence
-- **Automatic cleanup** - Old results are automatically cleaned up
-- **Image blocking** - Optimized performance by blocking unnecessary images
-
-## 🔧 Configuration
-
-### Browser Configurations
-
-The solver supports various browser configurations with realistic User-Agent strings and Sec-CH-UA headers:
-
-- **Chrome** (versions 136-139)
-- **Edge** (versions 137-139)
-- **Avast** (versions 137-138)
-- **Brave** (versions 137-139)
-
-### Proxy Format
-
-Add proxies to `proxies.txt` in the following formats:
-
-```
-ip:port
-ip:port:username:password
-scheme://ip:port
-scheme://username:password@ip:port
-```
-
-## ❗ Disclaimers
-
-I am not responsible for anything that may happen, such as API Blocking, IP ban, etc.  
-This was a quick project that was made for fun and personal use if you want to see further updates, star the repo & create an "issue" here
-
-## ⚙️ Installation Instructions
-
-Ensure Python 3.8+ is installed on your system.
-
-### 1. Create a Python virtual environment:
-
-```bash
-python -m venv venv
-```
-
-### 2. Activate the virtual environment:
-
-**On Windows:**
-```bash
-venv\Scripts\activate
-```
-
-**On macOS/Linux:**
-```bash
-source venv/bin/activate
-```
-
-### 3. Install required dependencies:
-
-```bash
-pip install -r requirements.txt
-```
-
-### 4. Select the browser to install:
-
-You can choose between Chromium, Chrome, Edge or Camoufox:
-
-**To install Chromium:**
-```bash
-python -m patchright install chromium
-```
-
-**To install Chrome:**
-- **On macOS/Windows:** [Click here](https://www.google.com/chrome/)
-- **On Linux (Debian/Ubuntu-based):**
-```bash
-apt update
-wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
-apt install -y ./google-chrome-stable_current_amd64.deb
-apt -f install -y  # Fix dependencies if needed
-rm ./google-chrome-stable_current_amd64.deb
-```
-
-**To install Edge:**
-```bash
-python -m patchright install msedge
-```
-
-**To install Camoufox:**
-```bash
-python -m camoufox fetch
-```
-
-### 5. Start testing:
-
-Run the script (Check [🔧 Command line arguments](#-command-line-arguments) for better setup):
-
-```bash
-python api_solver.py
-```
-
-## 🔧 Command line arguments
-
-| Parameter | Default | Type | Description |
-|-----------|---------|------|-------------|
-| `--no-headless` | False | boolean | Runs the browser with GUI (disable headless mode). By default, headless mode is enabled. |
-| `--useragent` | None | string | Specifies a custom User-Agent string for the browser. (No need to set if camoufox used) |
-| `--debug` | False | boolean | Enables or disables debug mode for additional logging and troubleshooting. |
-| `--browser_type` | chromium | string | Specify the browser type for the solver. Supported options: chromium, chrome, msedge, camoufox |
-| `--thread` | 4 | integer | Sets the number of browser threads to use in multi-threaded mode. |
-| `--host` | 0.0.0.0 | string | Specifies the IP address the API solver runs on. |
-| `--port` | 6080 | integer | Sets the port the API solver listens on. |
-| `--proxy` | False | boolean | Select a random proxy from proxies.txt for solving captchas |
-| `--random` | False | boolean | Use random User-Agent and Sec-CH-UA configuration from pool |
-| `--browser` | None | string | Specify browser name to use (e.g., chrome, firefox) |
-| `--version` | None | string | Specify browser version to use (e.g., 139, 141) |
-
-## 📡 API Documentation
-
-### Solve turnstile
-
-```
-GET /turnstile?url=https://example.com&sitekey=0x4AAAAAAA
-```
-
-**Request Parameters:**
-
-| Parameter | Type | Description | Required |
-|-----------|------|-------------|----------|
-| `url` | string | The target URL containing the CAPTCHA. (e.g., https://example.com) | Yes |
-| `sitekey` | string | The site key for the CAPTCHA to be solved. (e.g., 0x4AAAAAAA) | Yes |
-| `action` | string | Action to trigger during CAPTCHA solving, e.g., login | No |
-| `cdata` | string | Custom data that can be used for additional CAPTCHA parameters. | No |
-
-**Response:**
-
-If the request is successfully received, the server will respond with a task_id for the CAPTCHA solving task:
-
-```json
-{
-  "task_id": "d2cbb257-9c37-4f9c-9bc7-1eaee72d96a8"
-}
-```
-
-### Get Result
-
-```
-GET /result?id=f0dbe75b-fa76-41ad-89aa-4d3a392040af
-```
-
-**Request Parameters:**
-
-| Parameter | Type | Description | Required |
-|-----------|------|-------------|----------|
-| `id` | string | The unique task ID returned from the /turnstile request. | Yes |
-
-**Response:**
-
-If the CAPTCHA is solved successfully, the server will respond with the following information:
-
-```json
-{
-  "status": "ready",
-  "value": "0.KBtT-r",
-  "elapsed_time": 7.625
-}
-```
-
-**Error Responses:**
-
-```json
-{
-  "status": "processing"
-}
-```
-
-```json
-{
-  "status": "fail",
-  "value": "CAPTCHA_FAIL",
-  "elapsed_time": 30.0
-}
-```
-
-
-
-## 🐛 Troubleshooting
-
-### Common Issues
-
-1. **Browser not found**: Make sure you've installed the required browser using the installation instructions
-2. **Permission denied**: Run with appropriate permissions or check file permissions
-3. **Port already in use**: Change the port using `--port` argument
-4. **Proxy connection failed**: Check proxy format and availability
-
-### Debug Mode
-
-Enable debug mode for detailed logging:
-
-```bash
-python api_solver.py --debug
-```
-
-## 📊 Performance
-
-- **Average solving time**: 5-15 seconds
-- **Success rate**: 95%+ (depending on site complexity)
-- **Memory usage**: ~50-100MB per browser thread
-- **CPU usage**: Moderate (depends on thread count)
-
-## 🤝 Contributing
-
-1. Fork the repository
-2. Create a feature branch
-3. Make your changes
-4. Add tests if applicable
-5. Submit a pull request
-
-## 📄 License
-
-This project is for educational purposes only. Use at your own risk.
-
+---
+title: Turnstile Solver API
+emoji: 🔓
+colorFrom: red
+colorTo: blue
+sdk: docker
+pinned: false
+license: mit
+---
+
+# Cloudflare Turnstile Solver API
+
+这是一个基于 Python 的 Cloudflare Turnstile 验证码求解器 API 服务。
+
+## 🚀 特性
+
+- **多线程执行** - 同时解决多个验证码
+- **多浏览器支持** - Chromium, Chrome, Edge 和 Camoufox
+- **代理支持** - 使用 proxies.txt 文件中的代理
+- **REST API** - 易于与其他应用程序集成
+- **健康检查** - 提供 `/health` 和 `/ready` 端点
+
+## 📡 API 使用方法
+
+### 健康检查
+```
+GET /health
+```
+返回服务健康状态
+
+### 就绪检查
+```
+GET /ready
+```
+检查浏览器池是否已初始化完成
+
+### 求解 Turnstile
+```
+GET /turnstile?url=https://example.com&sitekey=0x4AAAAAAA
+```
+
+**请求参数:**
+
+| 参数 | 类型 | 描述 | 必需 |
+|------|------|------|------|
+| `url` | string | 包含验证码的目标 URL | 是 |
+| `sitekey` | string | 验证码的 site key | 是 |
+| `action` | string | 验证码触发的动作 | 否 |
+| `cdata` | string | 自定义数据 | 否 |
+
+**响应:**
+
+```json
+{
+  "errorId": 0,
+  "taskId": "d2cbb257-9c37-4f9c-9bc7-1eaee72d96a8"
+}
+```
+
+### 获取结果
+```
+GET /result?id=f0dbe75b-fa76-41ad-89aa-4d3a392040af
+```
+
+**响应 (成功):**
+
+```json
+{
+  "errorId": 0,
+  "status": "ready",
+  "solution": {
+    "token": "0.KBtT-r..."
+  }
+}
+```
+
+**响应 (处理中):**
+
+```json
+{
+  "status": "processing"
+}
+```
+
+## ⚠️ 注意事项
+
+- 服务启动后需要等待浏览器池初始化（约 30-60 秒）
+- 在浏览器池就绪前，请求会返回 503 错误
+- 可以通过 `/ready` 端点检查服务是否就绪
+
+## 📞 联系方式
+
+- 📢 **频道**: [https://t.me/D3_vin](https://t.me/D3_vin)
+- 💬 **聊天**: [https://t.me/D3vin_chat](https://t.me/D3vin_chat)
+- 📁 **GitHub**: [https://github.com/D3-vin](https://github.com/D3-vin)
+
+## 📄 许可证
+
+本项目仅供教育用途。使用��险自负。

README_bak.md

@@ -0,0 +1,257 @@
+# Cloudflare - Turnstile Solver NEW
+
+## 📢 Connect with Us
+
+- **📢 Channel**: [https://t.me/D3_vin](https://t.me/D3_vin) - Latest updates and releases
+- **💬 Chat**: [https://t.me/D3vin_chat](https://t.me/D3vin_chat) - Community support and discussions
+- **📁 GitHub**: [https://github.com/D3-vin](https://github.com/D3-vin) - Source code and development
+
+![Python](https://img.shields.io/badge/Python-3.6+-blue)
+![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey)
+![License](https://img.shields.io/badge/License-Educational%20Use-green)
+
+
+❤️ Support the Project
+If you find this collection valuable and appreciate the effort involved in obtaining and sharing these insights, please consider supporting the project. Your contribution helps keep this resource updated and allows for further exploration.
+
+You can show your support via:
+
+Cryptocurrency:
+- **EVM:** 0xeba21af63e707ce84b76a87d0ba82140048c057e  (ETH,BNB,etc)
+- **TRON:** TEfECnyz5G1EkFrUqnbFcWLVdLvAgW9Raa
+- **TON:** UQCJ7KC2zxV_zKwLahaHf9jxy0vsWRcvQFie_FUBJW-9LcEW
+- **BTC:** bc1qdag98y5yahs6wf7rsfeh4cadsjfzmn5ngpjrcf
+- **SOL:** EwXXR4VqmWSNz1sjhZ8qcQ882i4URwAwhixSPEbDzyv6
+- **SUI:** 0x76da9b74c61508fbbd0b3e1989446e036b0622f252dd8d07c3fce759b239b47d
+
+
+🙏 Thank you for your support!
+
+A Python-based Turnstile solver using the patchright and camoufox libraries, featuring multi-threaded execution, API integration, and support for different browsers. It solves CAPTCHAs quickly and efficiently, with customizable configurations and detailed logging.
+
+## 🚀 Features
+
+- **Multi-threaded execution** - Solve multiple CAPTCHAs simultaneously
+- **Multiple browser support** - Chromium, Chrome, Edge, and Camoufox
+- **Proxy support** - Use proxies from proxies.txt file
+- **Random browser configurations** - Rotate User-Agent and Sec-CH-UA headers
+- **Detailed logging** - Comprehensive debug information
+- **REST API** - Easy integration with other applications
+- **Database storage** - SQLite database for result persistence
+- **Automatic cleanup** - Old results are automatically cleaned up
+- **Image blocking** - Optimized performance by blocking unnecessary images
+
+## 🔧 Configuration
+
+### Browser Configurations
+
+The solver supports various browser configurations with realistic User-Agent strings and Sec-CH-UA headers:
+
+- **Chrome** (versions 136-139)
+- **Edge** (versions 137-139)
+- **Avast** (versions 137-138)
+- **Brave** (versions 137-139)
+
+### Proxy Format
+
+Add proxies to `proxies.txt` in the following formats:
+
+```
+ip:port
+ip:port:username:password
+scheme://ip:port
+scheme://username:password@ip:port
+```
+
+## ❗ Disclaimers
+
+I am not responsible for anything that may happen, such as API Blocking, IP ban, etc.  
+This was a quick project that was made for fun and personal use if you want to see further updates, star the repo & create an "issue" here
+
+## ⚙️ Installation Instructions
+
+Ensure Python 3.8+ is installed on your system.
+
+### 1. Create a Python virtual environment:
+
+```bash
+python -m venv venv
+```
+
+### 2. Activate the virtual environment:
+
+**On Windows:**
+```bash
+venv\Scripts\activate
+```
+
+**On macOS/Linux:**
+```bash
+source venv/bin/activate
+```
+
+### 3. Install required dependencies:
+
+```bash
+pip install -r requirements.txt
+```
+
+### 4. Select the browser to install:
+
+You can choose between Chromium, Chrome, Edge or Camoufox:
+
+**To install Chromium:**
+```bash
+python -m patchright install chromium
+```
+
+**To install Chrome:**
+- **On macOS/Windows:** [Click here](https://www.google.com/chrome/)
+- **On Linux (Debian/Ubuntu-based):**
+```bash
+apt update
+wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
+apt install -y ./google-chrome-stable_current_amd64.deb
+apt -f install -y  # Fix dependencies if needed
+rm ./google-chrome-stable_current_amd64.deb
+```
+
+**To install Edge:**
+```bash
+python -m patchright install msedge
+```
+
+**To install Camoufox:**
+```bash
+python -m camoufox fetch
+```
+
+### 5. Start testing:
+
+Run the script (Check [🔧 Command line arguments](#-command-line-arguments) for better setup):
+
+```bash
+python api_solver.py
+```
+
+## 🔧 Command line arguments
+
+| Parameter | Default | Type | Description |
+|-----------|---------|------|-------------|
+| `--no-headless` | False | boolean | Runs the browser with GUI (disable headless mode). By default, headless mode is enabled. |
+| `--useragent` | None | string | Specifies a custom User-Agent string for the browser. (No need to set if camoufox used) |
+| `--debug` | False | boolean | Enables or disables debug mode for additional logging and troubleshooting. |
+| `--browser_type` | chromium | string | Specify the browser type for the solver. Supported options: chromium, chrome, msedge, camoufox |
+| `--thread` | 4 | integer | Sets the number of browser threads to use in multi-threaded mode. |
+| `--host` | 0.0.0.0 | string | Specifies the IP address the API solver runs on. |
+| `--port` | 6080 | integer | Sets the port the API solver listens on. |
+| `--proxy` | False | boolean | Select a random proxy from proxies.txt for solving captchas |
+| `--random` | False | boolean | Use random User-Agent and Sec-CH-UA configuration from pool |
+| `--browser` | None | string | Specify browser name to use (e.g., chrome, firefox) |
+| `--version` | None | string | Specify browser version to use (e.g., 139, 141) |
+
+## 📡 API Documentation
+
+### Solve turnstile
+
+```
+GET /turnstile?url=https://example.com&sitekey=0x4AAAAAAA
+```
+
+**Request Parameters:**
+
+| Parameter | Type | Description | Required |
+|-----------|------|-------------|----------|
+| `url` | string | The target URL containing the CAPTCHA. (e.g., https://example.com) | Yes |
+| `sitekey` | string | The site key for the CAPTCHA to be solved. (e.g., 0x4AAAAAAA) | Yes |
+| `action` | string | Action to trigger during CAPTCHA solving, e.g., login | No |
+| `cdata` | string | Custom data that can be used for additional CAPTCHA parameters. | No |
+
+**Response:**
+
+If the request is successfully received, the server will respond with a task_id for the CAPTCHA solving task:
+
+```json
+{
+  "task_id": "d2cbb257-9c37-4f9c-9bc7-1eaee72d96a8"
+}
+```
+
+### Get Result
+
+```
+GET /result?id=f0dbe75b-fa76-41ad-89aa-4d3a392040af
+```
+
+**Request Parameters:**
+
+| Parameter | Type | Description | Required |
+|-----------|------|-------------|----------|
+| `id` | string | The unique task ID returned from the /turnstile request. | Yes |
+
+**Response:**
+
+If the CAPTCHA is solved successfully, the server will respond with the following information:
+
+```json
+{
+  "status": "ready",
+  "value": "0.KBtT-r",
+  "elapsed_time": 7.625
+}
+```
+
+**Error Responses:**
+
+```json
+{
+  "status": "processing"
+}
+```
+
+```json
+{
+  "status": "fail",
+  "value": "CAPTCHA_FAIL",
+  "elapsed_time": 30.0
+}
+```
+
+
+
+## 🐛 Troubleshooting
+
+### Common Issues
+
+1. **Browser not found**: Make sure you've installed the required browser using the installation instructions
+2. **Permission denied**: Run with appropriate permissions or check file permissions
+3. **Port already in use**: Change the port using `--port` argument
+4. **Proxy connection failed**: Check proxy format and availability
+
+### Debug Mode
+
+Enable debug mode for detailed logging:
+
+```bash
+python api_solver.py --debug
+```
+
+## 📊 Performance
+
+- **Average solving time**: 5-15 seconds
+- **Success rate**: 95%+ (depending on site complexity)
+- **Memory usage**: ~50-100MB per browser thread
+- **CPU usage**: Moderate (depends on thread count)
+
+## 🤝 Contributing
+
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Add tests if applicable
+5. Submit a pull request
+
+## 📄 License
+
+This project is for educational purposes only. Use at your own risk.
+

api_solver.py

@@ -73,6 +73,8 @@ class TurnstileAPIServer:
         self.browser_name = browser_name
         self.browser_version = browser_version
         self.console = Console()
+        self.is_ready = False  # 添加就绪状态标志
+        self.initialization_task = None  # 初始化任务引用
         
         # Initialize useragent and sec_ch_ua attributes
         self.useragent = useragent
@@ -138,22 +140,41 @@ class TurnstileAPIServer:
         self.app.route('/turnstile', methods=['GET'])(self.process_turnstile)
         self.app.route('/result', methods=['GET'])(self.get_result)
         self.app.route('/')(self.index)
+        self.app.route('/health', methods=['GET'])(self.health_check)
+        self.app.route('/ready', methods=['GET'])(self.readiness_check)
         
 
     async def _startup(self) -> None:
-        """Initialize the browser and page pool on startup."""
+        """Initialize the application on startup."""
         self.display_welcome()
-        logger.info("Starting browser initialization")
+        logger.info("Starting application initialization")
         try:
+            # 初始化数据库（快速操作）
             await init_db()
-            await self._initialize_browser()
+            logger.info("Database initialized successfully")
+            
+            # 启动后台浏览器初始化任务（不阻塞启动）
+            self.initialization_task = asyncio.create_task(self._delayed_browser_init())
             
-            # Запускаем периодическую очистку старых результатов
+            # 启动周期性清理任务
             asyncio.create_task(self._periodic_cleanup())
             
+            logger.info("Application startup completed, browser initialization in progress...")
+            
         except Exception as e:
-            logger.error(f"Failed to initialize browser: {str(e)}")
+            logger.error(f"Failed to initialize application: {str(e)}")
             raise
+    
+    async def _delayed_browser_init(self) -> None:
+        """延迟初始化浏览器池（后台任务）"""
+        try:
+            logger.info("Starting browser initialization in background...")
+            await self._initialize_browser()
+            self.is_ready = True
+            logger.success("Browser pool initialized and ready to accept requests")
+        except Exception as e:
+            logger.error(f"Failed to initialize browser pool: {str(e)}")
+            self.is_ready = False
 
     async def _initialize_browser(self) -> None:
         """Initialize the browser and create the page pool."""
@@ -767,6 +788,14 @@ class TurnstileAPIServer:
 
     async def process_turnstile(self):
         """Handle the /turnstile endpoint requests."""
+        # 检查服务是否就绪
+        if not self.is_ready:
+            return jsonify({
+                "errorId": 1,
+                "errorCode": "ERROR_SERVICE_NOT_READY",
+                "errorDescription": "Service is still initializing, please try again in a few moments"
+            }), 503
+        
         url = request.args.get('url')
         sitekey = request.args.get('sitekey')
         action = request.args.get('action')
@@ -921,8 +950,8 @@ def parse_args():
     parser.add_argument('--random', action='store_true', help='Use random User-Agent and Sec-CH-UA configuration from pool')
     parser.add_argument('--browser', type=str, help='Specify browser name to use (e.g., chrome, firefox)')
     parser.add_argument('--version', type=str, help='Specify browser version to use (e.g., 139, 141)')
-    parser.add_argument('--host', type=str, default='0.0.0.0', help='Specify the IP address where the API solver runs. (Default: 127.0.0.1)')
-    parser.add_argument('--port', type=str, default='5072', help='Set the port for the API solver to listen on. (Default: 5072)')
+    parser.add_argument('--host', type=str, default='0.0.0.0', help='Specify the IP address where the API solver runs. (Default: 0.0.0.0)')
+    parser.add_argument('--port', type=str, default='7860', help='Set the port for the API solver to listen on. (Default: 7860 for HF Spaces)')
     return parser.parse_args()
 
 

docker-compose.yml

@@ -5,7 +5,7 @@ services:
     build: .
     container_name: turnstile-solver
     ports:
-      - "6080:6080"
+      - "7860:7860"
     volumes:
       # 挂载 proxies.txt 文件（如果需要使用代理）
       - ./proxies.txt:/app/proxies.txt
@@ -16,7 +16,7 @@ services:
     command: >
       python api_solver.py
       --host 0.0.0.0
-      --port 6080
+      --port 7860
       --thread 4
       --browser_type chromium
     restart: unless-stopped
@@ -24,7 +24,7 @@ services:
     # command: >
     #   python api_solver.py
     #   --host 0.0.0.0
-    #   --port 6080
+    #   --port 7860
     #   --thread 4
     #   --browser_type chromium
     #   --proxy