aheh/MasterHttpRelayVPN-RUST
1
0
Fork 0
mirror of https://github.com/therealaleph/MasterHttpRelayVPN-RUST.git synced 2026-05-17 21:24:48 +03:00
Code Issues Packages Projects Releases Wiki Activity

docs(github-actions-tunnel): warn that cloudflared methods may not work from Iran ISP (#849)

Browse Source 
Apps Script's outbound runs from Google datacenter IPs, which Cloudflare's anti-bot heuristics flag as bots and serves a 403 / Persian Google Docs error on the Apps Script → trycloudflare.com / your-CF-domain step. This blocks both Method 1 (cloudflared Quick) and Method 3 (cloudflared Named) from Iran ISP per #849's reproducible report. ngrok (Method 2) doesn't go through CF edge so it works.

Updated the methods table with a "Iran ISP friendly?" column + a callout block above explaining the failure mode + recommends Method 2 (ngrok) as the starting point for Iran-based users. Methods 1 and 3 stay documented for completeness — they DO work on networks where CF's anti-bot doesn't fire against Google datacenter IPs.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
therealaleph
2026-05-07 15:42:44 +03:00
parent a797830cca
commit 82a8cbfb84
1 changed files with 18 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files
assets/github-actions-tunnel/README.md
+18 -7
View File
@@ -28,14 +28,25 @@ purchase a VPS. Uses GitHub Actions free hosted runners to run the official
Three methods are provided, ordered by setup complexity. Each is documented in Three methods are provided, ordered by setup complexity. Each is documented in
its own guide with step-by-step instructions. its own guide with step-by-step instructions.
| # | Method | Guide | Account Required | URL Behavior | | # | Method | Guide | Account Required | URL Behavior | Iran ISP friendly? |
|---|---|---|---|---| |---|---|---|---|---|---|
| 1 | cloudflared Quick Tunnel | [cloudflared-quick.md][quick] | None | New URL each session | | 1 | cloudflared Quick Tunnel | [cloudflared-quick.md][quick] | None | New URL each session | ⚠️ See note below |
| 2 | ngrok Tunnel | [ngrok.md][ngrok] | ngrok (free) | New URL each session | | 2 | ngrok Tunnel | [ngrok.md][ngrok] | ngrok (free) | New URL each session | ✅ Works |
| 3 | cloudflared Named Tunnel | [cloudflared-named.md][named] | Cloudflare + domain | **Permanent URL** | | 3 | cloudflared Named Tunnel | [cloudflared-named.md][named] | Cloudflare + domain | **Permanent URL** | ⚠️ See note below |
**New to Full tunnel mode?** Start with [Method 1][quick] — no accounts > **⚠️ Important — cloudflared methods may not work from Iran ISP.** Apps Script
needed beyond GitHub and Google. > outbound runs from Google datacenter IPs, which Cloudflare's anti-bot system
> flags as bots and serves a 403 / Persian Google Docs error page (#849). This
> blocks the Apps Script → trycloudflare.com / your-domain step. **If you're on
> Iran ISP, start with Method 2 (ngrok) instead** — ngrok's edge IPs are not
> on Cloudflare's flagged list. cloudflared Methods 1 and 3 may still work for
> users on networks where Cloudflare's anti-bot heuristics aren't firing
> against Apps Script's outbound, so they're documented for completeness.
**New to Full tunnel mode?** If you're on Iran ISP, start with [Method 2 (ngrok)][ngrok]
— it's the most reliable. If you're on a network where CF anti-bot doesn't
fire against Google datacenter IPs, [Method 1 (cloudflared Quick)][quick] is
the simplest (no third-party signup).
**Need a stable URL that survives restarts?** Use [Method 3][named] — requires **Need a stable URL that survives restarts?** Use [Method 3][named] — requires
a one-time Cloudflare CLI setup but the URL never changes. a one-time Cloudflare CLI setup but the URL never changes.