RustDesk支持 Web 管理后台和网页客户端远程,保姆级教学来了!

2025-07-24 10:31:30 14点赞 127收藏 43评论

RustDesk API本项目使用 Go 实现了 RustDesk 的 API,并包含了 Web Admin 和 Web 客户端。RustDesk 是一个远程桌面软件,提供了自托管的解决方案,官方API是收费的,这次咱们用到的是Github开源的第三方API源码。

RustDesk支持 Web 管理后台和网页客户端远程,保姆级教学来了!

✅特性

PC端API

  • 支持 github , google 和 OIDC 登录,

  • 支持 web后台 授权登录

  • 支持 LDAP (AD和OpenLDAP已测试), 如果API Server配置了LDAP

  • 个人版API

  • 登录

  • 地址簿

  • 群组

  • 授权登录

  • i18n

Web Admin

  • 用户管理

  • 设备管理

  • 地址簿管理

  • 标签管理

  • 群组管理

  • Oauth 管理

  • 配置LDAP, 配置文件或者环境变量

  • 登录日志

  • 链接日志

  • 文件传输日志

  • 快速使用web client

  • i18n

  • 通过 web client 分享给游客

  • server控制

Web Client

  • 自动获取API server

  • 自动获取ID服务器和KEY

  • 自动获取地址簿

  • 游客通过临时分享链接直接远程到设备

  • v2 Preview

CLI

  • 重置管理员密码

Docker部署

飞牛 Compose方式部署代码

1️⃣我们需要先创建一个路径,这个路径储存我们的docker-Compose.yml的文件和配置文件

RustDesk支持 Web 管理后台和网页客户端远程,保姆级教学来了!

2️⃣打开Docker,Compose新增项目->输入项目名称->设置路径->上传或者创建docker-compose.yml把下面代码复制进去,点击完成直至构建完成

RustDesk支持 Web 管理后台和网页客户端远程,保姆级教学来了!

🐳Docker compose

注意: 一定要仔细看注释,看注释,修改对应的域名,先跳到文章后面( 外网访问 )看看怎么使用lucky反代再回来部署,不然无法使用web网页端远程。

networks:

rustdesk-net:

external: false

services:

rustdesk:

ports:

- 21114:21114

- 21115:21115

- 21116:21116

- 21116:21116/udp

- 21117:21117

- 21118:21118

- 21119:21119

image: lejianwen/rustdesk-server-s6:latest

environment:

- RELAY=反代21117的域名:端口

- ENCRYPTED_ONLY=1

- MUST_LOGIN=N # 是否必须登录才能远程

- TZ=Asia/Shanghai

- RUSTDESK_API_RUSTDESK_ID_SERVER=反代21116的域名:端口

- RUSTDESK_API_RUSTDESK_RELAY_SERVER=反代21117的域名:端口

- RUSTDESK_API_RUSTDESK_API_SERVER=反代21114的域名:端口

- RUSTDESK_API_RUSTDESK_WS_HOST=反代21114的域名:端口

- RUSTDESK_API_KEY_FILE=/data/id_ed25519.pub

- RUSTDESK_API_JWT_KEY= # jwt 为空不启用

- RUSTDESK_API_JWT_EXPIRE_DURATION= # jwt 为空不启用

volumes:

- ./data/rustdesk/server:/data

- ./data/rustdesk/api:/app/data #将数据库挂载

networks:

- rustdesk-net

restart: unless-stopped

给大家看看我配置好的截图

RustDesk支持 Web 管理后台和网页客户端远程,保姆级教学来了!

API后台使用

http://IP:21114

后台管理

以上地址访问API后台, 可以进行添加用户,设备管理等操作!

默认管理员用户名为:admin

通过容器日志获取管理员密码,自己查看日志往下翻,找到如下图的内容就是密码

RustDesk支持 Web 管理后台和网页客户端远程,保姆级教学来了!

登录后可以修改一下用户名和密码

RustDesk支持 Web 管理后台和网页客户端远程,保姆级教学来了!

2. 客户端使用

配置21114端口的API后,客户端登录即可同步登录账号的信息。

外网访问

外网访问需要有公网,我家是ipv6.所以需要配合域名使用,通过lucky进行DDNS然后再反向代理,通过域名配置客户端,并且进行访问。

如果不使用网页端远程只反代21114、21116、21117端口就行.

如果需要web网页端远程就需要反代21118端口和21119端口,注意,21118和21119端口反代的前端域名要与21114使用的一样,并且反代的前端地址一定要带详细地址,必须要按照我说的来,不然网页远程不了,会报错,具体设置如下

21118端口:(前端:21114地址/ws/id) ‍

RustDesk支持 Web 管理后台和网页客户端远程,保姆级教学来了!

21119端口 : (前端:21114地址/ws/relay )

RustDesk支持 Web 管理后台和网页客户端远程,保姆级教学来了!

看图已经很明了了,如果还不懂,就私信问我吧,这里弄好了再返回到上面配置compose部署代码,部署就行了。

RustDesk支持 Web 管理后台和网页客户端远程,保姆级教学来了!

配置客户端

配置客户端之前先去容器查看日志获取key

RustDesk支持 Web 管理后台和网页客户端远程,保姆级教学来了!

下载安装客户端

去官网下载对应设备的客户端,我以Windows为例

无法访问github的朋友公众号回复: 远程 获取Windows版网盘下载地址,我会持续更新

# 下载地址https://github.com/rustdesk/rustdesk/releases

RustDesk支持 Web 管理后台和网页客户端远程,保姆级教学来了!

控制端和受控端都需要安装RustDesk,双击下载的exe文件打开就是这个界面,需要点击左边的安装才能完全安装完成

RustDesk支持 Web 管理后台和网页客户端远程,保姆级教学来了!

配置ID/中继服务器

1️⃣点击右上角设置

RustDesk支持 Web 管理后台和网页客户端远程,保姆级教学来了!

2️⃣选择网络,点击解锁网络设置

RustDesk支持 Web 管理后台和网页客户端远程,保姆级教学来了!

3️⃣控制端和受控端都需要设置ID/中继服务器

I D服务器: 填入21116端口反代的域名不加端口

中继服务器 : 填入21117端口 反代的域名 不加端口

API服务器 : 填入21114端口 反代的域名:端口

key : 前面日志里面获取的key

✅ 前面两个开头不要加https或http也不要加端口,切记千万不要加端口,否则连接不上,API需要加https或http

💥再次重申ipv6通过lucky反向代理的朋友,ID、中继服务器域名前面不要加https/http,域名后面也不要加端口,API服务器需要加https/http和端口 ,参考 如下图

RustDesk支持 Web 管理后台和网页客户端远程,保姆级教学来了!

使用方法

使用方法和向日葵、ToDesk一样,知道ID和密码就能远程连接,也可以通过登录账号后同步自己的设备,设置自定义密码直接连接

RustDesk支持 Web 管理后台和网页客户端远程,保姆级教学来了!

登录成功

RustDesk支持 Web 管理后台和网页客户端远程,保姆级教学来了!

底部出现“就绪”才算成功,如果提示(提示未就绪,请检查网络连接)请检查前面第三步重申的内容

如果登录账号后看不到设备,点击设置->常规,停止服务,再开启服务就行了

RustDesk支持 Web 管理后台和网页客户端远程,保姆级教学来了!

网页端

网页端远程访问,最直接的就是访问下面的地址,点击 右上角三个点点,网络配置一下中继服务器,和pc端方法一样,然后登录账号或者直接输入对方的ID远程

RustDesk支持 Web 管理后台和网页客户端远程,保姆级教学来了!

21114端口反向代理域名/webclient2/

或者直接访问21114端口反向代理的域名,登录到后台,点击我的设备-> Web Clien 快速访问

RustDesk支持 Web 管理后台和网页客户端远程,保姆级教学来了!RustDesk支持 Web 管理后台和网页客户端远程,保姆级教学来了!

APP客户端

APP配置如下

RustDesk支持 Web 管理后台和网页客户端远程,保姆级教学来了!RustDesk支持 Web 管理后台和网页客户端远程,保姆级教学来了!

总结

这篇文章部署教程算是详细的了,没有缺斤少两,教程其实很简单,只要你认真看完,百分百能实现web管理、web远程,不会有任何问题,我已经这样使用很久了,使用op软路由拨号的,总是会有问题通讯不上特别是有V4公网的,直接使用DDNS吧,别反代,我是小米路由器,开启了DMZ,通不上的可以试试看。

展开 收起
43评论

  • 精彩
  • 最新
  • 不是官方的安全不?我就怕设备被一窝端了 [喜极而泣]

    校验提示文案

    提交
    没问题的放心用

    校验提示文案

    提交
    收起所有回复
  • 这个版本好像不能公网访问

    校验提示文案

    提交
    可以的,

    校验提示文案

    提交
    支持的哦

    校验提示文案

    提交
    收起所有回复
  • 大佬求教我这个咋回事就是提示未就绪

    校验提示文案

    提交
    可以了我把21116和7从路由器转发出去就好了

    校验提示文案

    提交
    嗯嗯,我开了DMZ,没开就要转发出去

    校验提示文案

    提交
    还有2条回复
    收起所有回复
  • 请问下,能否用windows下的nginx反代实现?我试了很多次都失败

    校验提示文案

    提交
    可以呀,道理一样的,部署好了就行

    校验提示文案

    提交
    1.4.1版本不会出现Failed to secure tcp: Handshake failed: invalid public key from rendezvous server: 请稍后再试这个错误提示吗?

    校验提示文案

    提交
    收起所有回复
  • 大神,反代怎么弄了不行,我是用ddns-go域名解析,lucky单独返代可以吗?加个w教下呗 [观察]

    校验提示文案

    提交
    直接ddns吧,返代感觉问题更多,飞牛部署没啥问题,但是其他系统总是出问题,很奇怪

    校验提示文案

    提交
    收起所有回复
  • 跟你一样的部署方式,为啥我的飞牛的docker日志感觉很简洁,pull完了之后只显示了start,没看到你图中详细的日志,也看不到密码。

    校验提示文案

    提交
    是不是有旧的配置文件没有删除?

    校验提示文案

    提交
    版本更新之后,为了安全没有在日志里面显示出密码;
    可以SSH进入容器,使用 ./apimain reset-admin-pwd 命令修改管理员密码。

    校验提示文案

    提交
    收起所有回复
  • 一步一步照抄下来不行哎,新手头大。api管理没有问题,就是连接id服务器和中继服务器不行

    校验提示文案

    提交
    我开了dmz的,端口全开了

    校验提示文案

    提交
    收起所有回复
  • 不明觉厉 [大囧]

    校验提示文案

    提交
  • 记号

    校验提示文案

    提交
  • 群晖套件版总是登录后自动退,是不是和映射端口有关,还是哪里设置有问题

    校验提示文案

    提交
  • 试试看

    校验提示文案

    提交
  • 有空试试,

    校验提示文案

    提交
  • 可以试试guacamole,连客户端都不用,直接浏览器远程访问

    校验提示文案

    提交
  • 环境是动态公网ipv4域名,已经能外网登录和访问web了

    校验提示文案

    提交
  • 试试看

    校验提示文案

    提交
  • 从昨天开始就彻底连不上服务了,虽然我有个人中继也没用。在北京和河北都不行,不知道为什么

    校验提示文案

    提交
    退出登陆

    校验提示文案

    提交
    收起所有回复
  • 我有公网V4和V6,在你的配置中标注反代的地方我直接使用域名没有加端口。除了web client 报404错误外,都可以正常使用,想请教下web client 404错误的问题如何解决。

    校验提示文案

    提交
  • 带api的不敢用,还是花钱买官方的api服务吧

    校验提示文案

    提交
  • 我登录了账号就没办法远程,把账号登出就可以远程有遇到和我一样的问题吗?

    校验提示文案

    提交
    放弃吧,这东西完全被神话了,我内网自建服务器 极其不稳定,几十台设备经常失联

    校验提示文案

    提交
    收起所有回复
  • 看github上作者说,不使用host网络的话就无法P2P?那使用host网络还能反代吗?

    校验提示文案

    提交
提示信息

取消
确认
评论举报

相关文章推荐

更多精彩文章
更多精彩文章
最新文章 热门文章
127
扫一下,分享更方便,购买更轻松