RustDesk ID Server

RUSTDESK ID SERVER

科室：远距传输组
编目范围：持续更新
相关人物：SeaSmall
访问范围：OPEN ARCHIVE

在 Root 安卓手机上运行 RustDesk 的 hbbs ID/rendezvous 服务器 + 可选 hbbr 中继服务器，把手机变自建 RustDesk 服务器。

⚠️ 免责声明本模块按「按现状」提供，不附带任何担保。使用需 Root + Magisk，可能导致隐私泄露、设备不稳定。生产环境部署前请自行评估风险。 Magisk 模块不一定稳定。

📦 下载GitHub Releases

✨ 特性

🔑 随机 Key：每次安装自动生成 32 位安全随机 key
📦 内置二进制：arm64 (aarch64) 静态二进制，开箱即用
🚀 一键安装：电脑端脚本自动完成打包→推送→部署→启动→校验
📱 也可手动装：直接把 zip 在 Magisk 里安装，无需电脑

📦 安装方式一：一键脚本（推荐）

前置条件 - 手机已 root 且装有 Magisk - 电脑装有 adb（winget install Google.PlatformTools） - 手机开启 USB 调试并授权电脑

Windows（PowerShell）

.\install.ps1                 # 自动生成随机 key 并安装
.\install.ps1 -Key mykey123   # 指定固定 key
.\install.ps1 -Relay          # 同时启用 hbbr 中继
.\install.ps1 -Serial xxxx    # 指定设备序列号
.\install.ps1 -OutOnly out.zip # 只打包不安装

Linux / macOS

chmod +x install.sh
./install.sh                 # 自动生成随机 key 并安装
./install.sh --key mykey123  # 指定固定 key
./install.sh --relay         # 启用中继
./install.sh --serial xxxx   # 指定设备序列号

📦 安装方式二：Magisk 手动安装

下载模块

从 Releases 下载 rustdesk-id-server.zip

传输到手机

下载 / 微信 / 数据线均可

安装

Magisk Manager → 模块 → 从本地安装 → 选择 zip → 重启

确认运行

终端执行 ps -A | grep hbbs 看到进程即成功

⚠️ 关于 Key手动安装使用 zip 内置默认 key：W8n7Wz7XhPX8wEPUxpnop5T7HGyPGVSF。客户端必须填相同 key 才能连接。

💻 客户端配置

设置项	值
ID/中继服务器	填手机 IP 地址（如 192.168.1.100）
Key（公钥）	一键安装时打印的随机 key；手动安装用默认 key

🔌 端口说明

端口	协议	用途
21115	TCP	NAT 类型测试
21116	TCP + UDP	ID/rendezvous 主端口（最关键）
21117	TCP	中继（hbbr，仅启用中继时）
21118	TCP	WebSocket（网页客户端）

⚙️ 配置修改

编辑 config/env.sh：

SERVER_KEY="你的key"        # 服务器 key
ENABLE_RELAY="0"           # 0=仅ID服务器 1=同时启动中继
HBBS_PORT="21116"          # hbbs 端口
DATA_DIR="/data/local/tmp/rustdesk"  # 数据目录

修改后重启模块服务或重启手机生效。

❓ 常见问题

hbbs 启动失败：查看 /data/local/tmp/rustdesk/rustdesk.log
架构不匹配：getprop ro.product.cpu.abi 查看手机架构
客户端连不上：确认 21116 TCP/UDP 已放行、key 一致

项目仓库

https://github.com/SeaSmall/rustdesk-id-server

本文来自 SeaSmall 个人博客的既有文档，内容版权归 SeaSmall 所有。