Перейти к содержанию

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

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

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

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.0.5/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

# Linux
curl -LO https://assets.rvpn.org/1.0.5/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.0.5/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-прокси → 127.0.0.1:1080

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

Firefox: Настройки → Общие → Сетевые настройки → Ручная настройка прокси → SOCKS Host: 127.0.0.1, Port: 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

Имя интерфейса назначается автоматически операционной системой. На macOS это выглядит как utunN; на Linux по умолчанию используется rvpn0 (или ваше пользовательское interface_name, если указано). IP-адрес клиента и шлюз назначаются динамически сервером.

Подключение выполняется той же командой: 

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

Следующие шаги