{"id":51475951,"url":"https://github.com/superchaospc/xray-relay-deploy","last_synced_at":"2026-07-06T21:00:53.749Z","repository":{"id":364037546,"uuid":"1266112668","full_name":"superchaospc/xray-relay-deploy","owner":"superchaospc","description":"🛰️ Claude Code / Codex skill 驱动 xray-relay 一键 VLESS+REALITY(TCP+XTLS-Vision)中转脚本(SSH 非交互操作 16 项菜单)· A CC/Codex skill that deploys \u0026 operates the xray-relay script over SSH","archived":false,"fork":false,"pushed_at":"2026-06-11T10:33:17.000Z","size":11,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-11T12:14:56.437Z","etag":null,"topics":["agent-skills","claude","claude-code","codex","reality","skill","vless","xray","xtls-vision"],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/superchaospc.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-11T10:29:53.000Z","updated_at":"2026-06-11T10:33:21.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/superchaospc/xray-relay-deploy","commit_stats":null,"previous_names":["superchaospc/xray-relay-deploy"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/superchaospc/xray-relay-deploy","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/superchaospc%2Fxray-relay-deploy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/superchaospc%2Fxray-relay-deploy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/superchaospc%2Fxray-relay-deploy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/superchaospc%2Fxray-relay-deploy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/superchaospc","download_url":"https://codeload.github.com/superchaospc/xray-relay-deploy/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/superchaospc%2Fxray-relay-deploy/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35205739,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-06T02:00:07.184Z","response_time":106,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-skills","claude","claude-code","codex","reality","skill","vless","xray","xtls-vision"],"created_at":"2026-07-06T21:00:53.114Z","updated_at":"2026-07-06T21:00:53.743Z","avatar_url":"https://github.com/superchaospc.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# xray-relay-deploy\n\n[![Release](https://img.shields.io/github/v/release/superchaospc/xray-relay-deploy?sort=semver)](https://github.com/superchaospc/xray-relay-deploy/releases)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n![Claude Code](https://img.shields.io/badge/Claude%20Code-skill-d97757)\n![Codex](https://img.shields.io/badge/Codex-skill-412991)\n![Shell](https://img.shields.io/badge/shell-bash-4EAA25?logo=gnu-bash\u0026logoColor=white)\n\n**English** | [中文说明](#中文说明)\n\nA **Claude Code / Codex skill** that installs and remotely operates the\n[`xray-relay`](https://github.com/superchaospc/xray-relay) one-click\n**VLESS + REALITY** relay script (TCP + XTLS-Vision transport) on a VPS over SSH. It\ndrives the script's 16-item interactive menu **non-interactively** by feeding stdin over\nSSH — it does **not** reimplement any relay logic.\n\nThis is the sibling of\n[`xray-xhttp-relay-deploy`](https://github.com/superchaospc/xray-xhttp-relay-deploy),\nwhich drives the XHTTP+REALITY variant. Same drive-the-menu mechanism; this one targets\nthe **TCP + XTLS-Vision** transport. (The XHTTP sibling shares the identical 16-item menu\nand was live-tested 16/16 on a real VPS, which cross-validates these sequences.)\n\n## What it does\n\nOnce installed, the skill lets the agent — on a VPS you name (SSH alias or host) —\n\n- **deploy** a fresh VLESS+REALITY relay (residential SOCKS5 multi-hop or VPS-direct)\n- **manage nodes**: add / delete / rename, single or batch (menus 2, 3, 12–16)\n- **operate**: status, traffic, diagnostics, change port, update/restart Xray, monitoring/email alerts, uninstall\n- **retrieve** the generated VLESS links and subscription\n\nThe mechanism: the script reads every prompt through `prompt_read`, which exits cleanly\non stdin EOF, so a fixed answer sequence drives any menu function. The exact sequence for\neach menu item lives in [`references/menu-actions.md`](references/menu-actions.md).\n\n## Install (Claude Code + Codex)\n\n```bash\n# 1. Clone into Claude Code's skills dir\ngit clone https://github.com/superchaospc/xray-relay-deploy \\\n  ~/.claude/skills/xray-relay-deploy\n\n# 2. To use it in Codex too, run the bundled installer once\n~/.claude/skills/xray-relay-deploy/install.sh\n```\n\nClaude Code and Codex share the same `SKILL.md` format — `install.sh` just symlinks the\nskill into Codex's dirs (`~/.codex/skills`, `~/.agents/skills`). Self-contained, portable\n(uninstalled agents skipped), idempotent. Restart Codex so it rescans.\n\nThe skill triggers on phrases like \"在 vps 上装一下中转脚本\", \"给 japan 加几个直连节点\",\n\"看下 vps1 的流量\", \"部署 xray 中转\", \"批量加住宅节点\".\n\n## Authorization \u0026 safety\n\nThis skill operates the user's **own** script on the user's **own** VPS — that's the\nintended use. Destructive functions (delete / change-port / uninstall / fresh-install,\nwhich overwrites a live config) are gated: the skill shows exactly what it will run and on\nwhich target, and waits for confirmation before sending.\n\n---\n\n## 中文说明\n\n一个 **Claude Code / Codex skill**,通过 SSH 在 VPS 上安装并远程操作\n[`xray-relay`](https://github.com/superchaospc/xray-relay) 一键 **VLESS + REALITY** 中转脚本\n(TCP + XTLS-Vision 传输)。它**非交互地**驱动脚本的 16 项交互菜单(通过 SSH 喂 stdin),\n**不重新实现**任何中转逻辑。\n\n它是 [`xray-xhttp-relay-deploy`](https://github.com/superchaospc/xray-xhttp-relay-deploy)\n(驱动 XHTTP+REALITY 版)的姊妹 skill。驱动机制相同,这个针对 **TCP + XTLS-Vision** 传输。\n(XHTTP 姊妹版共用完全相同的 16 项菜单,且已在真实 VPS 上 16/16 实测通过,反向印证了这里的序列。)\n\n### 能做什么\n\n装上后,agent 可以在你指定的 VPS(SSH 别名或主机)上:\n\n- **部署**全新 VLESS+REALITY 中转(住宅 SOCKS5 多跳 或 VPS 直连)\n- **管理节点**:单条/批量 添加、删除、改名(菜单 2、3、12–16)\n- **运维**:状态、流量、诊断、改端口、更新/重启 Xray、监控邮件告警、卸载\n- **取回**生成的 VLESS 链接和订阅\n\n原理:脚本每个 prompt 都经 `prompt_read` 读取,stdin 到 EOF 时干净退出,所以一串固定答案就能\n驱动任意菜单功能。每个菜单项的精确序列见\n[`references/menu-actions.md`](references/menu-actions.md)。\n\n### 安装(Claude Code + Codex)\n\n```bash\n# 1. clone 到 Claude Code 的 skills 目录\ngit clone https://github.com/superchaospc/xray-relay-deploy \\\n  ~/.claude/skills/xray-relay-deploy\n\n# 2. 想在 Codex 里也能用,再跑一次自带安装脚本\n~/.claude/skills/xray-relay-deploy/install.sh\n```\n\nCC 和 Codex 用同一种 `SKILL.md` 格式,`install.sh` 只是把 skill 软链进 Codex 的目录\n(`~/.codex/skills`、`~/.agents/skills`)。自包含、可移植(没装的 agent 自动跳过)、幂等。\n完成后重开 Codex 让它重新扫描。\n\n触发词例如:\"在 vps 上装一下中转脚本\"、\"给 japan 加几个直连节点\"、\"看下 vps1 的流量\"、\n\"部署 xray 中转\"、\"批量加住宅节点\"。\n\n### 授权与安全\n\n本 skill 操作的是你**自己的**脚本、你**自己的** VPS——这正是它的预期用途。破坏性功能(删节点 /\n改端口 / 卸载 / 全新安装——后者会覆盖 live 配置)都有确认门槛:skill 会先展示将要执行的命令和\n目标,经你确认后才发送。\n\n## License\n\n[MIT](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsuperchaospc%2Fxray-relay-deploy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsuperchaospc%2Fxray-relay-deploy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsuperchaospc%2Fxray-relay-deploy/lists"}