Инструкция по настройке VPN

English: Multi-layer VPN system (VLESS Reality + Yandex Cloud Relay + WebRTC) for bypassing Russian internet censorship (ТСПУ/DPI). Designed to be deployed automatically via Claude Code. See below for Russian documentation.

Что это

VPN-инфраструктура на базе VLESS Reality -- протокола, который маскирует VPN-трафик под обычные HTTPS-запросы к Microsoft, Google и Apple. Для систем блокировки (ТСПУ/DPI) ваш трафик выглядит как обычный интернет-сёрфинг.

Если один метод подключения блокируют -- система автоматически переключается на следующий.

Split routing: российские сайты (банки, Госуслуги, VK, Yandex) идут напрямую, без VPN -- они работают быстрее и не вызывают подозрений.

Как это работает

Приоритет подключения:

Layer 0: VLESS Reality        → VPS за рубежом → Интернет     ← основной
Layer 1: Yandex Cloud Relay   → VPS за рубежом → Интернет     ← обход белых списков
Layer 2: WebRTC / Телемост    → VPS за рубежом → Интернет     ← аварийный
Layer 3: Cloudflare CDN       → VPS за рубежом → Интернет     ← backup для Wi-Fi

Что нужно сделать вам

1. Арендовать VPS (~$2/мес)

VPS -- это виртуальный сервер за рубежом, через который будет идти ваш трафик.

• Рекомендуемые: AlphaVPS (Болгария, от €3.50/мес), Hetzner (Германия, от €3.49/мес), RackNerd (от ~$1/мес) -- любой EU VPS с Debian 12
• ⛔ НЕ использовать российские хостинги: Aeza, VDSina, REG.RU, Timeweb -- подчиняются Роскомнадзору и могут блокировать VPN по требованию
• ⚠️ Не рекомендуется: Hetzner, OVH, DigitalOcean -- их подсети массово заблокированы ТСПУ (но если IP свежий -- может работать)
• Что понадобится: IP-адрес сервера и SSH-доступ (пароль или ключ)

2. Купить домен (опционально) (~$6/год, первый год ~$3)

Домен нужен для CDN-фронтинга через Cloudflare (backup). Без домена основной VPN и Yandex Cloud relay будут работать -- этого достаточно для большинства случаев.

• Где: namecheap.com
• Какой: любой дешёвый домен (.top, .xyz, .site)

3. Установить VPN-клиент на устройства

⚠️ TUN-режим обязателен! Без TUN (в режиме "Системный прокси") QUIC/UDP трафик идёт напрямую через провайдера — Google, Claude.ai и другие сервисы увидят ваш реальный IP. Подробнее: docs/05-security.md

Почему v2rayN? Стабильный TUN-режим с sing-box core, встроенный пресет маршрутизации для России, корректная обработка QUIC/UDP. Работает на Windows, macOS и Linux.

Почему Shadowrocket на iOS? Поддерживает VLESS Reality, WebSocket-транспорт, split routing и auto-select серверов. Лучший клиент для iOS.

Установка VPN через Claude Code

Claude Code -- AI-агент от Anthropic. Работает в терминале и как расширение для VS Code / JetBrains. Он прочитает инструкции из этого репозитория и автоматически настроит VPN на вашем сервере.

Вариант 1: Клонировать репозиторий

# 1. Установите Claude Code (нужен Node.js 18+)
npm install -g @anthropic-ai/claude-code

# 2. Клонируйте репозиторий
git clone https://github.com/Sergei-thinker/vpn-setup.git
cd vpn-setup

# 3. Скопируйте шаблон конфигурации и заполните данные VPS
cp .env.example .env
# Отредактируйте .env — впишите IP вашего VPS и SSH-данные

# 4. Запустите Claude Code
claude

Скажите Claude: "Разверни мне VPN"

Вариант 2: Просто скинуть ссылку

Если у вас уже установлен Claude Code -- просто откройте его и отправьте:

Разверни мне VPN по инструкции из https://github.com/Sergei-thinker/vpn-setup

Claude сам клонирует репозиторий, объяснит что нужно сделать (арендовать VPS, заполнить .env), и проведёт вас через весь процесс шаг за шагом.

Claude автоматически:

• Установит панель 3X-UI и VLESS Reality на сервере
• Настроит несколько backup-подключений (разные порты и SNI)
• Сгенерирует ссылки для импорта в VPN-клиент
• Настроит split routing для российских сайтов
• Объяснит, как импортировать конфиг в ваше приложение

Ручная установка (без Claude Code)

Если вы предпочитаете настроить всё самостоятельно -- подробная пошаговая инструкция: GUIDE.md

Для справки по конкретным темам: docs/

Структура проекта

Стоимость

Лицензия

MIT