
rustdesk/rustdesk-server-s6这些Docker镜像基于s6-overlay构建,专门用于在容器环境中运行RustDesk Server。s6-overlay提供了轻量的进程管理能力,能自动启停RustDesk Server的两个核心服务:hbbs(ID注册服务)和hbbr(中继服务),适合需要容器化部署的场景。
如果只需简单测试或临时使用,可直接运行以下命令启动容器(首次启动会自动生成服务器密钥):
bashdocker run -d --name rustdesk-server \ -p 21115:21115 -p 21116:21116 -p 21116:21116/udp -p 21117:21117 \ rustdesk/rustdesk-server-s6:latest
生产环境建议挂载数据卷,保存密钥、配置等数据(避免容器删除后丢失):
bash# 创建本地目录用于持久化数据 mkdir -p /path/to/rustdesk-data # 启动容器并挂载数据卷 docker run -d --name rustdesk-server \ -p 21115:21115 -p 21116:21116 -p 21116:21116/udp -p 21117:21117 \ -v /path/to/rustdesk-data:/data \ rustdesk/rustdesk-server-s6:latest
数据卷/data会存放生成的密钥文件(id_ed25519和id_ed25519.pub)及服务日志。
可通过环境变量自定义服务参数,常用变量如下:
| 变量名 | 说明 | 默认值 | 示例值 |
|---|---|---|---|
RUSTDESK_SERVER_KEY | 服务器密钥(hbbs/hbbr共用) | 自动生成 | your_custom_32char_key |
HBBS_ARGS | hbbs服务额外参数 | 空 | -r hbbr.example.com |
HBBR_ARGS | hbbr服务额外参数 | 空 | -l 0.0.0.0:21117 |
RELAY_PORT | 中继服务端口(hbbr) | 21117 | 21118 |
REG_PORT | 注册服务端口(hbbs) | 21116 | 21119 |
指定自定义密钥和端口:
bashdocker run -d --name rustdesk-server \ -p 21115:21115 -p 21119:21119 -p 21119:21119/udp -p 21118:21118 \ -v /path/to/rustdesk-data:/data \ -e RUSTDESK_SERVER_KEY="my_secure_server_key_123" \ -e REG_PORT=21119 \ -e RELAY_PORT=21118 \ rustdesk/rustdesk-server-s6:latest
如果需要修改源码或添加自定义配置,可手动构建镜像:
克隆仓库:
bashgit clone [***] cd rustdesk-server
进入s6目录:
bashcd docker/s6
构建镜像(可指定标签和基础镜像):
bashdocker build -t my-rustdesk-server-s6:latest .
/data目录下的id_ed25519.pub是客户端连接需用的公钥,建议备份。docker logs rustdesk-server查看s6-overlay和服务运行日志,排查问题。

manifest unknown 错误
TLS 证书验证失败
DNS 解析超时
410 错误:版本过低
402 错误:流量耗尽
身份认证失败错误
429 限流错误
凭证保存错误
来自真实用户的反馈,见证轩辕镜像的优质服务