Быстрый старт клиента

Подключитесь к вашему серверу rVPN за несколько минут.

Предварительные требования

Работающий сервер rVPN (см. Быстрый старт сервера)
Файл prekey-bundle.json от оператора вашего сервера

1. Скачивание и установка

Проще всего использовать универсальный установщик:

curl -fsSL https://assets.rvpn.org/install.sh | sudo bash -s -- --setup --client

Он автоматически определит вашу платформу, скачает нужный бинарник, проверит контрольную сумму и проведёт вас через настройку.

Или вручную:

Платформа	Бинарник
macOS Universal	`rvpn-macos-universal`
Linux x86_64	`rvpn-x86_64-linux-gnu`
Linux ARM64	`rvpn-aarch64-linux-gnu`
Linux ARMv7	`rvpn-armv7-linux`
FreeBSD x86_64	`rvpn-x86_64-freebsd`

macOS App Store (рекомендуется): Скачать из App Store

Или установите инструмент командной строки вручную:

curl -LO https://assets.rvpn.org/1.3.1/rvpn-macos-universal
chmod +x rvpn-macos-universal && sudo mv rvpn-macos-universal /usr/local/bin/rvpn
xattr -d com.apple.quarantine /usr/local/bin/rvpn

Замечание по безопасности: Официальные бинарники для macOS подписаны PDG Global Limited. Если вы скачиваете бинарник из другого источника, не подписанный нами, не используйте его.

# Linux
curl -LO https://assets.rvpn.org/1.3.1/rvpn-x86_64-linux-gnu
chmod +x rvpn-x86_64-linux-gnu && sudo mv rvpn-x86_64-linux-gnu /usr/local/bin/rvpn

# FreeBSD
fetch https://assets.rvpn.org/1.3.1/rvpn-x86_64-freebsd
chmod +x rvpn-x86_64-freebsd && sudo mv rvpn-x86_64-freebsd /usr/local/bin/rvpn

2. Сгенерируйте свой ключ идентификации

У каждого клиента есть собственный ключ идентификации:

mkdir -p /etc/rvpn
rvpn keygen -o /etc/rvpn/identity.key

3. Создайте файл конфигурации

nano /etc/rvpn/client.toml

server_address    = "wss://your-server.com/api/v1/ws"
identity_key_file = "/etc/rvpn/identity.key"
prekey_bundle     = "/etc/rvpn/prekey-bundle.json"

[socks5]
listen_address = "127.0.0.1:1080"

Скопируйте prekey-bundle.json от оператора вашего сервера в /etc/rvpn/prekey-bundle.json.

4. Подключитесь

rvpn -c /etc/rvpn/client.toml

Вы должны увидеть:

INFO  Connecting to wss://your-server.com/api/v1/ws
INFO  SOCKS5 proxy listening on 127.0.0.1:1080

5. Настройте ваши приложения

Установите системный или браузерный прокси на SOCKS5 127.0.0.1:1080.

Системный прокси macOS: Системные настройки → Сеть → ваше подключение → Прокси → SOCKS Proxy → 127.0.0.1:1080

Chrome / Brave (через расширение): Установите SwitchyOmega и добавьте SOCKS5-прокси на 127.0.0.1:1080.

Firefox: Настройки → Основные → Настройки сети → Ручная настройка прокси → SOCKS-узел: 127.0.0.1, порт: 1080, SOCKS v5.

curl:

curl --socks5 127.0.0.1:1080 https://example.com

(Опционально) Режим полного туннеля (TUN)

Вместо SOCKS5-прокси вы можете включить режим полного туннеля, чтобы направлять весь IP-трафик через VPN. TUN-режим требует прав root или администратора.

Добавьте [tun] в ваш client.toml, чтобы включить его:

[tun]
enabled = true

Имя интерфейса назначается операционной системой автоматически — обычно utun0 на macOS и tun0 на Linux/FreeBSD. Передайте interface_name в разделе [tun], если хотите конкретное имя. IP-адрес клиента и шлюз назначаются сервером динамически.

Подключитесь той же командой:

sudo rvpn -c /etc/rvpn/client.toml

Дальнейшие шаги

Приложение macOS — нативный VPN для macOS с Network Extension
Приложение iOS — мобильный VPN с раздельным туннелированием и блокировкой рекламы
Приложение Android — полнотуннельный VPN для Android 14+
Подробнее про режим SOCKS5-прокси
Защита от DNS-утечек через встроенный DNS-прокси
Режим полного туннеля (TUN)
Все опции конфигурации клиента
Сценарии использования — практические руководства для типичных сценариев
Защита от DNS-утечек — остановите DNS-утечки в SOCKS5-режиме
Устранение неполадок — решения типичных проблем