English | Русский
Run your own Xray VPN in 10 minutes using AI agent
Set up an Xray VLESS VPN on your own server or VPS with one command, using the 3X-UI panel for installation and management.
You need:
- a VPS running Ubuntu 24 or newer at any hosting provider
1 vCPU512 MB memory10 GB disk space- about
10 minutes
The canonical skill bundle lives in skills/3x-ui-vps/.
Architecture details: skills/3x-ui-vps/references/architecture.md
This repository root is also a Claude Code plugin with namespace 3x-ui-vpn-skills. The 3x-ui-vps skill inside it is manual-first because it changes remote infrastructure.
What The Skill Can Do
The skill includes 5 workflows:
Fresh deploy configures your server from scratch, including dependency installation, port hardening, and base setup.Panel access opens an SSH tunnel from the server to your computer so you can access the 3X UI panel.Quick inbound bootstrap creates an Xray VLESS inbound on port 443 with nginx in front of it.Add another client to an existing inbound adds a client to an existing inbound so you can connect one more device.Updates updates the system (apt update and apt upgrade) and 3X UI.
How To Use It
Install the skill using the instructions below and then use it in chat.
Examples:
Codex: $3x-ui-vps, set up a VPN for meClaude Code: /3x-ui-vpn-skills:3x-ui-vps set up a VPN for meCursor: Set up a VPN for me using the instructions in AGENTS.mdOpenClaw: Set up a VPN for me using the 3x-ui-vps skill
Example prompt:
$3x-ui-vps, set up a VPN for me
Information You Will Be Asked For
After launch, the skill will ask for additional information:
SSH target: the SSH user and IP in the format root@X.Y.Z.A; the root user is required to install all dependenciesSSH password: the root password; not needed if key-based authentication is already configuredDomain: your domain or subdomain where the VPN will be set up; buy any domain from a domain sellerPanel Username: the username for the 3X UI panelPanel Password: the password for the 3X UI panelACME Email: your email for issuing a Let's Encrypt SSL certificate for the domain above; optional
Included Files
Install In Any Agent Skills-Compatible System
Use the prompt:
Please, install this skill: https://github.com/olegtsvetkov/3x-ui-vpn-skill
Install In Claude Code or Cowork
Install it from the Claude plugin UI or with the CLI:
claude plugin marketplace add olegtsvetkov/3x-ui-vpn-skill
claude plugin install 3x-ui-vpn-skills@3x-ui-vpn-skills
Then invoke the skill with:
/3x-ui-vpn-skills:3x-ui-vps
Install In Codex
The simplest path inside Codex is the built-in $skill-installer:
$skill-installer install https://github.com/olegtsvetkov/3x-ui-vpn-skill/tree/master/skills/3x-ui-vps
Manual installation still works through $CODEX_HOME/skills (usually ~/.codex/skills):
- Copy or clone
skills/3x-ui-vps/ into $CODEX_HOME/skills/3x-ui-vps.
- Restart Codex.
Compatibility note:
- the built-in
$skill-installer currently installs into $CODEX_HOME/skills by default
- this repo also exposes
.agents/skills for repo-scoped compatibility with AGENTS-style discovery flows
Install In Cursor
Use the /create-skill prompt:
/create-skill Please, install this skill to Cursor: https://github.com/olegtsvetkov/3x-ui-vpn-skill
OpenClaw Compatibility
Install it with clawhub:
clawhub install 3x-ui-vps
Or use the prompt:
Please, install this skill: https://github.com/olegtsvetkov/3x-ui-vpn-skill
Usage Notes