跳转至

客户端快速入门

在几分钟内连接到您的 R-VPN 服务器。

前置要求

  • 一个正在运行的 R-VPN 服务器（参见服务器快速入门）
  • 服务器运营商提供的 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： 

curl -LO https://assets.rvpn.org/1.0.2/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.0.2/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.2/rvpn-x86_64-freebsd
chmod +x rvpn-x86_64-freebsd
sudo mv rvpn-x86_64-freebsd /usr/local/bin/rvpn

2. 生成您的身份密钥

每个客户端都有自己的身份密钥（类似于 Signal 密钥对）：

rvpn keygen -o ~/.config/rvpn/identity.key

3. 创建配置文件

mkdir -p ~/.config/rvpn
nano ~/.config/rvpn/client.toml

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

[socks5]
listen_address = "127.0.0.1:1080"

将服务器运营商提供的 prekey-bundle.json 复制到 ~/.config/rvpn/prekey-bundle.json。

4. 连接

rvpn -c ~/.config/rvpn/client.toml

您应该看到： 

INFO  rvpn_client: Connecting to wss://your-server.com/api/v1/ws
INFO  rvpn_client: 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 主机：127.0.0.1，端口：1080，SOCKS v5。

curl： 

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

（可选）全隧道（TUN）模式

您也可以启用全隧道模式，将所有 IP 流量通过 VPN 路由，而不是使用 SOCKS5 代理。TUN 模式需要 root 或管理员权限。

在 client.toml 中添加 [tun] 来启用：

[tun]
enabled = true

接口名称由操作系统自动分配。在 macOS 上显示为 utunN；在 Linux 上默认为 rvpn0（或您指定的 interface_name）。您的客户端 IP 地址和网关由服务器动态分配。

使用相同的命令连接： 

sudo rvpn -c ~/.config/rvpn/client.toml

后续步骤