Skip to content

Commit 2b3386d

Browse files
committed
docs: update docs
1 parent ee77dcb commit 2b3386d

1 file changed

Lines changed: 47 additions & 0 deletions

File tree

README.md

Lines changed: 47 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -174,6 +174,30 @@ Then:
174174

175175
`script_id` can also be a JSON array: `["id1", "id2", "id3"]`.
176176

177+
#### scan-ips configuration (optional)
178+
179+
By default, the scan-ips subcommand uses a static array of IPs.
180+
181+
You can enable dynamic IP discovery by setting fetch_ips_from_api to true in config.json:
182+
183+
```json
184+
{
185+
"fetch_ips_from_api": true,
186+
"max_ips_to_scan": 100
187+
}
188+
```
189+
190+
When enabled:
191+
192+
- Fetches goog.json from Google’s public IP ranges API
193+
- Extracts all CIDRs and expands them to individual IPs
194+
- Prioritizes IPs from famous Google domains (google.com, youtube.com, etc.)
195+
- Randomly selects up to max_ips_to_scan candidates (prioritized IPs first)
196+
- Tests only the selected candidates for connectivity and frontend validation.
197+
198+
By using this options you may find ips witch are faster than static array that is provided as default but there is no guarantee that this ips would work.
199+
200+
177201
### Step 5 — Point your client at the proxy
178202

179203
The tool listens on **two** ports. Use whichever your client supports:
@@ -437,6 +461,29 @@ Firefox cert store خودش را جدا دارد؛ installer تلاش می‌ک
437461
./mhrv-rs --help
438462
```
439463

464+
465+
#### پیکربندی scan-ips (اختیاری)
466+
به‌طور پیش‌فرض، دستور scan-ips از آرایه‌ای ثابت از IPها استفاده می‌کند.
467+
468+
می‌توانید کشف پویای IP را با تنظیم fetch_ips_from_api روی true در config.json فعال کنید:
469+
470+
```json
471+
{
472+
"fetch_ips_from_api": true,
473+
"max_ips_to_scan": 100
474+
}
475+
```
476+
477+
زمانی که فعال باشد:
478+
479+
- فایل goog.json را از API محدوده‌های عمومی IP گوگل دریافت می‌کند
480+
تمام CIDRها را استخراج کرده و به IPهای جداگانه تبدیل می‌کند
481+
- به IPهای دامنه‌های معروف گوگل (google.com، youtube.com و غیره) اولویت می‌دهد
482+
به‌صورت تصادفی تا max_ips_to_scan کاندید انتخاب می‌کند (ابتدا IPهای اولویت‌دار)
483+
فقط کاندیدهای انتخاب‌شده را برای اتصال و اعتبارسنجی frontend تست می‌کند.
484+
485+
با استفاده از این گزینه‌ها ممکن است IPهایی پیدا کنید که سریع‌تر از آرایه ثابت پیش‌فرض هستند اما تضمینی وجود ندارد که این IPها کار کنند.
486+
440487
#### ۵. تنظیم proxy در کلاینت
441488

442489
ابزار روی **دو** پورت گوش می‌دهد:

0 commit comments

Comments
 (0)