gooserelayvpn-socks5-tunnel — Claude Code skill: SOCKS5 tunnel setup
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.
no license 275 installs ★ 98 updated 2026-10-09
npx skills add reason-machines/trending-skills --skill gooserelayvpn-socks5-tunnel -a claude-codeWhat gooserelayvpn-socks5-tunnel 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.
What it helps with
- stand up a SOCKS5 listener on
127.0.0.1:1080backed by Apps Script - match the
tunnel_keyon both ends so the key check passes - spread calls across several Apps Script deployments with backoff
- keep
goose-serveralive with a systemd unit - confirm the tunnel answers on
/healthzbefore pointing apps at it
Example prompts for the agent
- Walk me through deploying GooseRelayVPN: generate the
tunnel_keyand fill in both JSON configs. - The client reports an AES key mismatch — check that
tunnel_keyis the same on client and server. - Add two more Apps Script deployment IDs to
script_keysso the client spreads the load.
How to install gooserelayvpn-socks5-tunnel
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill gooserelayvpn-socks5-tunnel -a claude-code2Manually: put the files in place
~/.claude/skills/gooserelayvpn-socks5-tunnel/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/gooserelayvpn-socks5-tunnel/
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill gooserelayvpn-socks5-tunnel -a codex2Manually: put the files in place
.agents/skills/gooserelayvpn-socks5-tunnel/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill gooserelayvpn-socks5-tunnel -a cursor2Manually: put the files in place
.cursor/skills/gooserelayvpn-socks5-tunnel/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/trending-skills skills/gooserelayvpn-socks5-tunnel2Manually: put the files in place
.github/skills/gooserelayvpn-socks5-tunnel/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill gooserelayvpn-socks5-tunnel -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/trending-skills --path skills/gooserelayvpn-socks5-tunnelManually: put the files in place
.devin/skills/gooserelayvpn-socks5-tunnel/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill gooserelayvpn-socks5-tunnel -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about gooserelayvpn-socks5-tunnel
How do I install gooserelayvpn-socks5-tunnel in Claude Code?
Run npx skills add reason-machines/trending-skills --skill gooserelayvpn-socks5-tunnel -a claude-code, then open ~/.claude/skills/gooserelayvpn-socks5-tunnel/SKILL.md.
What does gooserelayvpn-socks5-tunnel cover?
Building, configuring and running GooseRelayVPN: key generation, the client and server configs, publishing the Apps Script web app, and the exit server on your VPS.
What do I need before running GooseRelayVPN?
A VPS with TCP 8443 open, an Apps Script web app published for "Anyone", and the same 64-character hex key in both configs. Compiling from source needs Go 1.22 or newer.