Skip to content

rayss868/ProxyDeck

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ProxyDeck Banner

ProxyDeck

Manage, test, and rotate your own proxies directly from your browser.

Chrome Web Store License: MIT Manifest V3


🚀 Overview

ProxyDeck is a powerful, privacy-first Chrome Extension designed for power users, QA engineers, developers, and researchers who need to manage multiple proxies efficiently.

Tired of manually copying and pasting proxies into your OS settings? Frustrated by dead proxies and tedious rotation setups? ProxyDeck solves this by providing a seamless, local-first workflow to import, validate, check, and rotate your proxies entirely within your browser.

Note: ProxyDeck is a proxy manager. It does not provide or sell proxies. You must bring your own proxies.

✨ Key Features

  • ⚡ Bulk Import & Parsing: Paste thousands of proxies at once. ProxyDeck automatically parses formats like ip:port, ip:port:user:pass, http://ip:port, and socks5://ip:port, removing duplicates and invalid entries.
  • 🔍 Built-in Bulk Checker: Test your proxies for connectivity, latency, and exit IP location (Country, Region, City) without freezing your browser.
  • 🔄 Smart Rotation: Create a rotation pool from your live proxies. Set an interval (e.g., every 5 minutes), and ProxyDeck will automatically switch your browser's connection.
  • 🌍 Country Grouping: Your live proxies are neatly organized by country in a modern, collapsible UI, making it easy to find the exact location you need.
  • 🛡️ Privacy-First & Local: All your proxy data is stored locally in your browser using chrome.storage.local. We do not track your browsing history or send your proxy list to external servers.
  • 🔒 Secure Auth Handling: Automatically handles proxy authentication challenges in the background.
  • 📤 Export Results: Easily export your live, dead, or untested proxies to a .txt file.

🛠️ Installation

For Users (Chrome Web Store)

Coming soon to the Chrome Web Store!

For Developers (Manual Installation)

  1. Clone or download this repository.
  2. Open Google Chrome and navigate to chrome://extensions/.
  3. Enable "Developer mode" in the top right corner.
  4. Click "Load unpacked" and select the proxy-enabler directory.
  5. The ProxyDeck icon should now appear in your extension toolbar.

💻 How to Use

  1. Import Proxies: Click the extension icon and open the Dashboard. Go to the Bulk Import tab and paste your proxy list.
  2. Check Status: Navigate to the Bulk Checker tab and click "Start Check". ProxyDeck will test each proxy and fetch its location data.
  3. Apply a Proxy: Go to the Proxy List tab. Expand a country group and click Apply next to any live proxy. Your browser is now routed through that proxy.
  4. Rotate Proxies: In the Rotation tab, set your desired interval and select the proxies you want in the pool. Click "Save Settings", then click "Start Rotation" from the popup menu.
  5. Disconnect: Click the extension icon and hit Disconnect to return to your direct connection.

🏗️ Architecture & Tech Stack

ProxyDeck is built using modern web technologies and adheres to the latest Chrome Extension standards:

  • Manifest V3: Ensures better security, privacy, and performance.
  • Vanilla JS (ES6+): Lightweight and fast, with no heavy frameworks required for the MVP.
  • HTML5 & CSS3: Modern, responsive UI with CSS variables for easy theming.
  • Chrome APIs Used:
    • chrome.proxy: To route browser traffic.
    • chrome.webRequest & chrome.webRequestAuthProvider: To handle proxy authentication.
    • chrome.alarms: For reliable background rotation timers.
    • chrome.storage.local: For secure, local data persistence.
    • chrome.privacy: To prevent WebRTC IP leaks.

🔒 Privacy & Security

ProxyDeck is designed with your privacy in mind:

  • No Tracking: We do not collect your browsing history, cookies, or page content.
  • Local Storage: Your proxy credentials are saved locally on your device.
  • WebRTC Leak Protection: Automatically disables non-proxied UDP traffic when a proxy is active to prevent your real IP from leaking.

📝 Roadmap

  • MVP Release (Import, Check, Apply, Rotate)
  • Firefox & Edge Support
  • Advanced PAC Script Routing (Rule-based bypass)
  • Cloud Sync (Encrypted)
  • Team Workspaces

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages