linuxserver/rustdesk是一款基于Rust语言开发的开源远程桌面工具Docker镜像,提供便捷的远程控制、文件传输和屏幕共享功能。得益于Docker容器化部署,具有安装简单、配置灵活的特点,同时支持自建服务器,确保数据传输安全与隐私保护。该镜像继承了RustDesk原生的高性能与低延迟特性,兼容Windows、macOS、Linux等多平台系统,适用于个人远程办公、家庭设备管理及企业IT运维等场景,是一款轻量高效且安全可靠的远程桌面解决方案。
收藏数: 23
下载次数: 136512
类型:
linuxserver/rustdeskLinuxServer.io 团队专注于提供高质量容器解决方案,其容器产品具有以下核心优势:
rustdesk 是一款全功能开源远程控制工具,支持自托管部署,安全性高且配置简单,可作为商业远程控制软件的替代方案。
容器通过 Docker manifest 实现多架构适配,拉取 lscr.io/linuxserver/rustdesk:latest 即可自动匹配当前架构。也可通过标签指定架构:
| 架构 | 支持状态 | 标签格式 |
|---|---|---|
| x86-64 | ✅ | amd64-<version tag> |
| arm64 | ✅ | arm64v8-<version tag> |
部署后可通过以下地址访问应用:
`[***]
容器默认使用自签名证书,通信协议为 https。若使用验证证书的反向代理,需禁用对容器的证书校验。
注意:部分现代 GUI 桌面应用可能与 Docker 最新的系统调用限制存在兼容性问题。若主机内核或 libseccomp 版本较旧,可添加
--security-opt seccomp=unconfined参数允许相关系统调用。
[!WARNING]
此容器提供对主机系统的特权访问。除非已正确配置安全措施,否则不要将其暴露到互联网。
CUSTOM_USER 和 PASSWORD 环境变量启用基础 HTTP 认证(仅建议在可信局域网使用)。若需暴露到公网,强烈推荐搭配反向代理(如 SWAG)并配置强认证机制。sudo 权限的终端,任何访问者可在容器内获取 root 权限、安装软件或探测局域网。容器基于 Docker Baseimage Selkies 构建,支持以下可选环境变量:
| 变量名 | 说明 |
|---|---|
CUSTOM_PORT | 内部 HTTP 端口,默认 3000 |
CUSTOM_HTTPS_PORT | 内部 HTTPS 端口,默认 3001 |
CUSTOM_WS_PORT | WebSocket 内部端口,默认 8082 |
CUSTOM_USER | HTTP 基础认证用户名,默认 abc |
PASSWORD | HTTP 基础认证密码,未设置则禁用认证 |
SUBFOLDER | 反向代理子路径(需包含首尾斜杠,如 /subfolder/) |
TITLE | 网页标题,默认 "Selkies" |
START_DOCKER | 设为 false 可禁用 Docker-in-Docker 自动启动 |
DISABLE_IPV6 | 设为 true 禁用 IPv6 |
LC_ALL | 系统 locale(如 zh_CN.UTF-8 对应中文) |
DRINODE | 指定 DRI 设备节点(如 /dev/dri/renderD128) |
NO_DECOR | 设为 true 禁用窗口边框(适合 PWA 使用) |
NO_FULL | 设为 true 禁用自动全屏 |
DISABLE_ZINK | 设为 true 禁用 Zink 环境变量配置 |
WATERMARK_PNG | 水印图片路径(如 /usr/share/selkies/www/icon.png) |
WATERMARK_LOCATION | 水印位置(1-左上,2-右上,3-左下,4-右下,5-居中,6-动画) |
| 参数 | 说明 |
|---|---|
--privileged | 启动 Docker-in-Docker 环境,建议挂载主机 Docker 数据目录(如 -v /path/to/docker-data:/var/lib/docker)提升性能 |
-v /var/run/docker.sock:/var/run/docker.sock | 挂载主机 Docker 套接字,允许容器管理主机容器 |
--device /dev/dri:/dev/dri | 挂载 GPU 设备,配合 DRINODE 可实现 DRI3 加速 |
通过 LC_ALL 环境变量设置界面语言,例如:
-e LC_ALL=zh_CN.UTF-8-e LC_ALL=ja_JP.UTF-8-e LC_ALL=ko_KR.UTF-8ar_AE.UTF-8(阿拉伯语)、ru_RU.UTF-8(俄语)等。挂载 GPU 设备可提升应用/游戏性能:
bash--device /dev/dri:/dev/dri
支持的开源驱动:
注意:Alpine 基础镜像不支持 NVIDIA 加速。
通过 Zink 实现 OpenGL 加速,支持硬件编码(x264enc 全帧模式)以降低 CPU 负载。需添加以下运行参数:
--gpus all:传递所有主机 GPU(可指定具体 GPU)--runtime nvidia:使用 NVIDIA 运行时Docker Compose 配置示例(需先将 NVIDIA 运行时设为默认):
yamlservices: rustdesk: image: lscr.io/linuxserver/rustdesk:latest deploy: resources: reservations: devices: - driver: nvidia count: 1 capabilities: [compute,video,graphics,utility]
通过 proot-apps 安装的应用会保存在用户 $HOME 目录,容器重建后仍可保留:
bash# 示例:安装 filezilla proot-apps install filezilla
支持的应用列表
通过 universal-package-install mod 安装系统原生包(容器重建后需重新安装):
yamlenvironment: - DOCKER_MODS=linuxserver/mods:universal-package-install - INSTALL_PACKAGES=libfuse2|git|gdb # 需安装的包,用 | 分隔
yaml--- services: rustdesk: image: lscr.io/linuxserver/rustdesk:latest container_name: rustdesk environment: - PUID=1000 # 用户ID(通过 `id your_user` 获取) - PGID=1000 # 组ID(同上) - TZ=Etc/UTC # 时区(如 Asia/Shanghai) volumes: - /path/to/config:/config # 配置文件存储路径(需替换为实际路径) ports: - 3000:3000 # HTTP端口(建议反向代理时使用) - 3001:3001 # HTTPS端口(直接访问用) shm_size: "1gb" # 桌面应用推荐配置 restart: unless-stopped
bashdocker run -d \ --name=rustdesk \ -e PUID=1000 \ -e PGID=1000 \ -e TZ=Etc/UTC \ -p 3000:3000 \ -p 3001:3001 \ -v /path/to/config:/config \ --shm-size="1gb" \ --restart unless-stopped \ lscr.io/linuxserver/rustdesk:latest
| 参数 | 作用 |
|---|---|
-p 3000:3000 | HTTP 桌面界面端口(需反向代理) |
-p 3001:3001 | HTTPS 桌面界面端口(直接访问) |
-e PUID=1000 | 用户ID,避免权限问题(通过 id your_user 获取) |
-e PGID=1000 | 组ID,同上 |
-e TZ=Etc/UTC | 时区设置,如 Asia/Shanghai |
-v /config | 容器内用户主目录,存储配置和本地文件 |
--shm-size= | 共享内存大小,桌面应用建议设为 1gb |
卷挂载时需确保主机目录所有者与容器内用户 ID 一致,避免权限问题。通过以下命令获取当前用户的 UID/GID:
bashid your_user
输出示例:
textuid=1000(your_user) gid=1000(your_user) groups=1000(your_user)
可通过 Mods 扩展功能:
bashdocker exec -it rustdesk /bin/bash
bashdocker logs -f rustdesk
bashdocker inspect -f '{{ index .Config.Labels "build_version" }}' rustdesk
bash# 更新镜像 docker-compose pull rustdesk # 重启容器 docker-compose up -d rustdesk # 清理旧镜像 docker image prune
bash# 拉取新镜像 docker pull lscr.io/linuxserver/rustdesk:latest # 停止并删除旧容器 docker stop rustdesk && docker rm rustdesk # 用原参数启动新容器(/config 目录会保留配置) docker run [原参数] lscr.io/linuxserver/rustdesk:latest
以下是 linuxserver/rustdesk 相关的常用 Docker 镜像,适用于 不同场景 等不同场景:
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 版本下载页面。





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