v3.15b

Author: odell0111

README.md

@@ -4,6 +4,27 @@ Python server to automatically solve Cloudflare Turnstile CAPTCHA with an averag
 
 PD: This repository was initially created for personal use. I've adjusted it for sharing, but it might still be slightly disorganized. Feel free to contribute, open issues, and request new features.
 
+---
+
+## Table of Content
+
+- [Screenshots](#screenshots)
+- [Install](#install)
+    - [Patchright](#install-patchright-patched-chrome-browser)
+- [How to use](#how-to-use)
+    - [Run server](#run-server)
+    - [Global proxy](#use-global-browser-proxy)
+    - [Proxy parameters](#load-proxy-parameters-from-environment-variables-all-caps)
+    - [Proxy file](#use-a-proxy-from-file-per-browser-context)
+- [Get Token](#get-token)
+    - [Curl](#curl)
+    - [Python](#python)
+- [Docker](./docker/README.md)
+- [Disclaimer](#disclaimer)
+- [Donate](#donate)
+
+---
+
 ## Screenshots
 
 TODO: Update
@@ -13,42 +34,58 @@ TODO: Update
 
 ![Browser](images/browser.png)
 
+---
+
 ## Install
+
 ```bash
 pip install git+https://github.com/odell0111/turnstile_solver@main
 ```
-### Install Patchright patched chromium browser
+
+### Install Patchright patched chrome browser
+
 ```bash
-patchright install chromium
+patchright install chrome
 ```
 
+Note: You can also install chromium but chrome is [recommended by Patchright](https://github.com/Kaliiiiiiiiii-Vinyzu/patchright-python?tab=readme-ov-file#best-practice----use-chrome-without-fingerprint-injection)
+
+---
+
 ## How to use
 
 ### Run server
+
 ```bash
 solver
 ```
 
 ```bash
 solver --port 8088 --secret jWRN7DH6 --browser-position --max-attempts 3  --captcha-timeout 30 --page-load-timeout 30 --reload-on-overrun
 ```
+
 #### Use global browser proxy
+
 ```bash
 solver --proxy-server http://myproxy.com:3128 --proxy-username user --proxy-password pass
 ```
+
 ##### Load proxy parameters from environment variables (all caps)
+
 ```bash
 solver --proxy-server MY_PROXY_SERVER --proxy-username MY_PROXY_USERNAME --proxy-password MY_PROXY_PASSWORD
 ```
+
 ##### Use a proxy from file per browser context
+
 ```bash
 solver --proxies myproxies.txt
 ```
 
-
 ### Get token
 
 #### cURL
+
 ```bash
 curl --location --request GET 'http://127.0.0.1:8088/solve' \
 --header 'ngrok-skip-browser-warning: _' \
@@ -61,6 +98,7 @@ curl --location --request GET 'http://127.0.0.1:8088/solve' \
 ```
 
 #### Python
+
 ```python
 import requests
 
@@ -80,8 +118,8 @@ json_data = {
 }
 
 response = requests.get(
-  url=url, 
-  headers=headers, 
+  url=url,
+  headers=headers,
   json=json_data,
 )
 
@@ -100,31 +138,42 @@ print("Token:", token)
 
 ```
 
-## Disclaimer ‼️ 
+---
+
+## 🐳 Container Management Guide
+goto [./docker/README.md](./docker/README.md)
+
+---
+
+## Disclaimer
+
 Use this project entirely at your own risk. I hold no responsibility for any negative outcomes, including but not limited to API blocking and IP bans
 
+---
+
 ## Donate
+
 If you find my work useful and want to encourage further development, you can do so by donating
 
-[//]: # ([![Donate](https://app.oxapay.com/media/btn/light-btn.png)](https://oxapay.com/donate/42319117))
+### [OxaPay](https://oxapay.com/donate/42319117)
 
-[//]: # (<a href="https://oxapay.com/donate/42319117" target="_blank"> <img src="https://app.oxapay.com/media/btn/light-btn.png" style="width: 200px"> </a>)
+### USDT (BEP20 - BSC)
+`0x88046e6d0f2bf8629cd7fbd754e4e275083fc993`
 
-### [OxaPay](https://oxapay.com/donate/42319117)
+### USDT (SOL - Solana)
+`BL3QX5GtfXp8qha8PMLVwyud7gxB1aPE4Vsqotwscxsv`
+
+### USDT (TRC20 - Tron)
+`TMpXigKBghRQmgYD53KyuxS38FH516ermu`
+
+### BTC
+`1E9kw3FuaahfeproboNL7uvyBdjP9wY6CR`
+
+### BTC (BEP20)
+`0x88046e6d0f2bf8629cd7fbd754e4e275083fc993`
 
 ### TON
-```
-UQCyCnWVYOmv97idVFZ4tIewToZacRhYVwfGNU658fN5w3Kl
-```
-### Bitcoin
-```
-1E9kw3FuaahfeproboNL7uvyBdjP9wY6CR
-```
-### Bitcoin (BEP20)
-```
-0x88046e6d0f2bf8629cd7fbd754e4e275083fc993
-```
-#### Speed Lightning Address username
-```
-bytechanger@speed.app
-```
+`UQCyCnWVYOmv97idVFZ4tIewToZacRhYVwfGNU658fN5w3Kl`
+
+### Speed Lightning Address username
+`bytechanger@speed.app`

docker-compose.yml

@@ -0,0 +1,18 @@
+services:
+  solver:
+    container_name: solver
+    hostname: solver
+    build:
+      context: ./docker/services/solver
+      dockerfile: ./solver.Dockerfile
+    restart: always
+    ports:
+      - 8088:8088 # turnstile_solver server
+      - 3389:3389 # RDP
+    networks:
+      - solver
+
+networks:
+  solver:
+    name: solver
+    driver: bridge

docker/README.md

@@ -0,0 +1,104 @@
+## 🐳 Docker
+
+### 🚧 Pre-Release Developer Notice
+
+**Important Context**  
+This release has been marked as experimental because:  
+⚠️ **I have been unable to personally validate the build** due to:
+
+- Unstable power infrastructure
+- Unreliable internet connectivity
+
+**Your Contribution is needed !!**
+
+### 🛠️ Build Instructions
+
+#### 1. Clone Repository
+
+```bash
+git clone https://github.com/odell0111/turnstile_solver.git
+cd turnstile_solver
+```
+
+#### 2. Build Image
+
+```bash
+# Clean build with fresh dependencies
+docker compose build --no-cache --pull
+```
+
+#### 3. Start the Container
+
+**Command** (with environment variables):
+
+```bash
+docker compose up -d \
+  -e TZ="America/New_York" \
+  -e START_SERVER="true"
+```
+
+**Key Parameters**:
+
+- `TZ`: Set your [IANA timezone](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones)  
+  *(Example: Europe/London, Asia/Dubai)*
+- `START_SERVER`:
+    - `true` = Auto-start with default config
+    - `false` = Manual start required
+
+### 🔌 Remote Access Configuration
+
+**Current Protocol (RDP)**:
+
+1. **Client Software**:
+    - Windows: Built-in Remote Desktop Connection
+    - Linux: `Remmina` or `FreeRDP`
+    - macOS: Microsoft Remote Desktop
+
+2. **Connection Details**:
+    - Address: `localhost:3389`
+    - Credentials:
+        - Username: `root`
+        - Password: `root` (❗Change after first login)
+
+3. **Post-Connection (Start server with desired parameters)**:
+
+```bash
+python3 solver
+```
+
+⚠️ **Security Notice**: Default credentials pose significant risk - change immediately after initial setup!
+
+---
+
+Do you think I should add support for VNC server/protocol for next release?
+
+### 🤔 VNC vs RDP Considerations
+
+**Protocol Comparison**:
+
+| Feature               | RDP                 | VNC                 |
+|-----------------------|---------------------|---------------------|
+| Performance           | ✅ Optimized         | ⚠️ Bandwidth-heavy  |
+| Security              | ✅ Native encryption | 🔄 Depends on setup |
+| Cross-Platform        | ✅ Excellent         | ✅ Universal         |
+| File Transfer         | ✅ Built-in          | ❌ Requires add-ons  |
+| Multi-Monitor Support | ✅ Native            | ✅ Possible          |
+
+```diff
++ For Next Release: Hybrid Support
+- Implement both protocols (RDP+VNC) via separate ports
+- Add environment variable: PROTOCOL="RDP|VNC" (default: RDP)
+- Include VNC password configuration in docker-compose
+```
+
+**Suggested Implementation**:
+
+```yaml
+# docker-compose.yml
+environment:
+  - PROTOCOL=${REMOTE_PROTOCOL:-RDP}
+  - VNC_PASSWORD=${VNC_PWD:-changeme}
+ports:
+  - "3389:3389"  # RDP
+  - "5900:5900"  # VNC
+```

docker/services/solver/entrypoint.sh

@@ -0,0 +1,60 @@
+#!/bin/bash
+
+declare -r TARGET_USER="root"
+#declare -r WORKSPACE="/${TARGET_USER}/Desktop"
+declare -r REPO_URL="https://github.com/odell0111/turnstile_solver.git"
+
+clean_pids() {
+    find /var/run -name '*xrdp*.pid' -delete
+}
+
+service_init() {
+    clean_pids
+    xrdp-sesman & xrdp -n &
+    local timeout=20
+
+    while ((timeout-- > 0)); do
+        pgrep -x Xorg && return 0
+        sleep 1
+    done
+    return 1
+}
+
+user_setup() {
+    if ! id "${TARGET_USER}" &>/dev/null; then
+        getent group "${TARGET_USER}" || groupadd "${TARGET_USER}"
+        useradd -mUs "/bin/bash" -G "${TARGET_USER},sudo" "${TARGET_USER}" || return 1
+    fi
+    echo "${TARGET_USER}:${TARGET_USER}" | chpasswd || return 1
+}
+
+env_config() {
+    [[ -n "${TZ}" ]] && {
+        ln -sf "/usr/share/zoneinfo/${TZ}" /etc/localtime
+        echo "${TZ}" >/etc/timezone
+    }
+#    mkdir -p "${WORKSPACE}"
+}
+
+repo_setup() {
+#    ( cd "${WORKSPACE}" && git clone -q "${REPO_URL}" && cd turnstile_solver || exit 2
+#    pip3 install -r requirements.txt --break-system-packages )
+    pip3 install "git+${REPO_URL}@main" --break-system-packages || exit 2
+}
+
+# Execution flow
+user_setup || { echo "User config failed"; exit 1; }
+env_config || exit 1
+repo_setup || { echo "Repo setup failed"; exit 2; }
+if service_init; then
+  echo "Xorg running"
+else
+  echo "X server failed"
+  exit 3
+fi
+
+if [ "$START_SERVER" = "true" ]; then
+  echo "Starting server in headful mode..."
+  xvfb-run -a python3 solver
+#  xvfb-run -a python3 "${WORKSPACE}/turnstile_solver/main.py"
+fi