{"id":26844289,"url":"https://github.com/graveeatermadison/shadowproxy","last_synced_at":"2026-05-05T09:33:15.837Z","repository":{"id":285242670,"uuid":"957417212","full_name":"GraveEaterMadison/ShadowProxy","owner":"GraveEaterMadison","description":"ShadowProxy is an automated Tor proxy setup with built-in IP rotation and User-Agent spoofing, enhancing privacy and anonymity for web scraping, bot automation, and secure browsing. It ensures seamless proxy switching to bypass detection mechanisms and maintain persistent anonymity online","archived":false,"fork":false,"pushed_at":"2025-03-30T14:11:24.000Z","size":10,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-30T15:22:37.931Z","etag":null,"topics":["anonymity","automation","bash-script","cybersecurity","google-colab","ip-rotation","linux","macos","networking","privacy","proxy","tor","user-agent-rotation","web-scraping"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/GraveEaterMadison.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-30T10:18:24.000Z","updated_at":"2025-03-30T14:11:27.000Z","dependencies_parsed_at":"2025-03-30T15:22:39.664Z","dependency_job_id":"1877576f-c974-4377-add9-60f84a112b48","html_url":"https://github.com/GraveEaterMadison/ShadowProxy","commit_stats":null,"previous_names":["graveeatermadison/shadowproxy"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GraveEaterMadison%2FShadowProxy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GraveEaterMadison%2FShadowProxy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GraveEaterMadison%2FShadowProxy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GraveEaterMadison%2FShadowProxy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GraveEaterMadison","download_url":"https://codeload.github.com/GraveEaterMadison/ShadowProxy/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246365623,"owners_count":20765549,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["anonymity","automation","bash-script","cybersecurity","google-colab","ip-rotation","linux","macos","networking","privacy","proxy","tor","user-agent-rotation","web-scraping"],"created_at":"2025-03-30T19:19:24.051Z","updated_at":"2026-05-05T09:33:15.790Z","avatar_url":"https://github.com/GraveEaterMadison.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ShadowProxy: Tor Proxy with User-Agent Rotation\n\nThis repository provides a **Bash script** that automates the setup of a **Tor proxy with User-Agent rotation**, ensuring anonymity and privacy when accessing the web. This script is particularly useful for **Reddit bots** or **web scrapers** that need to cycle IPs and avoid detection.\n\n## 🚀 Features\n\n✅ Installs and configures **Tor** automatically\\\n✅ Rotates IP every **10 minutes** using Tor’s control port\\\n✅ Randomizes **User-Agent** every **5 minutes** to evade detection\\\n✅ Verifies that the Tor proxy is working correctly\\\n✅ Supports **Linux** and **macOS**\n\n---\n\n## 📌 Table of Contents\n\n- [Requirements](#requirements)\n- [Installation](#installation)\n- [Usage](#usage)\n- [Running in Google Colab](#running-in-google-colab)\n- [How It Works](#how-it-works)\n- [Troubleshooting](#troubleshooting)\n- [License](#license)\n\n---\n\n## ⚙️ Requirements\n\nBefore running the script, make sure you have the following:\n\n- **Linux or macOS** (Windows users can use **WSL or a virtual machine**)\n- **Git installed**\n- **Tor and Torsocks** (automatically installed by the script if missing)\n\n---\n\n## 🛠️ Installation\n\n### **1️⃣ Clone the Repository**\n\n```bash\ngit clone https://github.com/GraveEaterMadison/ShadowProxy.git\ncd ShadowProxy\n```\n\n### **2️⃣ Give Execute Permission**\n\n```bash\nchmod +x shadowproxy_setup.sh\n```\n\n---\n\n## ▶️ Usage\n\n### **Run the Script**\n\n```bash\n./shadowproxy_setup.sh\n```\n\nThis will:\n\n- Install **Tor** if it's missing\n- Configure **Tor proxy** (Socks5 on `127.0.0.1:9050`)\n- Rotate IP every **10 minutes**\n- Change User-Agent every **5 minutes**\n- Verify that the proxy is working\n\n### **Check if Tor Proxy is Working**\n\n```bash\ntorsocks curl https://check.torproject.org/\n```\n\nIf the setup was successful, you should see:\n\n✅ *Congratulations! This browser is configured to use Tor.*\n\n---\n\n## 📡 Running in Google Colab\n\nYou can run this script in **Google Colab** using the following steps:\n\n### **1️⃣ Open Google Colab**\n\nGo to [Google Colab](https://colab.research.google.com/).\n\n### **2️⃣ Run the following commands in a Colab notebook**\n\n```python\n!apt update \u0026\u0026 apt install -y tor torsocks\n!echo -e \"SocksPort 9050\\nControlPort 9051\\nCookieAuthentication 1\\nRunAsDaemon 1\" \u003e /etc/tor/torrc\n!service tor start\n```\n\n### **3️⃣ Check if Tor is Running**\n\n```python\n!torsocks curl https://check.torproject.org/\n```\n\n---\n\n## 🔍 How It Works\n\n### **1️⃣ Installing Dependencies**\n\nThe script checks for **Tor** and **Torsocks**. If they are not installed, it installs them based on the operating system:\n\n- **Linux:** `sudo apt install -y tor torsocks`\n- **macOS:** `brew install tor torsocks`\n\n### **2️⃣ Configuring Tor**\n\nIt modifies the **Tor configuration file** (`/etc/tor/torrc`) to ensure the proxy runs correctly:\n\n```bash\nSocksPort 9050\nControlPort 9051\nCookieAuthentication 1\nRunAsDaemon 1\n```\n\n### **3️⃣ Rotating IPs**\n\nEvery **10 minutes**, the script sends a **NEWNYM** signal to Tor to change the IP address:\n\n```bash\necho -e \"AUTHENTICATE \\\"$COOKIE\\\"\\r\\nSIGNAL NEWNYM\\r\\nQUIT\" | nc localhost 9051\n```\n\n### **4️⃣ Changing User-Agents**\n\nEvery **5 minutes**, the script selects a random User-Agent from a predefined list:\n\n```bash\nexport USER_AGENT=\"$RANDOM_USER_AGENT\"\n```\n\n---\n\n## 🛠️ Troubleshooting\n\n❌ **Tor service is not starting**\\\n➡ Try restarting it manually:\n\n```bash\nsudo systemctl restart tor\n```\n\n❌ **Proxy test failed**\\\n➡ Check if Tor is running:\n\n```bash\nps aux | grep tor\n```\n\n➡ Try running manually:\n\n```bash\ntorsocks curl https://check.torproject.org/\n```\n\n---\n\n## 📜 License\n\nThis project is licensed under the **MIT License**. Feel free to use and modify it.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgraveeatermadison%2Fshadowproxy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgraveeatermadison%2Fshadowproxy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgraveeatermadison%2Fshadowproxy/lists"}