RELAY PROXY

██████╗ ██████╗  ██████╗ ██╗  ██╗██╗   ██╗
██╔══██╗██╔══██╗██╔═══██╗╚██╗██╔╝╚██╗ ██╔╝
██████╔╝██████╔╝██║   ██║ ╚███╔╝  ╚████╔╝ 
██╔══██╗██╔══██╗██║   ██║ ██╔██╗   ╚██╔╝  
██║  ██║██║  ██║╚██████╔╝██╔╝ ██╗   ██║   
╚═╝  ╚═╝╚═╝  ╚═╝ ╚═════╝ ╚═╝  ╚═╝   ╚═╝

RELAY PROXY

Forward HTTP traffic through any relay server (Vercel / Google Apps Script)
Binds to 127.0.0.1 only — Not a VPN — Not an open proxy

Author: v7lthronyx (Aiden Azad)
GitHub: github.com/v74all/badplace

🇬🇧 English

What is this?

A local-only HTTP/HTTPS proxy that forwards traffic through a relay server.
It runs on your own machine and routes your HTTP traffic through a relay (Vercel serverless function or Google Apps Script).

Use cases:

Bypass local network restrictions for HTTP traffic
Route browser traffic through an external relay
Test how your apps behave behind a proxy
Access region-restricted HTTP content

How it works

Browser/App → 127.0.0.1:8085 → Relay (Vercel/GAS) → Target Website

You configure your browser/app to use 127.0.0.1:8085 as HTTP proxy
The proxy forwards each request to the relay server via JSON POST
The relay fetches the actual URL and returns the response
The proxy sends the response back to your browser/app

Quick Start

# 1. Clone and enter the project
git clone https://github.com/v74all/badplace.git
cd badplace

# 2. Configure your relay URL
export RELAY_URL='https://your-relay-url.com'

# 3. Run the proxy
./run-local.sh

Prerequisites

Python 3.9+
curl (for connectivity checks)
A relay server (Vercel or Google Apps Script)

Configuration

Edit config.local.yaml:

mode: apps_script         # vercel | apps_script
relay_url: ""
apps_script_url: "https://script.google.com/macros/s/YOUR_SCRIPT_ID/exec"
bind_host: "127.0.0.1"
bind_port: 8085
socks_port: 1081
mitm_enabled: false       # HTTPS MITM (advanced)
doh_enabled: false       # Disable DoH for faster local DNS

Or use environment variables:

export APPS_SCRIPT_URL='https://script.google.com/macros/s/YOUR_SCRIPT_ID/exec'

Note: If your network blocks script.google.com, the proxy can still start, but Google Apps Script relay requests will fail. In that case, use Vercel or another relay host.

Deploy Your Own Relay

Option 1: Vercel (Recommended)

# Deploy the relay function to Vercel
npm install -g vercel
vercel deploy

# Or push to GitHub and import on vercel.com

The relay function is in api/relay.js. After deployment, use the Vercel URL as your RELAY_URL.

Option 2: Google Apps Script

Go to script.google.com
Create a new project
Copy the code from google-apps-script-relay.gs
Deploy as Web App (Execute as: Me, Who has access: Anyone)
Use the deployment URL as your RELAY_URL

Browser Setup

Chromium (isolated profile — recommended):

chromium --proxy-server='http://127.0.0.1:8085' \
         --user-data-dir='/tmp/proxy-browser-profile'

Firefox:

about:preferences → Network Settings → Manual proxy
HTTP Proxy: 127.0.0.1 Port: 8085
Check "Also use this proxy for HTTPS"
No Proxy for: localhost, 127.0.0.1

System-wide (CLI tools):

export http_proxy='http://127.0.0.1:8085'
export https_proxy='http://127.0.0.1:8085'
export no_proxy='localhost,127.0.0.1'

Health Endpoints

Endpoint	Description
`http://127.0.0.1:8085/health`	Proxy status
`http://127.0.0.1:8085/test-google`	Test Google connectivity
`http://127.0.0.1:8085/test-relay`	Test relay connection

Troubleshooting & Speed

If script.google.com یا script.googleusercontent.com مسدود است، از Vercel استفاده کنید.
doh_enabled: false را در config.local.yaml قرار دهید تا DNS محلی سریع‌تر شود.
اگر می‌خواهید پروکسی حتی در صورت شکست چک اتصال اجرا شود، از:
```
STRICT_CHECKS=0 ./run-local.sh
```
اگر می‌خواهید اجرای سخت‌گیرانه باشد، از:
```
STRICT_CHECKS=1 ./run-local.sh
```

برای تست سرعت:

curl -x http://127.0.0.1:8085 http://httpbin.org/get

Commands

./run-local.sh     # Start the proxy
./stop-local.sh    # Stop the proxy

Security

✅ Binds to 127.0.0.1 only — no LAN or internet exposure
✅ HTTPS MITM disabled by default
✅ Cache disabled by default
✅ Full URLs, cookies, Authorization headers not logged
✅ CA key stored with chmod 600
❌ This is NOT a VPN — only works for apps configured to use the proxy

🇮🇷 فارسی

این ابزار چیه؟

یک پروکسی HTTP/HTTPS محلی که ترافیک را از طریق یک سرور relay عبور می‌دهد.
روی سیستم خودتان اجرا می‌شود و ترافیک HTTP را از طریق Vercel یا Google Apps Script هدایت می‌کند.

کاربردها:

عبور از محدودیت‌های شبکه محلی برای ترافیک HTTP
هدایت ترافیک مرورگر از طریق یک relay خارجی
تست رفتار برنامه‌ها پشت پروکسی
دسترسی به محتوای محدود شده بر اساس منطقه

نحوه کار

مرورگر/برنامه → 127.0.0.1:8085 → Relay (Vercel/GAS) → سایت مقصد

مرورگر/برنامه خود را برای استفاده از 127.0.0.1:8085 به عنوان پروکسی HTTP تنظیم کنید
پروکسی هر درخواست را به صورت JSON POST به سرور relay ارسال می‌کند
Relay URL واقعی را fetch کرده و پاسخ را برمی‌گرداند
پروکسی پاسخ را به مرورگر/برنامه شما ارسال می‌کند

شروع سریع

# 1. پروژه را clone کنید
git clone https://github.com/v74all/badplace.git
cd badplace

# 2. URL relay خود را تنظیم کنید
export RELAY_URL='https://your-relay-url.com'

# 3. پروکسی را اجرا کنید
./run-local.sh

پیش‌نیازها

Python 3.9+
curl (برای چک اتصال)
یک سرور relay (Vercel یا Google Apps Script)

تنظیمات

فایل config.local.yaml را ویرایش کنید:

mode: apps_script        # vercel | apps_script
relay_url: ""
apps_script_url: "https://script.google.com/macros/s/YOUR_SCRIPT_ID/exec"
bind_host: "127.0.0.1"
bind_port: 8085
socks_port: 1081         # پورت SOCKS5
doh_enabled: false       # DNS-over-HTTPS غیرفعال برای سرعت بیشتر
mitm_enabled: false      # HTTPS MITM (پیشرفته)

یا از متغیرهای محیطی استفاده کنید:

export APPS_SCRIPT_URL='https://script.google.com/macros/s/YOUR_SCRIPT_ID/exec'

توجه: اگر شبکه‌ی شما script.google.com را بلاک کند، پروکسی اجرا می‌شود اما ارسال درخواست به Google Apps Script با خطا مواجه خواهد شد. در این حالت Vercel انتخاب بهتری است.

نصب Relay خودتان

گزینه 1: Vercel (پیشنهادی - سریع‌تر)

# نصب Vercel CLI
npm install -g vercel

# Deploy تابع relay
vercel deploy

فایل relay در api/relay.js قرار دارد. بعد از deploy، URL Vercel را به عنوان RELAY_URL استفاده کنید.

گزینه 2: Google Apps Script

به script.google.com بروید
یک پروژه جدید ایجاد کنید
کد را از google-apps-script-relay.gs کپی کنید
به عنوان Web App deploy کنید (Execute as: Me, Who has access: Anyone)
URL deployment را به عنوان APPS_SCRIPT_URL استفاده کنید

تنظیمات مرورگر

Chromium (پروفایل ایزوله - توصیه می‌شود):

chromium --proxy-server='http://127.0.0.1:8085' \
         --user-data-dir='/tmp/proxy-browser-profile'

Firefox:

about:preferences → Network Settings → Manual proxy
HTTP Proxy: 127.0.0.1 Port: 8085
تیک "Also use this proxy for HTTPS"
No Proxy for: localhost, 127.0.0.1

ابزارهای CLI (سیستم‌گسترده):

export http_proxy='http://127.0.0.1:8085'
export https_proxy='http://127.0.0.1:8085'
export no_proxy='localhost,127.0.0.1'

نقاط پایانی سلامت

نقطه پایانی	توضیح
`http://127.0.0.1:8085/health`	وضعیت پروکسی
`http://127.0.0.1:8085/test-google`	تست اتصال گوگل
`http://127.0.0.1:8085/test-relay`	تست اتصال relay

دستورات

./run-local.sh     # شروع پروکسی
./stop-local.sh    # توقف پروکسی

امنیت

✅ فقط به 127.0.0.1 bind می‌شود — هیچ دسترسی LAN یا اینترنت
✅ HTTPS MITM به طور پیش‌فرض غیرفعال
✅ کش به طور پیش‌فرض غیرفعال
✅ URL کامل، کوکی‌ها، هدر Authorization لاگ نمی‌شوند
✅ کلید CA با chmod 600 ذخیره می‌شود
❌ این VPN نیست — فقط برای برنامه‌هایی که پروکسی را تنظیم کرده‌اند کار می‌کند

بهینه‌سازی سرعت

برای بهبود سرعت:

از Vercel به جای Google Apps Script استفاده کنید (سریع‌تر است)
DoH را غیرفعال کنید (doh_enabled: false)
لاگ‌ها را در Google Script حذف کنید
تایم‌اوت را کاهش دهید (در کد تغییر دهید)
اتصال‌های مستقیم HTTPS ممکن است در شبکه‌های محدود شکست بخورند

تست سرعت

برای تست سرعت پروکسی:

# تست سلامت پروکسی
curl http://127.0.0.1:8085/health

# تست اتصال گوگل
curl http://127.0.0.1:8085/test-google

# تست relay
curl http://127.0.0.1:8085/test-relay

# تست سرعت با سایت واقعی
time curl -x http://127.0.0.1:8085 http://httpbin.org/get

🇮🇷 راهنمای ویژه: استفاده در شرایط فیلترینگ ایران

⚠️ توجه مهم: این ابزار برای عبور از فیلترینگ ایران طراحی شده است. فقط Google Apps Script نیاز است باز باشد.

پیش‌نیازها در ایران:

script.google.com باید باز باشد — معمولاً در ایران فیلتر نیست
script.googleusercontent.com باید باز باشد — برای redirectهای GAS
Python 3.9+ روی سیستم شما نصب باشد

مراحل راه‌اندازی برای ایران:

۱. ساخت Google Apps Script Relay:

# 1. به script.google.com بروید و پروژه جدید بسازید
# 2. کد google-apps-script-relay.gs را کپی کنید
# 3. Deploy → New deployment → Web app
# 4. Execute as: Me, Who has access: Anyone
# 5. URL را کپی کنید

۲. تنظیم config.local.yaml:

mode: apps_script
apps_script_url: "https://script.google.com/macros/s/YOUR_SCRIPT_ID/exec"
bind_host: 127.0.0.1
bind_port: 8085
socks_enabled: true
socks_port: 1081
doh_enabled: true          # DNS-over-HTTPS برای دور زدن DNS فیلترینگ
mitm_enabled: true           # برای HTTPS لازم است
# ⚠️ همه لاگ‌ها غیرفعال شدند برای حفظ حریم خصوصی
log_full_urls: false
log_cookies: false
log_authorization: false
log_request_bodies: false

۳. اجرا:

./run-local.sh

۴. تست اتصال:

# تست سلامت پروکسی
curl http://127.0.0.1:8085/health

# تست اتصال گوگل (مهم برای ایران)
curl http://127.0.0.1:8085/test-google

# تست relay
curl http://127.0.0.1:8085/test-relay

نکات مهم برای ایران:

فقط Google Apps Script نیاز است باز باشد — بقیه سایت‌ها از طریق relay باز می‌شوند
Vercel فیلتر است — در ایران از Google Apps Script استفاده کنید
DoH فعال بگذارید — برای دور زدن DNS فیلترینگ ایران
MITM فعال بگذارید — برای HTTPS لازم است
حریم خصوصی: همه لاگ‌ها غیرفعال شدند — هیچ URL، کوکی یا هدر Authorization لاگ نمی‌شود

عیب‌یابی در ایران:

script.google.com مسدود است: این ابزار کار نخواهد کرد. VPN دیگری پیدا کنید.
تایم‌اوت: اینترنت شما کند است یا script.google.com ناپایدار است. دوباره تلاش کنید.
HTTPS کار نمی‌کند: mitm_enabled: true را در config بگذارید و CA certificate را در مرورگر نصب کنید.
DNS کار نمی‌کند: doh_enabled: true را بررسی کنید.

عیب‌یابی عمومی

پورت اشغال شده: پورت‌ها را چک کنید و پروسه‌های قبلی را بکشید
اتصال relay شکست خورد: URL relay را چک کنید
سرعت کم: DoH را غیرفعال کنید (doh_enabled: false)

نکات امنیتی

✅ فقط روی 127.0.0.1 اجرا می‌شود
✅ HTTPS MITM پیش‌فرض خاموش است
✅ Cache پیش‌فرض خاموش است
❌ این یک VPN نیست

📁 Project Structure

├── proxy.py                  # Main proxy application
├── config.local.yaml         # Local configuration
├── run-local.sh              # Start script
├── stop-local.sh             # Stop script
├── requirements.txt          # Python dependencies
├── api/
│   └── relay.js              # Vercel serverless relay function
├── vercel.json               # Vercel configuration
├── google-apps-script-relay.gs  # Google Apps Script relay
├── .banner                   # ASCII art banner
└── README.md                 # This file

📜 License

MIT License — see LICENSE for details.

_{Built with ❤️ by v7lthronyx}

Name		Name	Last commit message	Last commit date
Latest commit History 9 Commits
api		api
scripts		scripts
.banner		.banner
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
config.local.yaml		config.local.yaml
google-apps-script-relay.gs		google-apps-script-relay.gs
google-apps-script-simple.gs		google-apps-script-simple.gs
proxy.py		proxy.py
requirements.txt		requirements.txt
run-local.sh		run-local.sh
stop-local.sh		stop-local.sh
vercel.json		vercel.json

Folders and files

Latest commit

History

Repository files navigation

RELAY PROXY

🇬🇧 English

What is this?

How it works

Quick Start

Prerequisites

Configuration

Deploy Your Own Relay

Option 1: Vercel (Recommended)

Option 2: Google Apps Script

Browser Setup

Health Endpoints

Troubleshooting & Speed

Commands

Security

🇮🇷 فارسی

این ابزار چیه؟

نحوه کار

شروع سریع

پیش‌نیازها

تنظیمات

نصب Relay خودتان

گزینه 1: Vercel (پیشنهادی - سریع‌تر)

گزینه 2: Google Apps Script

تنظیمات مرورگر

نقاط پایانی سلامت

دستورات

امنیت

بهینه‌سازی سرعت

تست سرعت

🇮🇷 راهنمای ویژه: استفاده در شرایط فیلترینگ ایران

پیش‌نیازها در ایران:

مراحل راه‌اندازی برای ایران:

نکات مهم برای ایران:

عیب‌یابی در ایران:

عیب‌یابی عمومی

نکات امنیتی

📁 Project Structure

📜 License

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages