Team
881fbf6dbb
- lessons-learned: add two critical issues from first real deployment 1. client enable:false causes auto-removal by x-ui scheduler 2. CF proxy strips Connection header, nginx must hardcode WS headers - xray-inbound-config.md: fix API path, add enable:true to client, hardcode Upgrade/Connection headers in nginx WS location
xui-deploy
Automates installing and configuring 3x-ui (Xray panel) on a remote VPS over SSH.
Architecture
Workflow
When to Use
Activate this skill when the user wants to:
- Deploy or install x-ui / 3x-ui on a VPS
- Set up an Xray proxy panel
- Update an existing x-ui installation
- Configure panel port, credentials, or base path
Trigger phrases: deploy x-ui, install x-ui, setup xui, install 3x-ui, xray panel, 部署x-ui, 安装x-ui, 搭建xui, xray面板
How It Works
- Collects VPS host, SSH credentials, and panel settings from the user
- Tests SSH connectivity and checks OS compatibility
- Runs the official 3x-ui one-line installer (handles fresh install and updates)
- Configures panel port, username, password, and web base path via
x-uiCLI - Restarts the service and verifies it is running
- Opens the panel port in the system firewall (ufw or firewalld)
- Reports the panel URL and credentials
File Structure
xui-deploy/
├── SKILL.md # Instructions for the agent
├── evals/
│ └── evals.json # 4 test cases
└── assets/
├── architecture.puml
├── xui-deploy-architecture.svg
├── workflow.puml
└── xui-deploy-workflow.svg
Evals
python scripts/run_evals.py xui-deploy