Puppeteer-Stealth-Proxy/README.md at master

Files

AzenKain b0bcb6cd93 init

2025-10-22 19:02:13 +07:00

1.4 KiB

Raw Permalink Blame History

# 🕵️ Puppeteer Stealth Proxy A lightweight HTTP proxy API powered by Puppeteer + Stealth Plugin. Bypasses Cloudflare and anti-bot systems with real browser automation.

🚀 Features

Uses puppeteer-extra-plugin-stealth to avoid detection
Auto-save & load cookies per domain
Optional API key protection
Proxy any HTTP method (GET, POST, etc.)
Screenshot endpoint
Reuses one browser instance for better performance
Auto-closes browser on exit

⚙️ Setup

git clone https://github.com/yourname/puppeteer-stealth-proxy.git
cd puppeteer-stealth-proxy
npm install

Create .env (optional):

PORT=4000
API_KEY=your-secret-key
NODE_ENV=production

🏃 Run

npm run dev        # development
NODE_ENV=production node index.js  # production

Default: http://localhost:4000

🔑 API

Health check

GET /
→ { "ok": true, "msg": "puppeteer-stealth-proxy" }

Proxy request

GET /proxy?url=https://example.com

Optional headers:

x-api-key: your-secret-key
authorization: Bearer your-secret-key

Screenshot

GET /screenshot?url=https://example.com

📁 Structure

index.js
cookies/
package.json
README.md

🧩 Notes

Puppeteer runs in headless mode with stealth enabled
Automatically stores cookies under cookies/
Morgan logs disabled in production

1.4 KiB Raw Permalink Blame History