# Kianmhz/GooseRelayVPN

SOCKS5 VPN that tunnels raw TCP through Google Apps Script to a VPS exit server, with end-to-end AES-256-GCM and domain-fronted TLS to Google

Repository: https://github.com/Kianmhz/GooseRelayVPN
Canonical: https://ross.abutalabs.com/products/gooserelayvpn
Language: Go
License: MIT
License Family: permissive
Topics: proxy, socks5, tunneling, vpn, sni, aes-gcm, domain-fronting, dns-hijacking, mitm
Last push: 2026-05-29T19:17:35+00:00

## Health v2 (maintenance only)
Score: 69/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 84, release rhythm 85, longevity 9
- inputs: {"age_days": 129, "days_push": 96, "days_rel": 102, "gap_med": 1, "n_releases_24m": 10}
- flags: young
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1406, forks 185 (observed 2026-08-28T04:04:38.216992+00:00)

## What it is
A Go-based SOCKS5 VPN client that tunnels raw TCP traffic through Google Apps Script web apps to a user-controlled VPS exit server. Traffic appears as TLS to Google IPs (SNI=www.google.com) with AES-256-GCM end-to-end encryption, enabling censorship circumvention via domain fronting.

## Use cases
- bypass internet censorship and firewalls
- tunnel arbitrary TCP protocols like SSH through restrictive networks
- hide traffic as connections to Google
- route traffic through a personal VPS exit node
- share a proxy connection over LAN
- circumvent SNI-based blocking

## When to choose
- you need to bypass SNI-based censorship or DPI
- you want raw TCP tunneling, not just HTTP proxying
- you have a small VPS and want a self-hosted exit node
- you want traffic indistinguishable from Google TLS connections

## When to avoid
- you need a full VPN with UDP support
- you cannot deploy or maintain a VPS
- you need high throughput for bandwidth-heavy tasks
- Google connectivity itself is blocked

## Facets
- artifact type: application
- maturity: active
- function: proxy, vpn, cryptography, networking, security
- domain: privacy, censorship-circumvention, networking, security
- platform: windows, cross-platform, cli
- tags: socks5, domain-fronting, tunneling, aes-256-gcm, google-apps-script, vps-exit-node, anti-censorship, linux, macos, android

## Member repositories
- Kianmhz/GooseRelayVPN (main) score 69

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:38.216992+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:38:40.827841+00:00, confidence not recorded.
  - readme: https://github.com/Kianmhz/GooseRelayVPN (fetched 2026-08-28T04:04:38.216992+00:00, sha 8f1c22b0abda)
- Data as of 2026-08-30T08:39:29.467469+00:00.