gooserelayvpn-android-client

Configure Android VPN profiles tunneling SOCKS5 traffic through Google Apps Script.

4|Updated May 16, 2026
One-click install
npx skills add https://github.com/Aradotso/devtools-skills --skill gooserelayvpn-android-client
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gooserelayvpn-android-client
Source: https://github.com/Aradotso/devtools-skills/tree/main/skills/gooserelayvpn-android-client
Command: npx skills add https://github.com/Aradotso/devtools-skills --skill gooserelayvpn-android-client

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you set up and troubleshoot an Android VPN client that tunnels your traffic through Google Apps Script to a VPS exit server, so you can route traffic securely using profile-based configuration.

Core Features & Use Cases

  • Profile-based VPN configuration: Import/export JSON profiles to manage settings like SOCKS5 host/port, SNI rotation, Apps Script deployment IDs, and the shared tunnel key.
  • Encrypted tunneled transport: Uses AES-256-GCM encryption between the Android client and the VPS exit server.
  • Android VpnService integration: Captures device traffic and forwards it through tun2socks to the local SOCKS5 endpoint for app/browser tunneling.
  • Domain-fronting via Apps Script: Uses Google infrastructure (Apps Script deployments) as the tunnel transport layer.

Use case example: You need an Android device to route selected or all traffic through a VPS while using Apps Script deployments as the transport layer; you can generate keys, configure JSON profiles, and validate connectivity using logs and troubleshooting checks.

Quick Start

Ask your AI to walk you through importing the correct GooseRelay profile JSON on Android and starting the VPN while verifying that your Apps Script deployment IDs and tunnel key match the VPS server configuration.

Frequently Asked Questions about gooserelayvpn-android-client

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure an Android VPN client to tunnel traffic through Google Apps Script?▼

You can configure the Android VPN client by importing a JSON profile that defines SOCKS5 settings, Apps Script deployment IDs, and the shared tunnel key. The VpnService captures traffic and forwards it through tun2socks to route via the Apps Script transport layer.

How does AES-256-GCM encryption work with Android VpnService and tun2socks?▼

AES-256-GCM encryption secures the tunnel between the Android client and the VPS exit server. Android VpnService captures device traffic and forwards it through tun2socks to the local SOCKS5 endpoint, ensuring app and browser traffic is encrypted before exiting.

Why does my Android VPN connection fail with invalid deployment IDs or key mismatches?▼

VPN connection failures often occur when Apps Script deployment IDs in script_keys or the shared tunnel_key do not match the VPS server configuration. Diagnosing common connection failures requires validating the JSON profile settings against the server.

Can I use SNI rotation and domain-fronting with an Android SOCKS5 VPN profile?▼

Yes, you can configure SNI rotation and Google host domain-fronting settings within the JSON VPN profile. This uses Google infrastructure as the tunnel transport layer while routing SOCKS5 traffic through the VPS exit server.

What's the best way to build an Android AAR and APK for a SOCKS5 VpnService tunnel?▼

Building the Android AAR and APK requires wiring Android VpnService with tun2socks to forward traffic to a local SOCKS5 endpoint. You must ensure the client and server share a matching tunnel_key and proper Apps Script deployment IDs.

Do I need a VPS exit server to route Android traffic via Apps Script VPN?▼

Yes, a VPS exit server is required to receive the AES-256-GCM encrypted traffic tunneled from the Android client. The Apps Script deployment acts as the transport layer, forwarding SOCKS5 traffic to the VPS for final routing.