whatisgithub

What is xhttp-installer?

avacocloud/xhttp-installer — explained in plain English

Analysis updated 2026-05-18

★ 510HTMLAudience · ops devopsComplexity · 4/5LicenseSetup · moderate

In one sentence

A bash script that automatically sets up a VLESS proxy server on Ubuntu and hides it behind a free Vercel or Netlify relay.

Mindmap

mindmap
  root((XHTTP Installer))
    What it does
      Sets up VLESS proxy
      Uses XHTTP plus TLS
      Relays via CDN
    Setup steps
      Preflight checks
      Install tools
      Issue SSL cert
      Deploy relay
    Tech stack
      Bash
      Xray-core
      Vercel or Netlify
    Audience
      Server admins
      Self hosters
    Output
      vless connection link
      Install log

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Set up a private VLESS proxy server on a fresh Ubuntu VPS without manual configuration.

USE CASE 2

Hide a proxy server's real IP address behind a Vercel or Netlify relay.

USE CASE 3

Generate a ready-to-use proxy connection link for clients like v2rayN, Nekoray, or Hiddify.

What is it built with?

BashXray-coreNode.jsVercelNetlify

How does it compare?

avacocloud/xhttp-installersxyazi/free-hlsanthropics/launch-your-agent
Stars510612678
LanguageHTMLHTMLHTML
Last pushed—2022-03-312026-07-02
Maintenance—DormantActive
Setup difficultymoderatemoderatemoderate
Complexity4/53/53/5
Audienceops devopsdeveloperpm founder

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires a fresh Ubuntu 20.04+ server with root access plus a Vercel or Netlify account and API token.

So what is it?

XHTTP-Installer is a bash script that automates setting up a VLESS proxy server on an Ubuntu machine, using the XHTTP transport with TLS encryption, and routing traffic through a free relay hosted on Vercel or Netlify. Instead of clients connecting straight to the server, which would expose its IP address and make it easier to detect or block, traffic passes through those well known CDN platforms first, which act as a middleman and hide the real server behind trusted infrastructure. The installer walks through the whole setup in one run. It checks that the system meets requirements, such as running Ubuntu 20.04 or newer with root access and open ports 80 and 443, fixing port conflicts automatically where it can. It installs the needed tools, including the Xray proxy engine, the acme.sh certificate tool, and either the Vercel or Netlify command line tool depending on which platform is chosen. It then obtains a free SSL certificate from Let's Encrypt, configures Xray with a generated identifier, deploys the relay code to the chosen CDN platform using an API token supplied by the user, and runs an end to end connectivity test to confirm everything works before finishing. Running it is a single command that downloads and executes the script directly from GitHub. The script asks a few interactive questions, such as which platform to use, the domain name, and the platform's API token, then completes the rest on its own. When it finishes, it prints a ready to use vless:// connection link along with test results, which can be pasted into compatible client apps such as v2rayN, Nekoray, or Hiddify. A full log of the installation is also saved on the server for troubleshooting.

Copy-paste prompts

Prompt 1
Explain what VLESS, XHTTP, and TLS mean and how they work together in this installer.
Prompt 2
Walk me through what this XHTTP-Installer script does step by step before I run it on my own server.
Prompt 3
What are the risks of running a script directly from the internet with curl and bash, and how do I review it first?
Prompt 4
Compare deploying the relay to Vercel versus Netlify using this installer, and explain the tradeoffs.

Frequently asked questions

What is xhttp-installer?

A bash script that automatically sets up a VLESS proxy server on Ubuntu and hides it behind a free Vercel or Netlify relay.

What language is xhttp-installer written in?

Mainly HTML. The stack also includes Bash, Xray-core, Node.js.

How hard is xhttp-installer to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is xhttp-installer for?

Mainly ops devops.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.

What are similar repos?