跳转至

安装指南

R-VPN 提供多平台二进制文件。选择最适合您需求的安装方式。

支持的平台

平台 架构 二进制变体
macOS x86_64, arm64 通用二进制可用
Linux x86_64, aarch64, armv7 GNU (glibc) 和静态 (musl)
FreeBSD x86_64 实验性支持

二进制文件命名规则

dist/ 目录中的二进制文件遵循以下命名模式： - rvpn-{平台}-{架构} - 客户端二进制 - rvpn-server-{平台}-{架构} - 服务器二进制 - -static 后缀表示 musl 链接的二进制（无外部 libc 依赖）

示例： - rvpn-macos-universal - macOS 通用客户端 - rvpn-x86_64-linux-gnu - Linux x86_64 glibc 版本 - rvpn-aarch64-linux-static - Linux ARM64 静态二进制 - rvpn-server-x86_64-freebsd - FreeBSD 服务器二进制

下载二进制文件

预编译的二进制文件可在仓库的 dist/ 目录中找到。

快速下载

# macOS (通用版 - 支持 Intel 和 Apple Silicon)
cp dist/rvpn-macos-universal /usr/local/bin/rvpn
cp dist/rvpn-server-macos-universal /usr/local/bin/rvpn-server
chmod +x /usr/local/bin/rvpn /usr/local/bin/rvpn-server

# Linux x86_64 (GNU 变体)
sudo cp dist/rvpn-x86_64-linux-gnu /usr/local/bin/rvpn
sudo cp dist/rvpn-server-x86_64-linux-gnu /usr/local/bin/rvpn-server
sudo chmod +x /usr/local/bin/rvpn /usr/local/bin/rvpn-server

# Linux x86_64 (静态/musl 变体 - 用于最小化系统)
sudo cp dist/rvpn-x86_64-linux-static /usr/local/bin/rvpn
sudo cp dist/rvpn-server-x86_64-linux-static /usr/local/bin/rvpn-server
sudo chmod +x /usr/local/bin/rvpn /usr/local/bin/rvpn-server

验证下载

所有二进制文件都包含 SHA256 校验和用于验证：

# 使用校验和文件验证
cd dist
sha256sum -c SHA256SUMS.txt

# 或验证单个二进制文件
cat rvpn-macos-universal.sha256
sha256sum rvpn-macos-universal

安装位置

系统范围安装（推荐）

# 客户端
sudo cp rvpn /usr/local/bin/rvpn
sudo chown root:root /usr/local/bin/rvpn
sudo chmod 755 /usr/local/bin/rvpn

# 服务器
sudo cp rvpn-server /usr/local/bin/rvpn-server
sudo chown root:root /usr/local/bin/rvpn-server
sudo chmod 755 /usr/local/bin/rvpn-server

用户本地安装

mkdir -p ~/bin
cp rvpn ~/bin/
export PATH="$HOME/bin:$PATH"
# 添加到 shell 配置文件以持久化
echo 'export PATH="$HOME/bin:$PATH"' >> ~/.bashrc  # 或 macOS 上的 ~/.zshrc

配置目录

创建所需的配置目录：

# 客户端配置
mkdir -p ~/.config/rvpn

# 服务器配置（需要 root 权限）
sudo mkdir -p /etc/rvpn
sudo mkdir -p /var/lib/rvpn
sudo mkdir -p /var/log/rvpn

配置文件位置

组件 配置目录 说明
客户端 ~/.config/rvpn/ 用户特定设置
服务器 /etc/rvpn/ 系统范围服务器配置
服务器数据 /var/lib/rvpn/ 运行时数据、密钥
日志 /var/log/rvpn/ 服务器日志

Systemd 服务安装（Linux）

对于 Linux 生产部署，使用 systemd 服务安装程序：

cd rvpn/

# 服务器服务安装
sudo ./deploy/install.sh

# 或手动复制并启用服务
sudo cp deploy/systemd/rvpn-server.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable rvpn-server
sudo systemctl start rvpn-server

检查服务状态： 

sudo systemctl status rvpn-server
sudo journalctl -u rvpn-server -f

从源码构建

如果您更喜欢从源码构建，需要安装 Rust：

先决条件

# 安装 Rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source $HOME/.cargo/env

构建

# 进入项目目录
cd rvpn/

# 构建发布二进制文件
cargo build --release

# 二进制文件将位于：
# target/release/rvpn
# target/release/rvpn-server

交叉编译（高级）

要为多个平台构建，使用提供的构建脚本：

cd rvpn/

# 构建所有目标（需要 cargo-zigbuild）
./scripts/build-release.sh

# 构建特定目标
./scripts/build-release.sh --macos-only
./scripts/build-release.sh --linux-only
./scripts/build-release.sh x86_64-unknown-linux-musl

交叉编译要求： - cargo-zigbuild: cargo install cargo-zigbuild - zig: brew install zig (在 macOS 上)

下一步