RustDesk Server源码打包教程：生成deb与rpm包

1. 环境准备与依赖安装

1.1 基础依赖清单

工具	作用	安装命令
Rust (1.56+)	编译RustDesk Server源码	`curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs
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 <[e-mail]> - 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页面