cors / README.md
Rifza111
up
034dfd3
|
raw
history blame
2.24 kB

🧰 Multi-Tool Express API Server

API gateway serbaguna berbasis Node.js & Express β€” mendukung proxy request, fetch & axios passthrough, eval/exec remote, dan YouTube stream downloader (via yt-dlp).


πŸš€ Fitur Utama

  • 🌐 Universal Proxy:
    • /proxy (axios)
    • /fetch (fetch API)
  • πŸ§ͺ Remote Code Execution (for internal debugging only):
    • /ev untuk eval()
    • /exec untuk shell command (exec)
  • πŸ” Key-based Access Control untuk endpoint sensitif
  • πŸ›‘οΈ Built-in rate/debug logger + IP detection (real IP via x-forwarded-for)
  • πŸ“¦ Modular: dipisahkan ke beberapa file (crypto, prototype, dll)

πŸ“¦ Instalasi

git clone https://github.com/Rifza123/cors.git
cd cors
npm install

βš™οΈ Konfigurasi

Buat file .env (opsional) atau atur environment variable:

PORT=7860
PASSWORD=your_secret_key

πŸ§ͺ Contoh Penggunaan

πŸ” Proxy (axios):

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

β›“ Fetch Passthrough (streaming/sse supported):

POST /fetch
Body: { "url": "https://example.com/api", "data": { ... } }

🧠 Eval:

GET /ev?q=2+2&key=your_secret_key

πŸ–₯ Exec (Shell):

GET /exec?q=uptime&key=your_secret_key

πŸ“‚ Struktur File

.
β”œβ”€β”€ index.js             # Entry point
β”œβ”€β”€ lib/
β”‚   └── crypto.js        # Enkripsi & dekripsi dengan AES
β”œβ”€β”€ prototype.js         # Prototype tambahan untuk decode string/token
β”œβ”€β”€ package.json

πŸ›‘οΈ Keamanan

⚠️ Endpoint /ev dan /exec menggunakan eval dan child_process.exec() β€” hanya aktif jika password cocok (?key=...). Jangan expose ke publik tanpa proteksi tambahan seperti IP allowlist atau token OAuth.


πŸ“¦ Dependencies

  • express, axios, form-data
  • yt-search, yt-dlp (harus tersedia di sistem)
  • child_process, util, crypto, fs, path

🧩 Tips

  • Untuk endpoint YouTube, yt-dlp harus terinstall dan tersedia di PATH.
  • Kamu bisa integrasi ke bot Telegram, CLI, atau automasi lain.
  • Support format mp3/mp4 via argumen type.

πŸ“„ License

MIT Β© Rifza