# gooserelayvpn-socks5-tunnel

gooserelayvpn-socks5-tunnel teaches the agent to build and run GooseRelayVPN: a SOCKS5 proxy that carries raw TCP through Google Apps Script to your own VPS exit server.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 275 installs · ★ 98 repo stars
- Author: reason-machines
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/reason-machines/trending-skills/tree/HEAD/skills/gooserelayvpn-socks5-tunnel/SKILL.md
- Updated: 2026-10-09
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/gooserelayvpn-socks5-tunnel

## What it does

The skill hands the agent the whole GooseRelayVPN layout. A local client listens for SOCKS5 on `127.0.0.1:1080`, wraps traffic in AES-256-GCM frames and pushes them over HTTPS to a Google edge IP with `www.google.com` in the SNI. The Apps Script web app forwards bytes along without ever seeing plaintext. On the far side, a VPS on port `8443` decrypts and dials the real destination.

Inside are the steps: produce a 64-character hex key with `scripts/gen-key.sh` or `openssl rand -hex 32`, fill in `client_config.json` and `server_config.json`, publish the web app with access set to "Anyone", then start `goose-server` on the VPS. Building from source takes Go 1.22 or newer. Point the client at several Apps Script deployments and it rotates between them, backing off from failing ones with a growing pause.

Touch the Apps Script code and you need a fresh deployment, since saving alone kills the old Deployment ID and the tunnel with it. Opening inbound TCP 8443 is part of the job too: `curl http://YOUR_VPS_IP:8443/healthz` should answer HTTP 200, and that means both the UFW rule and the cloud firewall.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill gooserelayvpn-socks5-tunnel -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/gooserelayvpn-socks5-tunnel/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/gooserelayvpn-socks5-tunnel/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill gooserelayvpn-socks5-tunnel -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/gooserelayvpn-socks5-tunnel/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill gooserelayvpn-socks5-tunnel -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/gooserelayvpn-socks5-tunnel/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install reason-machines/trending-skills skills/gooserelayvpn-socks5-tunnel
```

2. **Manually: put the files in place**
- File: `.github/skills/gooserelayvpn-socks5-tunnel/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill gooserelayvpn-socks5-tunnel -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/reason-machines/trending-skills --path skills/gooserelayvpn-socks5-tunnel
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/gooserelayvpn-socks5-tunnel/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill gooserelayvpn-socks5-tunnel -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/reason-machines/trending-skills/tree/HEAD/skills/gooserelayvpn-socks5-tunnel/SKILL.md

## When to use it
- stand up a SOCKS5 listener on `127.0.0.1:1080` backed by Apps Script
- match the `tunnel_key` on both ends so the key check passes
- spread calls across several Apps Script deployments with backoff
- keep `goose-server` alive with a systemd unit
- confirm the tunnel answers on `/healthz` before pointing apps at it

## Example prompts
- Walk me through deploying GooseRelayVPN: generate the `tunnel_key` and fill in both JSON configs.
- The client reports an AES key mismatch — check that `tunnel_key` is the same on client and server.
- Add two more Apps Script deployment IDs to `script_keys` so the client spreads the load.

## Similar
- [cloudflare-tunnel](https://affpapa.org/en/nevibecode/skills/cloudflare-tunnel.md) — skill · 912 installs
- [huawei-cloud-devbridge-tunnel](https://affpapa.org/en/nevibecode/skills/huawei-cloud-devbridge-tunnel.md) — skill · 1400 installs
- [cloudflare-zero-trust](https://affpapa.org/en/nevibecode/skills/cloudflare-zero-trust.md) — skill · 367 installs
- [cli-tunnel](https://affpapa.org/en/nevibecode/skills/cli-tunnel.md) — skill · 1300 installs
- [tunnel-doctor](https://affpapa.org/en/nevibecode/skills/tunnel-doctor.md) — skill · 741 installs
- [create-docker-mcp-tunnel](https://affpapa.org/en/nevibecode/commands/create-docker-mcp-tunnel.md) — command · ★ 47914 repo stars

From the same set: [reason-machines/trending-skills](https://affpapa.org/en/nevibecode/by/reason-machines/trending-skills.md) — 211 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
