MasterHttpRelayVPN/docs/fa/GETTING_STARTED.md

شروع سریع

این راهنما مسیر ساده راه‌اندازی را نشان می‌دهد: یک رله Google Apps Script، یک فایل config.json، و پراکسی محلی روی سیستم شما.

1. دریافت پروژه

با Git:

git clone https://github.com/masterking32/MasterHttpRelayVPN.git
cd MasterHttpRelayVPN

با ZIP:

1. صفحه GitHub پروژه را باز کنید.
2. روی Code -> Download ZIP کلیک کنید.
3. فایل ZIP را extract کنید.
4. داخل پوشه MasterHttpRelayVPN یک terminal باز کنید.

2. ساخت رله Google

1. به Google Apps Script بروید.
2. یک پروژه جدید بسازید.
3. محتوای apps_script/Code.gs را داخل فایل Code.gs کپی کنید.
4. مقدار AUTH_KEY را به یک رمز طولانی و تصادفی تغییر دهید.
5. از مسیر Deploy -> New deployment نوع Web app را انتخاب کنید.
6. گزینه Execute as را روی Me و گزینه دسترسی را روی Anyone بگذارید.
7. Deploy کنید و Deployment ID را نگه دارید.

بعد از هر تغییر در Code.gs باید deployment جدید بسازید.

3. اجرای لانچر

Windows:

start.bat

Linux / macOS:

chmod +x start.sh
./start.sh

لانچر محیط مجازی می‌سازد، وابستگی‌ها را نصب می‌کند، اگر config.json وجود نداشته باشد setup wizard را اجرا می‌کند، و سپس پراکسی را بالا می‌آورد.

4. تنظیم مرورگر

مرورگر را روی پراکسی زیر تنظیم کنید:

گزینه	مقدار
نوع پراکسی	HTTP
آدرس	127.0.0.1
پورت	8085
SOCKS5، اختیاری	127.0.0.1:1080

برای HTTPS اگر مرورگر خطای گواهی داد، فایل ca/ca.crt را به عنوان trusted root نصب کنید و مرورگر را کامل ببندید و دوباره باز کنید.

5. بررسی سریع

• اگر unauthorized دیدید، مقدار AUTH_KEY در Apps Script باید دقیقا با auth_key در config.json یکی باشد.
• اگر صفحه‌ها باز نمی‌شوند، رفع مشکل را ببینید.
• اگر سرعت پایین است، دستور python main.py --scan را اجرا کنید و IP پیشنهادی را در config.json بگذارید.

قدم بعدی

برای همه گزینه‌های تنظیمات، مرجع تنظیمات را بخوانید. برای مسیرهای خاص مثل ChatGPT یا Turnstile، راهنمای Exit Node را ببینید.