Vercel Xhttp Relay

If you're running Xray or V2Ray and need to hide your origin server IP from censors, this skill walks you through deploying a relay on Vercel Edge Functions. The setup streams XHTTP traffic from your client through Vercel's CDN to your backend VPS without buffering, so Vercel's domain faces the internet instead of yours. It covers the full stack: installing Xray 1.8.16+ on Ubuntu, getting TLS certificates with acme.sh, configuring the XHTTP inbound on port 443, writing the 30-line Edge Function relay, and wiring up v2rayN clients with the right SNI and path. Works on Vercel's free tier for light personal use. Note that only XHTTP is supported here, no WebSocket or gRPC, since those don't play well with Edge runtime.

skills.sh installs: 180
GitHub stars: 26
last updated: Jun 3, 2026

View on GitHub

Install

$ npx -y skills add aradotso/trending-skills --skill vercel-xhttp-relay --agent claude-code

Installs into .claude/skills of the current project.

Files

Vercel XHTTP Relay

Skill by ara.so — Daily 2026 Skills collection.

A minimal Vercel Edge Function relay that forwards XHTTP traffic from Xray/V2Ray clients to a backend Xray server. Vercel's *.vercel.app domain acts as a CDN front, hiding your origin VPS IP from censors.

Architecture

Client (v2rayN/Hiddify)
  → TLS (SNI=vercel.com) to *.vercel.app
    → Vercel Edge Function (relay, no buffer)
      → HTTP/2 to backend Xray XHTTP inbound

Supported transports: XHTTP only
Not supported on Vercel Edge: WebSocket, gRPC, TCP, mKCP, QUIC, Reality

Prerequisites

Linux VPS outside Iran (Ubuntu 22.04/24.04 recommended), min 1 vCPU / 1 GB RAM
A domain with an A record pointing to your VPS (DNS only, not proxied)
Vercel account (free Hobby tier works for light personal use)
Node.js + npm installed locally (for Vercel CLI)
Xray v1.8.16+ installed on VPS

Step 1 — Install Xray on VPS

# Update system
apt update && apt upgrade -y
apt install -y curl socat cron ufw

# Install Xray via official script
bash -c "$(curl -L https://github.com/XTLS/Xray-install/raw/main/install-release.sh)" @ install

SKILL.md on GitHub