linuxserver/rustdesk

LinuxServer.io rustdesk 容器介绍

LinuxServer.io 团队简介

LinuxServer.io 团队专注于提供高质量容器解决方案，其容器产品具有以下核心优势：

• 定期及时的应用更新，确保功能与安全同步；
• 便捷的用户权限映射（通过 PGID、PUID 配置）；
• 基于 s6 overlay 的自定义基础镜像，优化运行稳定性；
• 每周系统层更新，通过统一基础层减少存储空间占用、 downtime 及带宽消耗；
• 常态化安全更新，降低潜在风险。

rustdesk 容器概述

rustdesk 是一款全功能开源远程控制工具，支持自托管部署，安全性高且配置简单，可作为商业远程控制软件的替代方案。

支持架构

容器通过 Docker manifest 实现多架构适配，拉取 lscr.io/linuxserver/rustdesk:latest 即可自动匹配当前架构。也可通过标签指定架构：

应用配置

访问方式

部署后可通过以下地址访问应用：
`[***]

反向代理注意事项

容器默认使用自签名证书，通信协议为 https。若使用验证证书的反向代理，需禁用对容器的证书校验。

注意：部分现代 GUI 桌面应用可能与 Docker 最新的系统调用限制存在兼容性问题。若主机内核或 libseccomp 版本较旧，可添加 --security-opt seccomp=unconfined 参数允许相关系统调用。

安全提示

[!WARNING]
此容器提供对主机系统的特权访问。除非已正确配置安全措施，否则不要将其暴露到互联网。

• HTTPS 必需：WebCodecs 等现代浏览器功能依赖 HTTPS，HTTP 连接会导致音视频功能失效。
• 默认无认证：可通过 CUSTOM_USER 和 PASSWORD 环境变量启用基础 HTTP 认证（仅建议在可信局域网使用）。若需暴露到公网，强烈推荐搭配反向代理（如 SWAG）并配置强认证机制。
• 权限风险：Web 界面包含带无密码 sudo 权限的终端，任何访问者可在容器内获取 root 权限、安装软件或探测局域网。

环境变量配置

容器基于 Docker Baseimage Selkies 构建，支持以下可选环境变量：

运行参数配置

语言支持

通过 LC_ALL 环境变量设置界面语言，例如：

• 中文：-e LC_ALL=zh_CN.UTF-8
• 日文：-e LC_ALL=ja_JP.UTF-8
• 韩文：-e LC_ALL=ko_KR.UTF-8
• 其他语言：ar_AE.UTF-8（阿拉伯语）、ru_RU.UTF-8（俄语）等。

GPU 加速配置

DRI3 加速（开源驱动）

挂载 GPU 设备可提升应用/游戏性能：
CODE_TOKEN_0
支持的开源驱动：

• Intel：i965/i915（集成显卡）
• AMD：AMDGPU/Radeon/ATI（独立显卡或 APU）
• NVIDIA：仅 nouveau2 驱动（闭源驱动不支持 DRI3）

NVIDIA 加速（Zink 方案）

注意：Alpine 基础镜像不支持 NVIDIA 加速。

通过 Zink 实现 OpenGL 加速，支持硬件编码（x264enc 全帧模式）以降低 CPU 负载。需添加以下运行参数：

• --gpus all：传递所有主机 GPU（可指定具体 GPU）
• --runtime nvidia：使用 NVIDIA 运行时

Docker Compose 配置示例（需先将 NVIDIA 运行时设为默认）：
CODE_TOKEN_1

应用安装方法

PRoot Apps（推荐，持久化）

通过 proot-apps 安装的应用会保存在用户 $HOME 目录，容器重建后仍可保留：
CODE_TOKEN_2
支持的应用列表

原生应用（非持久化）

通过 universal-package-install mod 安装系统原生包（容器重建后需重新安装）：
CODE_TOKEN_3

使用方法

Docker Compose（推荐）

CODE_TOKEN_4

Docker CLI

CODE_TOKEN_5

参数说明

用户/组 ID 配置

卷挂载时需确保主机目录所有者与容器内用户 ID 一致，避免权限问题。通过以下命令获取当前用户的 UID/GID：

bash
id your_user  

输出示例：

text
uid=1000(your_user) gid=1000(your_user) groups=1000(your_user)  

Docker Mods

可通过 Mods 扩展功能：

• rustdesk 专用 Mods
• 通用 Mods

支持与更新

常用操作

• 进入容器终端：

  bash
  docker exec -it rustdesk /bin/bash  
  

• 实时查看日志：

  bash
  docker logs -f rustdesk  
  

• 查看容器版本：

  bash
  docker inspect -f '{{ index .Config.Labels "build_version" }}' rustdesk  
  

更新方法

Docker Compose

bash
# 更新镜像  
docker-compose pull rustdesk  
# 重启容器  
docker-compose up -d rustdesk  
# 清理旧镜像  
docker image prune  

Docker CLI

bash
# 拉取新镜像  
docker pull lscr.io/linuxserver/rustdesk:latest  
# 停止并删除旧容器  
docker stop rustdesk && docker rm rustdesk  
# 用原参数启动新容器（/config 目录会保留配置）  
docker run [原参数] lscr.io/linuxserver/rustdesk:latest  

版本历史

• 22.09.25：基于 Debian Trixie 重构。
• 12.07.25：迁移至 Selkies 基础镜像，HTTPS 成为必需。
• 25.07.24：初始发布。