Self-hosted сервер RustDesk (hbbs / hbbr) для связки с rustdesk-api-srv.
База — открытый rustdesk/rustdesk-server (AGPL). В этой сборке дополнительно:
- HTTP API proxy — клиент может ходить в ваш API через TCP rendezvous (
HttpProxyRequest), когда прямой доступ к API закрыт (firewall, CGNAT). - secure_tcp / KeyExchange — залогиненные клиенты ≥1.4.1 нормально устанавливают защищённый TCP к hbbs (без этого бывает
Failed to secure tcp: deadline has elapsed).
Образы: ghcr.io/temandroid/rustdesk-server:latest (и тег с коротким SHA коммита). При настроенных секретах CI также пушится на Docker Hub temandroid/rustdesk-server.
Полный список переменных upstream: docs/environment-variables.md.
На сервере с Docker:
mkdir -p /data/rustdesk/data
cd /data/rustdesk
curl -fsSL -o docker-compose.yml \
https://raw.githubusercontent.com/temandroid/rustdesk-server/master/docker-compose.yml
# при необходимости создайте .env рядом:
# API_SERVER=http://127.0.0.1:21114
# RUST_LOG=info
docker compose pull
docker compose up -dCompose использует network_mode: host (порты 21115–21119 на хосте). Данные и ключи — в ./data (внутри контейнера /root).
Публичный ключ для клиентов и api-srv:
cat data/id_ed25519.pubОткройте в firewall UDP/TCP 21116, TCP 21117, при WebSocket — 21118/21119, для NAT test — 21115.
| Где | Что указать |
|---|---|
api-srv .env |
ID_SERVER=<этот хост>, RUSTDESK_KEY=<id_ed25519.pub> |
| hbbs | API_SERVER=http://127.0.0.1:21114 если API на той же машине; иначе https://ваш-api-домен |
| клиент | ID/Relay = этот хост, API = PUBLIC_URL api-srv, Key = тот же pubkey |
Нужны Rust (stable), pkg-config, OpenSSL, CMake, C++ toolchain.
git clone --recursive https://github.com/temandroid/rustdesk-server.git
cd rustdesk-server
cargo build --releaseБинарники в target/release/:
| Файл | Назначение |
|---|---|
hbbs |
ID / rendezvous |
hbbr |
relay |
rustdesk-utils |
утилиты |
Запуск (пример, рабочий каталог с ключами):
mkdir -p /var/lib/rustdesk && cd /var/lib/rustdesk
export API_SERVER=http://127.0.0.1:21114
/path/to/hbbr &
/path/to/hbbs -r <публичный-хост>Ключи id_ed25519 / id_ed25519.pub создаются при первом старте hbbs в текущем каталоге. Альтернатива флагам — .env в cwd (см. docs/environment-variables.md).
Проверка: hbbs --help, hbbr --help.
systemd-юниты-образцы: каталог systemd/ в репозитории.
git clone --recursive https://github.com/temandroid/rustdesk-server.git
cd rustdesk-server
docker build -t ghcr.io/temandroid/rustdesk-server:local .CI (.github/workflows/publish-rustdesk-server.yml) на push в master публикует amd64 в GHCR.
Важно: не меняйте volume с ключами (data/ / /root в контейнере). Иначе сменится Key и всем клиентам нужно будет обновлять настройку.
cd /data/rustdesk
docker compose pull
docker compose up -d
# ключи в ./data сохраняются
cat data/id_ed25519.pub # должен совпасть с прежнимИли зафиксируйте тег: image: ghcr.io/temandroid/rustdesk-server:5e140db в compose.
cd rustdesk-server
git pull --recurse-submodules
cargo build --release
# остановите сервисы, подмените бинарники, запустите снова
# рабочий каталог с id_ed25519* не трогайте- Остановите старые hbbs/hbbr.
- Скопируйте каталог с
id_ed25519,id_ed25519.pubи sqlite peer DB вdata/нового compose (или оставьте тот же volume). - Поднимите
ghcr.io/temandroid/rustdesk-server:latestсAPI_SERVERна ваш api-srv. - Клиентам менять Key не нужно.
Переезд «с Pro» официальный путь описан у RustDesk; для ключей/peer DB принцип тот же — сохранить файлы ключей.
| Параметр | Flag / env | Кто | Назначение |
|---|---|---|---|
| Key | -k / KEY |
hbbs, hbbr | Ключ шифрования; по умолчанию hbbs грузит/создаёт пару |
| Bind | -b / BIND |
hbbs, hbbr | Локальный адрес прослушивания |
| Port | -p / PORT |
hbbs, hbbr | Базовый порт (hbbs 21116, hbbr 21117) |
| Relay | -r / RELAY-SERVERS |
hbbs | Если hbbr на другом хосте/порту |
| API proxy | --api-server / API_SERVER |
hbbs | Origin вашего API для HttpProxyRequest |
| Force relay | ALWAYS_USE_RELAY=Y |
hbbs | Только через relay |
| Log | RUST_LOG |
оба | например debug |
Правила API proxy: только пути /api; методы GET/POST/PUT/DELETE; удалённый origin — HTTPS (HTTP только loopback); лимиты тела/заголовков; IP клиента в X-Forwarded-For / X-Real-IP.
Default API_SERVER, если не задан: http://127.0.0.1:<порт_hbbs - 2> (обычно 21114).
AGPL-3.0, как у upstream rustdesk/rustdesk-server.