XHTTP-Installer/README_EN.md at main · V2RAYCONFIGSPOOL/XHTTP-Installer

🌐 Automated VLESS + XHTTP + TLS Proxy with Vercel/Netlify CDN Relay

⚡ One-line install

bash <(curl -fsSL https://raw.githubusercontent.com/avacocloud/XHTTP-Installer/main/install.sh)

✨ What is this?

A one-command installer for VLESS + XHTTP + TLS proxy on Ubuntu, using free Vercel or Netlify CDN as the relay layer.

Tip

Instead of clients connecting directly to your server (which exposes your IP), traffic flows through an Edge Function on a well-known CDN platform — your real server IP stays hidden.

🎯 Why this installer?

Feature	Description
🌐 No network domain needed	Just a simple subdomain with an A record
🛠️ Zero CLI hassle	Vercel CLI & Netlify CLI installed and authenticated automatically
🐛 Smart Auto-Fix	Detects and resolves SSL, firewall, token, and ENV issues
✅ End-to-end validation	Uses `xray-knife` to verify the generated config actually works
🔄 Auto-retry on failure	Re-attempts deploy/SSL with corrective fixes
🛡️ Hides server IP	Only the CDN edge is exposed publicly
🔐 Auto SSL	Let's Encrypt certificate via acme.sh
🇮🇷 Iran-friendly	Works without a VPN during installation

🔄 How it works

Architecture

flowchart LR
    A["📱 Client<br/>v2rayN · Nekoray · Hiddify"] -->|"VLESS + XHTTP + TLS"| B
    B["🌐 CDN Edge<br/>Vercel / Netlify<br/><i>relay.js</i>"] -->|"HTTPS proxy<br/>TARGET_DOMAIN"| C
    C["🔐 Xray Server<br/>VLESS+XHTTP<br/>Port 443"] -->|"forward"| D["🌍 Internet"]

    style A fill:#1e293b,stroke:#06b6d4,stroke-width:2px,color:#fff
    style B fill:#0f172a,stroke:#fbbf24,stroke-width:2px,color:#fff
    style C fill:#1e293b,stroke:#a855f7,stroke-width:2px,color:#fff
    style D fill:#0f172a,stroke:#10b981,stroke-width:2px,color:#fff

Note

The CDN is the public layer, your Xray server is hidden. The outside world only sees the CDN domain.

Automation phases

flowchart TD
    Start([🚀 Start]) --> P1
    P1["1️⃣ Preflight<br/>OS · Root · DNS · Ports"] --> P2
    P2["2️⃣ Install Tools<br/>Xray · acme.sh · CLIs · xray-knife"] --> P3
    P3["3️⃣ Collect Inputs<br/>Platform · Domain · Token"] --> P4A
    P4A["4️⃣ Issue SSL<br/>Let's Encrypt via acme.sh"] --> P4B
    P4B["5️⃣ Configure Xray<br/>VLESS + XHTTP + TLS"] --> P4C
    P4C{Platform?}
    P4C -->|Vercel| V["🔵 Vercel Deploy<br/>vercel env + deploy"]
    P4C -->|Netlify| N["🟢 Netlify Deploy<br/>netlify env + deploy"]
    V --> P5
    N --> P5
    P5["7️⃣ E2E Test<br/>xray-knife + ping"] --> P6
    P6["8️⃣ Generate Config<br/>vless:// link"] --> Done([✅ Done])

    style Start fill:#00d97e,stroke:#0a1a1f,stroke-width:2px,color:#0a1a1f
    style Done fill:#00d97e,stroke:#0a1a1f,stroke-width:2px,color:#0a1a1f
    style P1 fill:#1e293b,stroke:#06b6d4,color:#fff
    style P2 fill:#1e293b,stroke:#06b6d4,color:#fff
    style P3 fill:#1e293b,stroke:#06b6d4,color:#fff
    style P4A fill:#1e293b,stroke:#a855f7,color:#fff
    style P4B fill:#1e293b,stroke:#a855f7,color:#fff
    style P4C fill:#0f172a,stroke:#fbbf24,stroke-width:2px,color:#fff
    style V fill:#0a0a0a,stroke:#ffffff,color:#fff
    style N fill:#004d47,stroke:#00C7B7,color:#fff
    style P5 fill:#1e293b,stroke:#10b981,color:#fff
    style P6 fill:#1e293b,stroke:#10b981,color:#fff

1️⃣ Phase 1 — Preflight

Verifies the server is ready:

✅ OS is Ubuntu 20.04+
✅ Running as root
✅ Internet connectivity OK
✅ Ports 80 and 443 are free (auto-fix if not)
✅ DNS is pointed correctly

2️⃣ Phase 2 — Install tools

Installs everything automatically:

Tool	Purpose
Xray-core	Proxy core (VLESS+XHTTP)
acme.sh	Let's Encrypt SSL certificate
Node.js + npm	Required for platform CLIs
Vercel CLI	If you picked Vercel
Netlify CLI	If you picked Netlify
xray-knife	End-to-end config validator
curl, jq, unzip, screen	Utilities

[!NOTE] No need to pre-install any CLI — the script handles install + auth.

3️⃣ Phase 3 — Collect inputs

Interactively asks for:

Question	Example	Required?
Platform	Vercel / Netlify	✅
Domain	`ns.example.com`	✅
SSL email	`admin@example.com`	⬜ (default)
Xray port	`443`	⬜ (default)
Relay path	`/api`	⬜ (default)
Platform token	Vercel/Netlify token	✅
Project name	`relay-abc123`	⬜ (random)

4️⃣ Phase 4a — Issue SSL certificate

🔐 Gets cert from Let's Encrypt via acme.sh
📁 Stores it in /etc/ssl/xhttp/<domain>/
🔄 Auto-fix if port 80 is busy
♻️ Enables auto-renewal

5️⃣ Phase 4b — Configure Xray

🎲 Generates a unique UUID
📝 Writes /usr/local/etc/xray/config.json with VLESS+XHTTP+TLS
🔑 Fixes SSL file permissions for Xray
🚀 Starts and enables the Xray service
✅ Verifies the service is running healthy

6️⃣ Phase 4c — Deploy to CDN

Based on the selected platform:

🔵 Vercel:

Login with token → vercel login
Create project → vercel project add
Set ENV: TARGET_DOMAIN, UPSTREAM_PROTOCOL, RELAY_PATH
Deploy production → vercel deploy --prod

🟢 Netlify:

Login with token → netlify login
Create site → netlify sites:create
Set ENV: TARGET_DOMAIN
Deploy with Edge Function → netlify deploy --prod

[!TIP] If deploy fails, auto-fix retries it after resolving the previous issue (ENV, duplicate name, token).

7️⃣ Phase 5 — End-to-end test

🧪 Creates a temporary xray client with xray-knife
🌐 Routes real traffic: CDN → Server → Internet
⏱️ Measures ping (min/avg/max)
✅ Confirms the config actually works before handing it to you

8️⃣ Phase 6 — Generate final config

📋 vless://... link ready to copy
📊 Full report: relay URL, UUID, test result, ping, quality
💾 Full log at /tmp/xhttp-install.log

📋 Requirements

1. Ubuntu Server

OS: Ubuntu 20.04+ (22.04 recommended)
Access: root or sudo
Ports: 80 (for SSL) and 443 (for relay)
Min resources: 1 vCPU + 1 GB RAM

Important

Make sure ports 80 and 443 are free. If you have nginx/apache running on them, stop those services first.

2. Domain with DNS

A subdomain with an A record pointing to your server IP:

ns.example.com  →  YOUR_SERVER_IP

3. CDN Token (one of)

🔵 Vercel Token

https://vercel.com/account/tokens

→ Create Token → name it → copy

🟢 Netlify Token

https://app.netlify.com/user/applications#personal-access-tokens

→ New access token → name it → copy

🚀 Quick Start

📥 Step 1 — One-line install

SSH into your server and run:

bash <(curl -fsSL https://raw.githubusercontent.com/avacocloud/XHTTP-Installer/main/install.sh)

Tip

This installs git, clones the repo into /root/XHTTP-Installer, and runs Deploy-Ubuntu.sh for you.

Alternative methods

Manual git clone:

git clone https://github.com/avacocloud/XHTTP-Installer.git /root/XHTTP-Installer
cd /root/XHTTP-Installer
sudo bash Deploy-Ubuntu.sh

Offline zip:

scp XHTTP-Installer.zip root@SERVER_IP:/root/
ssh root@SERVER_IP
cd /root && unzip XHTTP-Installer.zip && sudo bash Deploy-Ubuntu.sh

The script first asks if you want to run inside screen:

If your internet is unstable or SSH drops often → press Y. If SSH drops mid-install:
```
ssh root@SERVER_IP
screen -r xhttp
```
If your connection is stable → press n and continue directly

Tip

If SSH drops while inside screen, just reconnect and run screen -r xhttp to resume.

🎯 Step 2 — Choose platform

[ Deployment Platform ]
Choose relay platform:
  1) Vercel
  2) Netlify
Enter choice [1/2]:

⚙️ Step 3 — Provide info

The script asks step by step. Pressing Enter accepts the default:

Question	Description	Example / Default
Domain	Subdomain pointing to your server IP	`ns.example.com`
Email	For SSL certificate (optional)	`admin@ns.example.com`
Inbound port	Port Xray listens on	`443`
RELAY_PATH	Inbound path on server	`/api`
PUBLIC_RELAY_PATH	Relay path on CDN	`/api`
Token	Vercel or Netlify token	paste it
Project name	CDN site name (random by default)	`relay-abc123`
Performance settings	Vercel only (Enter = default)	`128`, `50000`, ...

🎉 Step 4 — Wait and grab the config

╔══════════════════════════════════════════╗
║       INSTALLATION COMPLETE  ✔         ║
╚══════════════════════════════════════════╝

  Platform         : netlify
  Relay URL        : https://your-site.netlify.app
  
  E2E Proxy Test   : ✔ PASS
  Ping (min/avg/max): 395/424/480 ms
  Quality          : Good

── Client Config ──

vless://xxxxxxxx...@your-site.netlify.app:443?...#XHTTP-netlify

✅ Copy the vless://... link.

📱 Use the config

Platform	App	How
🪟 Windows	v2rayN	Servers → Import bulk URL from clipboard
🤖 Android	v2rayNG	+ → Import config from clipboard
🍎 iOS	Streisand (App Store)	Auto-detects from clipboard
🐧 Linux	Nekoray	Program → Add profile from clipboard
🌐 All	Hiddify	Add → Add from Clipboard

🛠️ Script Features

🤖 Smart Auto-Fix

Issue	Auto-Fix
Port 80 busy	Kills the process
Firewall blocking	`ufw allow` automatic
Xray + SSL key permission	`chmod` + `chgrp` automatic
systemd service issue	drop-in override
Invalid token	Re-prompts for new token
Netlify duplicate name	New random name

🧪 End-to-End Test

After deploy, the script tests the proxy with a temporary xray client:

✔ VLESS+XHTTP WORKS END-TO-END
  HTTP 204 in 0.475s — proxy is functional
  Ping (min/avg/max): 395/424/480 ms (through VLESS)
  Quality: Good

So before you even open your client, you know the proxy works.

🐛 Troubleshooting

❌ Xray "permission denied" on privkey.pem

The script auto-fixes this via a systemd drop-in. Manual fix:

chmod 640 /etc/ssl/xhttp/YOUR_DOMAIN/privkey.pem
chgrp nobody /etc/ssl/xhttp/YOUR_DOMAIN/privkey.pem

❌ HTTP 500 from Netlify (Misconfigured)

TARGET_DOMAIN env var not set. Auto-retry usually fixes it. Manual:

cd /root/deploy/netlify
netlify env:set TARGET_DOMAIN "https://YOUR_DOMAIN:443" \
  --scope functions --context production --site SITE_ID
netlify deploy --prod

❌ HTTP 404 from relay

Normal for non-VLESS requests. curl returns 404 because it doesn't send a VLESS handshake. Real clients (v2rayN, Nekoray, ...) work fine.

📝 Full log

tail -f /tmp/xhttp-install.log

🛡️ Ethics

Warning

This project is built only to bypass unjust restrictions and protect privacy.

❌ Do not use it for malicious activity, attacks, or violating others' privacy.

❌ Do not use third-party domains/tokens without permission.

✅ Run it only on your own server and CDN account.

📜 License & Copyright

This project is licensed under the GNU GPL-3.0.

Important

✅ Personal and commercial use is allowed ✅ Modification and forking is allowed

❗ However, any copy, fork, or redistribution MUST preserve:

📌 A link to the original repo: https://github.com/avacocloud/XHTTP-Installer
📌 Attribution to @avaco_cloud as the original author
📌 The LICENSE file unchanged

❌ Removing or altering these is a copyright violation and will result in a DMCA takedown.

If you find someone using this code without complying with the license, contact @avaco_cloud.

💖 Support

If this project helped you, consider a crypto donation:

Cryptocurrency & Bitcoin donation button by NOWPayments

🙏 Acknowledgments

Special thanks to these amazing developers for their inspiration and contributions:

@amirshaker000

@B3hnamR

💬 Questions?

📢 Telegram: @avaco_cloud

If you find this project useful, give it a ⭐ and share it!

Made with ❤️ by @avaco_cloud

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

🌐 Automated VLESS + XHTTP + TLS Proxy with Vercel/Netlify CDN Relay

⚡ One-line install

✨ What is this?

🎯 Why this installer?

🔄 How it works

Architecture

Automation phases

📋 Requirements

1. Ubuntu Server

2. Domain with DNS

3. CDN Token (one of)

🔵 Vercel Token

🟢 Netlify Token

🚀 Quick Start

📥 Step 1 — One-line install

🎯 Step 2 — Choose platform

⚙️ Step 3 — Provide info

🎉 Step 4 — Wait and grab the config

📱 Use the config

🛠️ Script Features

🤖 Smart Auto-Fix

🧪 End-to-End Test

🐛 Troubleshooting

🛡️ Ethics

📜 License & Copyright

💖 Support

🙏 Acknowledgments

💬 Questions?

FilesExpand file tree

README_EN.md

Latest commit

History

README_EN.md

File metadata and controls

🌐 Automated VLESS + XHTTP + TLS Proxy with Vercel/Netlify CDN Relay

⚡ One-line install

✨ What is this?

🎯 Why this installer?

🔄 How it works

Architecture

Automation phases

📋 Requirements

1. Ubuntu Server

2. Domain with DNS

3. CDN Token (one of)

🔵 Vercel Token

🟢 Netlify Token

🚀 Quick Start

📥 Step 1 — One-line install

🎯 Step 2 — Choose platform

⚙️ Step 3 — Provide info

🎉 Step 4 — Wait and grab the config

📱 Use the config

🛠️ Script Features

🤖 Smart Auto-Fix

🧪 End-to-End Test

🐛 Troubleshooting

🛡️ Ethics

📜 License & Copyright

💖 Support

🙏 Acknowledgments

💬 Questions?