3X-UI на своем VPS
3x-ui-vps
Скилл, который разворачивает панель 3X-UI и Xray VLESS за nginx на Ubuntu-сервере и затем обслуживает его через готовые скрипты
- 31 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Работает с root-доступом по SSH к удаленному серверу
- Устанавливает пакеты, меняет правила файрвола и конфигурацию nginx
- Может запрашивать пароль root в открытом виде
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/3x-ui-vpsОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Работает с root-доступом по SSH к удаленному серверу
- Устанавливает пакеты, меняет правила файрвола и конфигурацию nginx
- Может запрашивать пароль root в открытом виде
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Скилл настраивает VPS с нуля: ставит зависимости, закрывает лишние порты через ufw, поднимает 3X-UI в Docker Compose и nginx на портах 80 и 443 с сертификатом Let's Encrypt. Панель и сервер подписок слушают только loopback, доступ к панели идет через SSH-туннель. Есть пять сценариев: первичная установка, доступ к панели, создание VLESS inbound, добавление клиента и обновления. Все изменения на сервере выполняются только через скрипты из комплекта.
Для кого. Тем, у кого есть VPS и домен и кто хочет поднять собственный Xray-сервер без ручной настройки nginx и Docker.
Подходит, если
- Нужно установить 3X-UI на чистый сервер Ubuntu или Debian
- Нужно добавить еще одного клиента в существующий inbound
- Нужно безопасно обновить систему и контейнер 3X-UI
- Нужен доступ к панели через SSH-туннель
Не подходит, если
- Сервер работает не на Ubuntu или Debian
- Нет root-доступа по SSH или домена, направленного на сервер
Пример запроса к агенту
/3x-ui-vpn-skills:3x-ui-vps разверни VPN на root@203.0.113.10 с доменом vpn.example.comОграничения
Рассчитан на Ubuntu 24+ или Debian с apt и root-пользователя. Домен должен заранее указывать на сервер. Серверу и рабочей машине нужен исходящий интернет для Docker, ACME и API панели. Автоматический вызов моделью отключен, скилл запускается только явно.
Как отключить. В Claude Code удалите плагин через /plugin. В Codex удалите папку 3x-ui-vps из $CODEX_HOME/skills.
Частые вопросы
Какой сервер нужен?
VPS на Ubuntu 24 или новее с 1 vCPU, 512 МБ памяти и 10 ГБ диска.
Какие данные спросит скилл?
SSH-адрес вида root@IP, пароль root, если нет ключа, домен, логин и пароль для панели и, по желанию, email для сертификата.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыCLI на Go сравнивает сервер с прошлым снимком, сообщает только значимые перемены и отдает их агенту через MCP
Скилл переезда с Lovable на Cloud.ru
ru-deploy
Скилл для Claude Code и Codex, который пошагово переносит проект с Lovable на сервер Cloud.ru: self-hosted Supabase, HTTPS, домен, почта, платежи YooKassa
Туннель для localhost с собственным реле: публичный HTTPS-адрес для локального сервиса без аккаунта, плюс скиллы для агентов
Песочница для ИИ-агента с 1С
1c-ai-sandbox-client-server
Devcontainer и Hyper-V VM с сервером 1С, изолирующие ИИ-агента от хостовой машины, чтобы ошибочная команда не задела реальные файлы и диски
MCP-сервер для Proxmox VE: управление виртуалками, LXC, снапшотами и бэкапами из агента с контролем прав и одобрением команд
Веб-дашборд в одном Docker-контейнере для мониторинга и управления флотом MCP-серверов 1С: статус, прогресс индексации, VRAM и лицензии
Коротко о README
Репозиторий содержит скилл 3x-ui-vps и одновременно служит плагином Claude Code с пространством имен 3x-ui-vpn-skills. Скилл ставит Xray VLESS через панель 3X-UI примерно за 10 минут на VPS с Ubuntu. Клиенты подключаются по VLESS с транспортом XHTTP через nginx, панель доступна только локально. Описана установка в Claude Code, Codex, Cursor и OpenClaw. Лицензия MIT.
Бейдж для README
Исходный SKILL.md
---
name: 3x-ui-vps
description: Deploy and manage 3X-UI on a root-managed Ubuntu or Debian VPS using Docker Compose, nginx, ACME certificates, SSH panel tunneling, UFW hardening, and Xray VLESS over XHTTP behind nginx. Use when the user explicitly wants to install 3X-UI from scratch, lock the panel and subscription server to 127.0.0.1, open an SSH tunnel to the panel, create or repair a VLESS inbound behind nginx on public 443, add extra clients to an existing inbound, or run safe OS and container updates.
disable-model-invocation: true
metadata:
openclaw:
requires:
bins:
- bash
- python3
- ssh
---
# 3X-UI VPS
Deploy 3X-UI on a VPS with the panel and subscription server bound to loopback, `ufw` allowing only SSH/HTTP/HTTPS, nginx on public `80/443`, and one `VLESS + XHTTP` transport routed through nginx.
This skill is manual-first because it mutates remote infrastructure. Invoke it only when the user explicitly asks to deploy, repair, harden, or update a VPS.
## Hard rule
- All server-side configuration must be executed only through the bundled scripts in this skill.
- Do not create or edit remote configs manually over SSH, do not run ad-hoc heredocs on the server, and do not "quick-fix" nginx, Docker, ACME, or 3X-UI by hand.
- Read-only inspection commands are allowed for diagnosis.
- If a script fails because the host is in an unexpected state, stop changing the server, patch the relevant script locally in this skill, and rerun the script.
- The manual fallback in this skill is for the 3X-UI panel UI only. It is not permission to mutate server files manually.
## Inputs
Collect these before doing any work:
- `ssh target` for the VPS, preferably `root@host`
- optional plain-text SSH password if the host is password-auth only
- public domain pointed at the VPS
- optional ACME email
- panel admin username and password
- optional local tunnel port
Assume Ubuntu or Debian with `apt`. Do not use this skill on other distributions without adapting the Docker repository setup first.
The operator workstation and the target VPS also need outbound internet access for Docker downloads, ACME issuance, and panel API calls.