VPN для Linux — CLI-клиент Relokant

Полноценный VPN-клиент для Linux с терминальным интерфейсом. Одна команда для установки, одна для подключения. Под капотом — sing-box с протоколом VLESS, тот же движок, что в мобильном приложении Relokant.

Установка

Для установки CLI-клиента выполните одну команду в терминале:

curl -fsSL https://relokant.net/linux/install.sh | bash

Скрипт скачает relokant-vpn и установит его в /usr/local/bin/. Если нужен sudo — запросит автоматически.

Зависимости

Клиент требует стандартные утилиты, которые есть в большинстве дистрибутивов:

• curl — для загрузки конфигурации
• jq — для обработки JSON-конфигов
• python3 — для декодирования URL
• base64 — для декодирования подписки (часть coreutils)

Если чего-то не хватает:

# Ubuntu / Debian
sudo apt install curl jq python3

# Fedora
sudo dnf install curl jq python3

# Arch Linux
sudo pacman -S curl jq python

Быстрый старт

Три команды — и у вас российский IP:

relokant-vpn activate YOUR_CODE

relokant-vpn connect

$ relokant-vpn status
Connected
  PID:       12847
  Interface: relokant
  Public IP: 185.x.x.x (Москва)
  Code:      A7K*****

Все команды

Короткие алиасы: connect = up, disconnect = down, status = st, servers = list.

Автозапуск через systemd

Чтобы VPN запускался автоматически при загрузке системы, создайте systemd-сервис:

# Сначала активируйте и проверьте подключение
relokant-vpn activate YOUR_CODE
relokant-vpn connect
# Убедитесь, что всё работает
relokant-vpn status
relokant-vpn disconnect

# Установите сервис
relokant-vpn install-service

# Управление
sudo systemctl start relokant-vpn    # запустить
sudo systemctl stop relokant-vpn     # остановить
sudo systemctl status relokant-vpn   # статус
sudo journalctl -u relokant-vpn -f   # логи в реальном времени

Поддерживаемые дистрибутивы

Поддерживаемые архитектуры

• x86_64 (amd64) — стандартные ПК и ноутбуки
• ARM64 (aarch64) — Raspberry Pi 4/5, серверы ARM, Pinebook
• ARMv7 (armhf) — Raspberry Pi 2/3, старые ARM-платы

Ручная установка

Если вы не хотите использовать автоустановщик, можно установить всё вручную:

# 1. Скачайте скрипт
curl -fsSL https://relokant.net/linux/relokant-vpn -o relokant-vpn
chmod +x relokant-vpn
sudo mv relokant-vpn /usr/local/bin/

# 2. Установите sing-box вручную (или через пакетный менеджер)
relokant-vpn install-singbox

# Или через snap:
# sudo snap install sing-box

# Или через AUR (Arch):
# yay -S sing-box-bin

# 3. Активация и подключение
relokant-vpn activate YOUR_CODE
relokant-vpn connect

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

Клиент Relokant — это обёртка над sing-box, тем же VPN-движком, который используется в мобильном приложении. Вот что происходит при подключении:

1. Загрузка конфигурации. Клиент обращается к API Relokant с вашим кодом активации и получает список VLESS-серверов с параметрами подключения
2. Генерация конфига. VLESS URI преобразуются в формат sing-box — JSON-файл с настройками TUN-интерфейса, DNS, маршрутизации и серверов
3. Создание TUN-интерфейса. sing-box создаёт виртуальный сетевой интерфейс relokant и перенаправляет на него весь трафик
4. Шифрование. Трафик шифруется протоколом VLESS+TLS и маскируется под обычный HTTPS — не обнаруживается DPI

Продвинутое использование

Конфигурация sing-box

Сгенерированный конфиг sing-box находится в ~/.config/relokant/config.json. Вы можете редактировать его вручную — например, добавить правила маршрутизации для split tunneling:

# Посмотреть текущий конфиг
cat ~/.config/relokant/config.json | jq .

# Проверить конфиг
sing-box check -c ~/.config/relokant/config.json

Split tunneling

По умолчанию весь трафик идёт через VPN. Чтобы исключить определённые сайты или IP-адреса, отредактируйте секцию route.rules в конфиге:

// Добавьте правило в route.rules:
{
    "domain_suffix": [".local", ".lan"],
    "outbound": "direct"
}

Проксирование только браузера

Если не нужен системный VPN, можно использовать sing-box как SOCKS5/HTTP-прокси. Для этого замените TUN-инбаунд в конфиге на:

{
    "type": "socks",
    "tag": "socks-in",
    "listen": "127.0.0.1",
    "listen_port": 1080
}

Затем настройте браузер на прокси 127.0.0.1:1080. Это не требует root.

Решение проблем

• «Permission denied» при connect — TUN-режим требует root. Клиент запросит sudo автоматически. Убедитесь, что ваш пользователь в группе sudo
• «sing-box not found» — выполните relokant-vpn install-singbox для ручной установки
• DNS не работает после подключения — проверьте, что systemd-resolved не конфликтует. Попробуйте: sudo resolvectl dns relokant 1.1.1.1
• Подключение зависает — попробуйте relokant-vpn update для обновления конфигурации. Если не помогает — возможно, текущий сервер недоступен
• Конфликт с Docker — Docker может конфликтовать с TUN-маршрутами. Добавьте подсеть Docker в исключения маршрутизации в конфиге sing-box
• Нет интернета после отключения — в редких случаях маршруты могут не восстановиться. Перезапустите NetworkManager: sudo systemctl restart NetworkManager

Частые вопросы