Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add reason-machines/trending-skills --skill gooserelayvpn-socks5-tunnel -a claude-code
Open on GitHub

What 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: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 for the agent

  • 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.

How to install gooserelayvpn-socks5-tunnel

1Skills CLI (Vercel)

npx skills add reason-machines/trending-skills --skill gooserelayvpn-socks5-tunnel -a claude-code

2Manually: put the files in place

~/.claude/skills/gooserelayvpn-socks5-tunnel/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/gooserelayvpn-socks5-tunnel/

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.

Similar skills

All skills for DevOps and infrastructure →

From the same set211

The whole set →
gpt-image-playground gpt-image-playground guides coding agents through building and deploying a React 19 web app for image generation and editing via OpenAI APIs. CX Codex +1 292installs gova-declarative-gui gova-declarative-gui teaches an agent to build native desktop apps in Go with Gova, a declarative framework where components are structs and state lives in a Scope. CX Codex +1 290installs aibijia-price-comparison aibijia-price-comparison guides the setup of scrapers to track and aggregate reseller prices for AI tokens and accounts. Useful when tracking cheap ChatGPT Plus keys. CX Codex +1 287installs aster-bot-trading aster-bot-trading is a Claude Code skill for configuring a TypeScript bot for ASTERUSDT perpetual futures on AsterDEX. It covers strategy and risk settings. CX Codex +1 283installs github-sandbox-file-downloader github-sandbox-file-downloader instructs coding agents to fetch remote files directly into a GitHub repo using formatted commit messages and GitHub Actions workflows. CX Codex +1 279installs gitbackup-github-desktop gitbackup-github-desktop helps configure an Electron desktop app to mirror GitHub repositories locally and upload compressed archives to AWS S3 or Cloudflare R2. CX Codex +1 278installs bux-claude-agent bux-claude-agent runs Claude Code on an Ubuntu VPS with a persistent Chromium session and Telegram control. Useful when browser logins and state must survive restarts. CX Codex +1 277installs illustrated-explainer-spec The illustrated-explainer-spec Claude Code skill specifies a local web app that turns a topic into watercolor-style explanations and opens deeper views when users click the image. CX Codex +1 274installs

Project sponsors

Companies that keep this analytics open