Xray & VLESS tutorial

How to Add Proxies to Xray: Turn SOCKS5/HTTP Proxies Into a VLESS Subscription

Add proxies on top of Xray without editing configs. The open-source proxy-to-vless panel installs in one command, ingests your SOCKS5/HTTP proxies, and gives you a country-grouped VLESS + REALITY subscription.

Setup guide2026-07-088 min read
How to Add Proxies to Xray: Turn SOCKS5/HTTP Proxies Into a VLESS Subscription

Key takeaways

proxy-to-vless is a lightweight 3x-ui fork that turns your SOCKS5/HTTP proxies into one VLESS + REALITY subscription.

One install command sets up Xray-core, a random panel port, a secret URL path, admin credentials, and automatic HTTPS.

Paste proxies as host:port:user:pass (or URLs, or port ranges) — the panel auto-detects country by GeoIP and groups servers per country.

A leastPing balancer rotates and fails over between proxies in the same region; import the link into v2rayNG, Hiddify, or NekoBox.

01

What proxy-to-vless does

VLESS + REALITY hides your connection, but by itself the traffic still exits with your server's IP. To make it leave through a proxy of the country you need — residential, ISP, or mobile — you add that proxy 'on top of' Xray. proxy-to-vless is a lightweight, self-hosted panel (a 3x-ui fork) that does exactly this: it converts your upstream SOCKS5 or HTTP proxies into a single VLESS + REALITY subscription.

It also organizes everything for you: servers are grouped per country with automatic GeoIP flags, and a leastPing balancer handles rotation and failover between proxies in the same region. You never open Xray's config.json — the panel generates and manages the Xray config under the hood.

You don't hand-edit Xray at all: install the panel, paste your proxy list, copy one VLESS subscription — done.
02

Before you start

You need a VPS on Ubuntu or Debian with root (or sudo) access, and your SOCKS5/HTTP proxies with their credentials. For automatic HTTPS, point a domain at the server and keep port 80 open — the installer will request a Let's Encrypt certificate. Without a domain the panel still runs, just on its randomized port over plain HTTP.

03

Step 1. Install in one command

SSH into your server and run the one-line installer. It installs Xray-core, builds the panel from source, wires up systemd, and auto-generates a randomized panel port, a secret URL path, and admin credentials. Save the panel URL and login it prints at the end — you'll need them to sign in.

Quick install (Ubuntu/Debian)bash
curl -Ls https://gitlab.com/proxya/proxy-to-vless/-/raw/master/install.sh | sudo bash
Prefer to clone firstbash
git clone https://gitlab.com/proxya/proxy-to-vless.git
cd proxy-to-vless
sudo bash deploy/install-proxyvless.sh
04

Optional: customize the install

You can pin the panel port and admin password up front with environment variables. This is handy if you open a specific port in your firewall or want a known login from the start.

Set a fixed port and admin passwordbash
curl -Ls https://gitlab.com/proxya/proxy-to-vless/-/raw/master/install.sh \
  | sudo PANEL_PORT=8443 ADMIN_PASS='YourStrongPass' bash
05

Step 2. Add your proxies

Open the panel URL, sign in, and go to the Proxy → VLESS tab. Create a connection and paste your proxy list. The panel accepts several formats, detects each proxy's country by GeoIP, and groups the resulting servers per country automatically.

Supported proxy formats (paste one per line)text
# host:port:user:pass
1.2.3.4:1080:user:pass

# SOCKS5 / HTTP URL
socks5://user:pass@1.2.3.4:1080
http://user:pass@1.2.3.4:8080

# port range — one server per port
1.2.3.4:10000-10100:user:pass
06

Step 3. Copy the subscription and import it

Copy the subscription link the panel generates and import it into any VLESS + REALITY client — v2rayNG, Hiddify, or NekoBox. Your proxies show up as servers grouped by country with GeoIP flags, and when several proxies share a region the leastPing balancer picks the fastest live one and fails over automatically.

That's the whole flow: install once, paste proxies, copy the link. No manual Xray outbound or routing edits — the panel keeps the Xray config in sync as you add or remove proxies.

07

Where to get the proxies

proxy-to-vless turns proxies into a VLESS subscription, but you still supply the proxies. If you need clean exit IPs, grab residential, ISP, or datacenter proxies from Proxya and paste them straight into the panel. The panel itself is open-source (GPL-3.0), built on the 3x-ui foundation by MHSanaei and Xray-core — the full source and docs are in the GitLab repo.

Frequently asked

No. proxy-to-vless installs and manages Xray-core for you. You only paste a proxy list in the panel and copy the generated subscription — the Xray config is written and kept in sync automatically.

Any SOCKS5 or HTTP proxy with a host, port and optional user:pass — residential, ISP, mobile, or datacenter. The panel detects each proxy's country automatically via GeoIP.

host:port:user:pass, standard socks5:// or http:// URLs, and port ranges like host:10000-10100:user:pass, which create one server per port.

For several proxies in the same country the panel applies a leastPing balancer, so traffic uses the fastest live proxy and fails over automatically if one goes down.

Yes — when port 80 is reachable the installer issues a Let's Encrypt certificate via acme.sh and auto-renews it. Without a domain the panel runs on its randomized port over HTTP.

Any VLESS + REALITY client: v2rayNG, Hiddify, NekoBox and compatible apps. Servers appear grouped by country with GeoIP flags.