docs: add GitHub Actions Full tunnel documentation and workflows#783
Merged
therealaleph merged 9 commits intotherealaleph:mainfrom May 6, 2026
Merged
Conversation
github-actions
Bot
added
the
type: docs
Owner
|
@euvel — useful complement to the existing VPS / Docker paths. The 3-tier ladder (cloudflared Quick → ngrok → cloudflared Named) reads cleanly, and ordering by setup complexity helps users self-serve. Tradeoffs to be honest about with users:
For users who can't purchase a VPS at all, the workflow-based path is genuinely the only Full-mode option — worth landing. Merging. [reply via Anthropic Claude | reviewed by @therealaleph] |
therealaleph
added a commit
that referenced
this pull request
May 6, 2026
…Actions full tunnel docs Wraps four already-merged PRs into a release: - PR #799 (@dazzling-no-more): HTTP/2 multiplexing on the relay leg with idempotency-safe h1 fallback. ALPN-negotiates h2; one TCP/TLS connection multiplexes ~100 streams instead of the pool. Slow Apps Script calls no longer head-of-line-block the queue on the same socket. force_http1 kill switch in config. 180→197 tests (+17). - PR #805 (@yyoyoian-pixel): block_quic default true. QUIC over the TCP-based tunnel was TCP-over-TCP meltdown; browsers fall back to TCP/HTTPS within seconds when UDP/443 is dropped. Adds Android + desktop UI toggles. - PR #819 (@brightening-eyes): enabled accesskit on eframe so screen readers (NVDA/JAWS/VoiceOver/Orca) can navigate the desktop UI. Closes #750. - PR #783 (@euvel): GitHub Actions Full tunnel docs + workflow YAML files for users who can't buy a VPS. cloudflared Quick / ngrok / cloudflared Named. Strategically: h2 multiplexing is the architectural fix for #781 / #773 perceived-slowness regression — it makes the pool tuning machinery much less load-bearing. force_http1 kill switch is there if anything goes sideways in the wild. Tests: 197 lib + 35 tunnel-node green. UI release-mode build green. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
|
عالی بود.دست مریزاد👏✌ |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds documentation and workflow files for running a temporary Full tunnel using GitHub Actions free hosted runners. Three methods are provided, ordered by setup complexity:
Motivation
Users in networks where purchasing a VPS is not possible had no way to experince Full tunnel mode. GitHub Actions provides free hosted runners with 6-hour timeouts — sufficient for temporary Full tunnel sessions.
The
mhrv-tunnel-nodeDocker container runs on the runner. A tunneling service (cloudflared or ngrok) exposes it to the internet.CodeFull.gsconnects to this URL for the duration of the session.Files Added
assets/github-actions-tunnel/README.mdassets/github-actions-tunnel/cloudflared-quick.mdassets/github-actions-tunnel/cloudflared-quick.ymlassets/github-actions-tunnel/ngrok.mdassets/github-actions-tunnel/ngrok.ymlassets/github-actions-tunnel/cloudflared-named.mdassets/github-actions-tunnel/cloudflared-named.ymlHow to Test
CodeFull.gswith the URL and deploymhrv-rs testor by visitinghttps://ipleak.netThanks
This approach idea was came from while I was trying to download release files from GitHub during a network blackout — release assets are filtered , but repo ZIP downloads are not. That limitation led to the idea of running the tunnel-node directly on GitHub Actions.
Thank you to @therealaleph . The project is a critical tool for accessing the open internet and I am glad to contribute something back.
Compliance Note
This workflow uses GitHub-hosted runners for development infrastructure. Usage is low-burden (a single Docker container, moderate outbound traffic for one user). The documentation includes a note on GitHub Actions terms and recommends occasional personal use rather than continuous operation.