RustDesk Server源码打包教程:生成deb与rpm包
1. 环境准备与依赖安装
1.1 基础依赖清单
| 工具 | 作用 | 安装命令 |
|---|---|---|
| Rust (1.56+) | 编译RustDesk Server源码 | curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh |
| cargo | Rust包管理器 | 随Rust自动安装 |
| dpkg-dev | Debian打包工具链 | sudo apt-get install dpkg-dev |
| debhelper | Debian构建系统 | sudo apt-get install debhelper |
| alien | deb转rpm工具 | sudo apt-get install alien |
| git | 版本控制与子模块管理 | sudo apt-get install git |
1.2 源码获取
git clone https://gitcode.com/gh_mirrors/ru/rustdesk-server
cd rustdesk-server
git submodule update --init --recursive # 拉取hbb_common等子模块
2. Debian/Ubuntu deb包构建
2.1 目录结构解析
rustdesk-server/
├── debian/ # Debian打包配置
│ ├── control.tpl # 包元信息模板
│ ├── rules # 构建规则
│ ├── changelog # 版本变更记录
│ └── rustdesk-server-*.install # 文件安装映射
├── Cargo.toml # Rust项目清单
└── src/ # 服务端核心代码
2.2 构建步骤
2.2.1 编译源码
cargo build --release
# 输出产物位于target/release/
# - hbbs: rendezvous server (注册服务器)
# - hbbr: relay server (中继服务器)
2.2.2 生成deb包
# 替换控制文件中的架构变量
sed -i "s/{{ ARCH }}/$(dpkg --print-architecture)/g" debian/control.tpl
mv debian/control.tpl debian/control
# 构建deb包
dpkg-buildpackage -us -uc -b
# 生成的deb包位于上级目录:
# ../rustdesk-server-hbbs_*.deb
# ../rustdesk-server-hbbr_*.deb
# ../rustdesk-server-utils_*.deb
2.3 包验证
# 查看包内容
dpkg -c ../rustdesk-server-hbbs_*.deb
# 安装测试
sudo dpkg -i ../rustdesk-server-hbbs_*.deb ../rustdesk-server-hbbr_*.deb
# 验证服务状态
systemctl status rustdesk-hbbs
systemctl status rustdesk-hbbr
3. RHEL/CentOS rpm包构建
3.1 方法一:通过alien转换deb包
# 安装alien工具
sudo apt-get install alien
# 转换deb为rpm
sudo alien --to-rpm ../rustdesk-server-hbbs_*.deb
sudo alien --to-rpm ../rustdesk-server-hbbr_*.deb
sudo alien --to-rpm ../rustdesk-server-utils_*.deb
# 生成的rpm包位于当前目录
3.2 方法二:手动编写spec文件
3.2.1 创建rustdesk-server.spec
Name: rustdesk-server
Version: 1.1.12
Release: 1%{?dist}
Summary: Self-hosted remote desktop server
License: GPL-3.0
URL: https://rustdesk.com
Source0: %{name}-%{version}.tar.gz
BuildRequires: rust cargo
Requires: systemd
%description
RustDesk is an open-source remote desktop software.
This package contains the rendezvous server (hbbs) and relay server (hbbr).
%prep
%autosetup
%build
cargo build --release
%install
install -Dm755 target/release/hbbs %{buildroot}%{_bindir}/hbbs
install -Dm755 target/release/hbbr %{buildroot}%{_bindir}/hbbr
install -Dm644 systemd/rustdesk-hbbs.service %{buildroot}%{_unitdir}/rustdesk-hbbs.service
install -Dm644 systemd/rustdesk-hbbr.service %{buildroot}%{_unitdir}/rustdesk-hbbr.service
%post
systemctl daemon-reload
%files
%{_bindir}/hbbs
%{_bindir}/hbbr
%{_unitdir}/rustdesk-hbbs.service
%{_unitdir}/rustdesk-hbbr.service
%changelog
* Wed Jan 11 2023 open-trade <info@rustdesk.com> - 1.1.12
- WS real ip support
- Bump s6-overlay to v3.2.0.0
3.2.2 构建rpm包
# 创建源码包
tar czf rustdesk-server-1.1.12.tar.gz rustdesk-server/
# 构建rpm
rpmbuild -bb rustdesk-server.spec
# 输出位于~/rpmbuild/RPMS/$(arch)/
4. 自动化构建与CI/CD集成
4.1 Docker化构建
FROM rust:1.65-slim AS builder
WORKDIR /app
COPY . .
RUN git submodule update --init --recursive && \
cargo build --release
FROM debian:bullseye-slim
COPY --from=builder /app/target/release/hbbs /usr/bin/
COPY --from=builder /app/target/release/hbbr /usr/bin/
COPY debian/rustdesk-server-*.service /etc/systemd/system/
RUN apt-get update && apt-get install -y systemd && \
systemctl enable rustdesk-hbbs && systemctl enable rustdesk-hbbr
CMD ["/sbin/init"]
4.2 GitHub Actions工作流示例
name: Build Packages
on: [push]
jobs:
build-deb:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
with:
submodules: recursive
- name: Install deps
run: sudo apt-get install -y dpkg-dev debhelper
- name: Build deb
run: |
sed -i "s/{{ ARCH }}/amd64/g" debian/control.tpl
mv debian/control.tpl debian/control
dpkg-buildpackage -us -uc -b
- uses: actions/upload-artifact@v3
with:
name: deb-packages
path: ../*.deb
build-rpm:
needs: build-deb
runs-on: ubuntu-latest
steps:
- uses: actions/download-artifact@v3
with:
name: deb-packages
- name: Convert to rpm
run: sudo alien --to-rpm *.deb
- uses: actions/upload-artifact@v3
with:
name: rpm-packages
path: *.rpm
5. 常见问题解决
5.1 编译错误
| 错误信息 | 原因 | 解决方案 |
|---|---|---|
hbb_common/Cargo.toml not found | 子模块未拉取 | git submodule update --init |
linker 'cc' not found | 缺少C编译器 | sudo apt-get install build-essential |
5.2 打包错误
-
问题:
dpkg-buildpackage: not found
解决:安装dpkg-dev工具链:sudo apt-get install dpkg-dev -
问题:
alien: not found
解决:安装alien:sudo apt-get install alien
6. 部署验证
6.1 服务启动
# Debian/Ubuntu
sudo systemctl start rustdesk-hbbs rustdesk-hbbr
sudo systemctl enable rustdesk-hbbs rustdesk-hbbr
# RHEL/CentOS
sudo systemctl start rustdesk-hbbs rustdesk-hbbr
sudo systemctl enable rustdesk-hbbs rustdesk-hbbr
6.2 端口验证
netstat -tulpn | grep -E 'hbbs|hbbr'
# 预期输出:
# tcp 0 0 0.0.0.0:21115 0.0.0.0:* LISTEN hbbs
# tcp 0 0 0.0.0.0:21116 0.0.0.0:* LISTEN hbbs
# tcp 0 0 0.0.0.0:21117 0.0.0.0:* LISTEN hbbs
# tcp 0 0 0.0.0.0:21118 0.0.0.0:* LISTEN hbbr
7. 版本升级策略
7.1 源码更新
cd rustdesk-server
git pull
git submodule update --recursive
7.2 增量构建
# 重新生成deb包
dpkg-buildpackage -us -uc -b
# 升级安装
sudo dpkg -i ../rustdesk-server-*.deb
结语
通过本文档,您已掌握从源码构建RustDesk Server deb/rpm包的完整流程。该方案适用于企业内部部署、私有云环境或国产化操作系统适配场景。建议定期关注项目更新日志,及时集成安全补丁与功能优化。
相关资源
- 项目源码:https://gitcode.com/gh_mirrors/ru/rustdesk-server
- 官方文档:https://rustdesk.com/docs/
- 问题反馈:项目Issues页面
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考



