RustDesk Server源码编译指南：从Cargo到可执行文件

最新推荐文章于 2025-10-04 03:33:50 发布
原创 最新推荐文章于 2025-10-04 03:33:50 发布 · 1.1k 阅读 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。

RustDesk Server源码编译指南：从Cargo到可执行文件

【免费下载链接】rustdesk-server RustDesk Server Program 【免费下载链接】rustdesk-server 项目地址: https://gitcode.com/gh_mirrors/ru/rustdesk-server

你是否在搭建私有远程桌面服务时遇到官方二进制包兼容性问题？是否需要针对特定硬件优化RustDesk Server性能？本文将带你从源码开始，完整构建适用于Linux、Windows和macOS的RustDesk Server可执行文件，掌握编译参数调优、交叉编译技巧和常见问题排查方法。

读完本文你将获得：

  • 全平台编译环境搭建指南
  • 定制化编译参数配置方案
  • 密钥系统工作原理与安全实践
  • 编译产物优化与部署策略
  • 常见编译错误解决方案

项目架构解析

RustDesk Server采用Rust语言开发，采用模块化设计架构，主要包含以下核心组件：

mermaid

核心可执行文件说明：

  • hbbs：RustDesk ID/会和服务器（Rendezvous Server），默认端口21116
  • hbbr：RustDesk中继服务器（Relay Server），默认端口21117
  • rustdesk-utils：辅助工具集，用于密钥生成等功能

编译环境准备

系统要求

操作系统最低配置推荐配置
Linux2核4GB RAM4核8GB RAM
Windows2核4GB RAM + Visual Studio 20224核8GB RAM + SSD
macOS2核4GB RAM + Xcode4核8GB RAM + Xcode 14+

依赖安装

Ubuntu/Debian
# 基础工具链
sudo apt update && sudo apt install -y build-essential pkg-config git curl

# Rust环境
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
source $HOME/.cargo/env

# 系统依赖
sudo apt install -y libssl-dev libglib2.0-dev libsqlite3-dev
CentOS/RHEL
sudo yum install -y gcc gcc-c++ make pkgconfig openssl-devel git curl
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
source $HOME/.cargo/env
Windows
  1. 安装 Visual Studio 2022（勾选"C++桌面开发"组件）
  2. 安装 Git for Windows
  3. 安装 Rust：winget install Rustlang.Rustup
  4. 配置MSVC工具链：rustup default stable-msvc
macOS
# 安装Xcode命令行工具
xcode-select --install

# 安装Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装依赖
brew install rust git openssl pkg-config

源码获取

git clone https://gitcode.com/gh_mirrors/ru/rustdesk-server.git
cd rustdesk-server

编译参数深度解析

Cargo.toml是Rust项目的核心配置文件，理解关键编译参数对定制化构建至关重要：

核心依赖分析

[package]
name = "hbbs"
version = "1.1.12"
edition = "2021"
build = "build.rs"

[[bin]]
name = "hbbr"
path = "src/hbbr.rs"

[[bin]]
name = "rustdesk-utils"
path = "src/utils.rs"

[dependencies]
# 网络通信
axum = { version = "0.5", features = ["headers"] }
tokio-tungstenite = "0.17"
# 数据存储
sqlx = { version = "0.6", features = [ "runtime-tokio-rustls", "sqlite", "macros" ] }
# 安全加密
bcrypt = "0.13"
sodiumoxide = "0.2"
jsonwebtoken = "8"
# 命令行解析
clap = "2"

编译配置文件

[profile.release]
lto = true                  # 链接时优化，减小二进制体积
codegen-units = 1           # 单代码生成单元，优化更充分
panic = 'abort'             # panic时直接终止，减小二进制体积
strip = true                # 剥离调试符号
# opt-level = 'z'           # 极致优化大小（默认3为优化性能）

基础编译流程

标准编译步骤

# 克隆代码仓库
git clone https://gitcode.com/gh_mirrors/ru/rustdesk-server.git
cd rustdesk-server

# 查看可用命令
cargo run --bin rustdesk-utils -- --help

# 开发构建（含调试信息）
cargo build

# 发布构建（优化编译）
cargo build --release

编译成功后，产物位于以下路径：

target/
├── debug/
│   ├── hbbs          # 调试版会和服务器
│   ├── hbbr          # 调试版中继服务器
│   └── rustdesk-utils # 调试版工具
└── release/
    ├── hbbs          # 发布版会和服务器
    ├── hbbr          # 发布版中继服务器
    └── rustdesk-utils # 发布版工具

编译产物验证

# 验证版本信息
./target/release/hbbs --version
./target/release/hbbr --version

# 生成加密密钥对
./target/release/rustdesk-utils genkeypair

预期输出：

Public Key:  aBcDeFgHiJkLmNoPqRsTuVwXyZ1234567890=
Secret Key:  0987654321ZyxWvUtSrQpOnMlKjIhGgFeDcBa=

高级编译选项

定制化编译参数

# 自定义监听端口
cargo build --release --features custom-port

# 禁用SQLite支持（仅使用内存存储）
cargo build --release --no-default-features --features "network security"

# 启用详细日志
RUST_LOG=debug cargo build --release

交叉编译配置

Linux -> Windows
# 安装交叉编译工具链
rustup target add x86_64-pc-windows-gnu

# 编译64位Windows版本
cargo build --release --target x86_64-pc-windows-gnu
Linux -> macOS
# 安装OSX交叉编译工具
sudo apt install -y clang libxml2-dev libssl-dev
rustup target add x86_64-apple-darwin

# 设置环境变量
export SDK_PATH=/path/to/MacOSX.sdk
export CC=x86_64-apple-darwin20.4-clang
export CXX=x86_64-apple-darwin20.4-clang++

# 编译
cargo build --release --target x86_64-apple-darwin

条件编译代码分析

hbbr.rs中的平台特定代码：

#[cfg(any(target_os = "macos", target_os = "windows"))]
use reqwest::native_tls;

#[cfg(not(any(target_os = "macos", target_os = "windows"))]
use reqwest::rustls_tls;

fn main() -> ResultType<()> {
    // 加载配置
    #[cfg(feature = "config-file")]
    let config = load_config();
    
    // 启动服务器
    #[cfg(debug_assertions)]
    println!("Starting hbbr in debug mode");
    
    #[cfg(not(debug_assertions))]
    info!("Starting hbbr in release mode");
    
    start_server()
}

密钥系统详解

密钥生成流程

mermaid

密钥使用机制

// src/common.rs
pub fn load_or_generate_keys() -> Result<(PublicKey, SecretKey)> {
    // 尝试从文件加载密钥
    if let Ok(secret_key) = std::fs::read("id_ed25519") {
        let public_key = std::fs::read("id_ed25519.pub")?;
        Ok((public_key, secret_key))
    } else {
        // 生成新密钥对
        let (pk, sk) = sodiumoxide::crypto::sign::gen_keypair();
        std::fs::write("id_ed25519", sk.0)?;
        std::fs::write("id_ed25519.pub", pk.0)?;
        Ok((pk.0.to_vec(), sk.0.to_vec()))
    }
}

安全最佳实践

# 1. 生成高强度密钥
./rustdesk-utils genkeypair

# 2. 权限控制
chmod 600 id_ed25519
chmod 644 id_ed25519.pub

# 3. 备份密钥
cp id_ed25519* /secure/backup/location/

# 4. 配置强制密钥验证
./hbbs -k your-secret-key -r relay-server:21117

编译优化策略

二进制体积优化

优化方法命令效果
链接时优化lto = true减小20-30%体积
代码生成单元codegen-units = 1减小5-10%体积
剥离调试符号strip = true减小40-60%体积
优化级别zopt-level = 'z'额外减小5-15%体积

优化前后对比：

# 默认release配置
hbbs: 12.8 MB

# 开启全部优化
hbbs: 6.4 MB (-50%)

性能优化配置

[profile.release]
opt-level = 3             # 最高性能优化
lto = "fat"               # 全程序LTO优化
codegen-units = 4         # 平衡编译速度和优化
debug = 1                 # 保留少量调试信息用于分析

编译时间优化

# 使用ccache加速编译
export RUSTC_WRAPPER=ccache

# 并行编译
cargo build --release -j 4

# 增量编译
cargo build --release --incremental

部署与验证

系统服务配置

Systemd服务文件
# /etc/systemd/system/rustdesk-hbbs.service
[Unit]
Description=RustDesk ID Server
After=network.target

[Service]
User=rustdesk
Group=rustdesk
WorkingDirectory=/opt/rustdesk-server
ExecStart=/opt/rustdesk-server/hbbs -r 127.0.0.1:21117 -k your-secret-key
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

服务管理命令：

sudo systemctl daemon-reload
sudo systemctl enable --now rustdesk-hbbs
sudo systemctl enable --now rustdesk-hbbr

# 查看状态
sudo systemctl status rustdesk-hbbs

防火墙配置

# UFW配置
sudo ufw allow 21115/tcp   # hbbs API
sudo ufw allow 21116/tcp   # hbbs TCP
sudo ufw allow 21116/udp   # hbbs UDP
sudo ufw allow 21117/tcp   # hbbr
sudo ufw allow 21118/tcp   # Web控制台
sudo ufw allow 21119/tcp   # 中继数据

功能验证

# 检查端口监听
ss -tulpn | grep -E 'hbbs|hbbr'

# 测试密钥验证
./rustdesk-utils verify -k your-secret-key

# 性能基准测试
./rustdesk-utils benchmark --server localhost:21116

常见问题解决

编译错误排查

链接错误：缺少OpenSSL
error: linking with `cc` failed: exit status: 1
...
undefined reference to `SSL_new'

解决方案：

# Ubuntu/Debian
sudo apt install -y libssl-dev

# CentOS/RHEL
sudo yum install -y openssl-devel
交叉编译错误：找不到目标工具链
error: could not find `x86_64-pc-windows-gnu` in your PATH

解决方案：

rustup target add x86_64-pc-windows-gnu
sudo apt install -y mingw-w64
依赖冲突：Cargo.lock问题
error: failed to select a version for `hyper`.
    ... required by package `axum v0.5.17`

解决方案：

rm Cargo.lock
cargo update
cargo build --release

运行时问题

密钥不匹配
ERROR: Public key mismatch between hbbs and hbbr

解决方案：

# 确保hbbs和hbbr使用相同的密钥文件
cp id_ed25519* /path/to/hbbr/workdir/
端口占用
ERROR: Failed to bind to 0.0.0.0:21116

解决方案：

# 查找占用进程
sudo lsof -i :21116

# 自定义端口启动
./hbbs -p 21118 -r relay-server:21119

总结与展望

通过本文，你已掌握从源码编译RustDesk Server的完整流程，包括环境搭建、参数配置、交叉编译和优化策略。关键收获：

  1. 架构理解：掌握hbbs/hbbr核心组件及通信流程
  2. 编译实践：全平台编译流程与定制化配置方法
  3. 安全强化：密钥系统原理与安全部署最佳实践
  4. 问题诊断：常见编译错误与运行时问题排查方案

未来方向：

  • 自动化编译流水线构建
  • 容器化编译环境
  • ARM架构优化编译
  • WebAssembly版本探索

建议定期同步官方仓库更新，关注性能优化和安全补丁。如需进一步定制功能，可基于src/rendezvous_server.rs和src/relay_server.rs进行二次开发。

如果觉得本文有价值，请点赞收藏，并关注获取更多RustDesk高级配置指南。

【免费下载链接】rustdesk-server RustDesk Server Program 【免费下载链接】rustdesk-server 项目地址: https://gitcode.com/gh_mirrors/ru/rustdesk-server

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值