Enhance README and documentation with Telegram channel and acknowledgments, improve formatting and clarity

This commit is contained in:
Abolfazl
2026-05-09 05:51:48 +03:30
parent 188909ab8b
commit 7739acc97a
5 changed files with 69 additions and 63 deletions
+6 -6
View File
@@ -33,12 +33,12 @@ Browser یا app
## پردازش درخواست
1. مرورگر ترافیک HTTP یا HTTPS proxy را به `127.0.0.1:8085` می‌فرستد.
2. برای HTTPS، proxy می‌تواند با CA تولیدشده MITM محلی انجام دهد.
3. قوانین host مشخص می‌کنند درخواست مستقیم، blocked، bypass، یا relayed باشد.
4. درخواست‌های relayed به JSON برای Apps Script تبدیل می‌شوند.
5. Apps Script مقصد را fetch می‌کند و پاسخ HTTP سریال‌شده برمی‌گرداند.
6. پراکسی محلی پاسخ HTTP را برای مرورگر بازسازی می‌کند.
- مرورگر ترافیک HTTP یا HTTPS proxy را به `127.0.0.1:8085` می‌فرستد.
- برای HTTPS، proxy می‌تواند با CA تولیدشده MITM محلی انجام دهد.
- قوانین host مشخص می‌کنند درخواست مستقیم، blocked، bypass، یا relayed باشد.
- درخواست‌های relayed به JSON برای Apps Script تبدیل می‌شوند.
- Apps Script مقصد را fetch می‌کند و پاسخ HTTP سریال‌شده برمی‌گرداند.
- پراکسی محلی پاسخ HTTP را برای مرورگر بازسازی می‌کند.
## امکانات کارایی
+10 -11
View File
@@ -13,20 +13,19 @@ cd MasterHttpRelayVPN
**با ZIP:**
1. صفحه [GitHub پروژه](https://github.com/masterking32/MasterHttpRelayVPN) را باز کنید.
2. روی **Code** -> **Download ZIP** کلیک کنید.
3. فایل ZIP را extract کنید.
4. داخل پوشه `MasterHttpRelayVPN` یک terminal باز کنید.
- صفحه [GitHub پروژه](https://github.com/masterking32/MasterHttpRelayVPN) را باز کنید.
- روی **Code** -> **Download ZIP** کلیک کنید.
- فایل ZIP را extract کنید.
- داخل پوشه `MasterHttpRelayVPN` یک terminal باز کنید.
## 2. ساخت رله Google
1. به [Google Apps Script](https://script.google.com/) بروید.
2. یک پروژه جدید بسازید.
3. محتوای [apps_script/Code.gs](../../apps_script/Code.gs) را داخل فایل `Code.gs` کپی کنید.
4. مقدار `AUTH_KEY` را به یک رمز طولانی و تصادفی تغییر دهید.
5. از مسیر **Deploy** -> **New deployment** نوع **Web app** را انتخاب کنید.
6. گزینه **Execute as** را روی **Me** و گزینه دسترسی را روی **Anyone** بگذارید.
7. Deploy کنید و `Deployment ID` را نگه دارید.
- به [Google Apps Script](https://script.google.com/) بروید و یک پروژه جدید بسازید.
- محتوای [apps_script/Code.gs](../../apps_script/Code.gs) را داخل فایل `Code.gs` کپی کنید.
- مقدار `AUTH_KEY` را به یک رمز طولانی و تصادفی تغییر دهید.
- از مسیر **Deploy** -> **New deployment** نوع **Web app** را انتخاب کنید.
- گزینه **Execute as** را روی **Me** و گزینه دسترسی را روی **Anyone** بگذارید.
- Deploy کنید و `Deployment ID` را نگه دارید.
بعد از هر تغییر در `Code.gs` باید deployment جدید بسازید.
+21 -21
View File
@@ -12,10 +12,10 @@
راه‌حل:
1. یک بار پراکسی را اجرا کنید تا فایل `ca/ca.crt` ساخته شود.
2. فایل `ca/ca.crt` را به عنوان trusted root certificate نصب کنید.
3. مرورگر را کامل ببندید و دوباره باز کنید. در Windows، Task Manager را هم چک کنید.
4. در Firefox گواهی را جداگانه از مسیر **Settings** -> **Privacy & Security** -> **Certificates** وارد کنید.
- یک بار پراکسی را اجرا کنید تا فایل `ca/ca.crt` ساخته شود.
- فایل `ca/ca.crt` را به عنوان trusted root certificate نصب کنید.
- مرورگر را کامل ببندید و دوباره باز کنید. در Windows، Task Manager را هم چک کنید.
- در Firefox گواهی را جداگانه از مسیر **Settings** -> **Privacy & Security** -> **Certificates** وارد کنید.
می‌توانید این دستور را هم اجرا کنید:
@@ -29,10 +29,10 @@ python main.py --install-cert
راه‌حل:
1. فایل [apps_script/Code.gs](../../apps_script/Code.gs) را باز کنید.
2. مقدار `const AUTH_KEY = "...";` را پیدا کنید.
3. مطمئن شوید دقیقا با `auth_key` در `config.json` یکی است.
4. بعد از تغییر [apps_script/Code.gs](../../apps_script/Code.gs)، یک deployment جدید بسازید.
- فایل [apps_script/Code.gs](../../apps_script/Code.gs) را باز کنید.
- مقدار `const AUTH_KEY = "...";` را پیدا کنید.
- مطمئن شوید دقیقا با `auth_key` در `config.json` یکی است.
- بعد از تغییر [apps_script/Code.gs](../../apps_script/Code.gs)، یک deployment جدید بسازید.
## `Config not found`
@@ -57,10 +57,10 @@ Google به جای JSON رله، HTML یا پاسخ غیرمنتظره برگر
راه‌حل:
1. یک deployment جدید Apps Script بسازید.
2. `Deployment ID` جدید را داخل `config.json` بگذارید.
3. مطمئن شوید Web App با **Execute as: Me** و **Who has access: Anyone** deploy شده است.
4. اگر quota تمام شده، صبر کنید تا reset شود یا چند deployment دیگر با `script_ids` اضافه کنید.
- یک deployment جدید Apps Script بسازید.
- `Deployment ID` جدید را داخل `config.json` بگذارید.
- مطمئن شوید Web App با **Execute as: Me** و **Who has access: Anyone** deploy شده است.
- اگر quota تمام شده، صبر کنید تا reset شود یا چند deployment دیگر با `script_ids` اضافه کنید.
## صفحه به شکل کاراکترهای عجیب باز می‌شود
@@ -76,11 +76,11 @@ Google به جای JSON رله، HTML یا پاسخ غیرمنتظره برگر
راه‌حل:
1. پروژه را به‌روز کنید و وابستگی‌ها را دوباره با `pip install -r requirements.txt` نصب کنید.
2. فایل [apps_script/Code.gs](../../apps_script/Code.gs) را دوباره به عنوان deployment جدید Apps Script منتشر کنید.
3. اگر `Deployment ID` عوض شد، آن را در `config.json` جایگزین کنید.
4. اگر از Deno Exit Node استفاده می‌کنید، [apps_script/deno_deploy.ts](../../apps_script/deno_deploy.ts) را دوباره deploy کنید.
5. پراکسی و مرورگر را کامل restart کنید.
- پروژه را به‌روز کنید و وابستگی‌ها را دوباره با `pip install -r requirements.txt` نصب کنید.
- فایل [apps_script/Code.gs](../../apps_script/Code.gs) را دوباره به عنوان deployment جدید Apps Script منتشر کنید.
- اگر `Deployment ID` عوض شد، آن را در `config.json` جایگزین کنید.
- اگر از Deno Exit Node استفاده می‌کنید، [apps_script/deno_deploy.ts](../../apps_script/deno_deploy.ts) را دوباره deploy کنید.
- پراکسی و مرورگر را کامل restart کنید.
## Timeout اتصال
@@ -98,7 +98,7 @@ python main.py --scan
چک کنید:
1. terminal نشان می‌دهد HTTP proxy روی `127.0.0.1:8085` فعال است.
2. نوع پراکسی مرورگر **HTTP** است، نه HTTPS.
3. ترافیک HTTPS هم از همان HTTP proxy عبور می‌کند.
4. گواهی نصب شده و مرورگر کامل restart شده است.
- terminal نشان می‌دهد HTTP proxy روی `127.0.0.1:8085` فعال است.
- نوع پراکسی مرورگر **HTTP** است، نه HTTPS.
- ترافیک HTTPS هم از همان HTTP proxy عبور می‌کند.
- گواهی نصب شده و مرورگر کامل restart شده است.