跳转到内容
rVPN rVPN

客户端快速开始

几分钟内连接到你的 rVPN 服务器。

前置条件

Section titled “前置条件”
  • 一台运行中的 rVPN 服务器（参见 服务器快速开始）
  • 由服务器管理员提供的 prekey-bundle.json 文件

1. 下载并安装

Section titled “1. 下载并安装”

最简单的方式是使用通用安装脚本：

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

它会自动检测你的平台，下载正确的二进制文件，验证校验和，并引导你完成配置。

或者手动安装：

平台二进制文件
macOS 通用rvpn-macos-universal
Linux x86_64rvpn-x86_64-linux-gnu
Linux ARM64rvpn-aarch64-linux-gnu
Linux ARMv7rvpn-armv7-linux
FreeBSD x86_64rvpn-x86_64-freebsd

macOS App Store（推荐）： 从 App Store 下载

或手动安装命令行工具：

Terminal window
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 签名。若你从其他来源下载了未经我们签名的二进制文件，请不要使用。

Terminal window
# 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. 生成你的身份密钥

Section titled “2. 生成你的身份密钥”

每个客户端拥有自己的身份密钥：

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

3. 创建配置文件

Section titled “3. 创建配置文件”
Terminal window
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. 连接

Section titled “4. 连接”
Terminal window
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. 配置你的应用

Section titled “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：

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

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

Section titled “（可选）全隧道（TUN）模式”

除了 SOCKS5 代理外，你也可以启用全隧道模式，将所有 IP 流量都路由通过 VPN。TUN 模式需要 root 或管理员权限。

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

[tun]
enabled = true

接口名由操作系统自动分配——通常在 macOS 上为 utun0，在 Linux/FreeBSD 上为 tun0。如需指定名称，请在 [tun] 段中传入自定义 interface_name。你的客户端 IP 地址和网关由服务器动态分配。

使用同一命令连接：

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

后续步骤

Section titled “后续步骤”