# rootdesk

**Repository Path**: cxvh/rootdesk

## Basic Information

- **Project Name**: rootdesk
- **Description**: RootDesk 只要有浏览器，你就能随时随地掌控你的远程控制设备。
支持Windows 7 / 8 / 10 / 11
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: https://rootdesk.cn
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 11
- **Created**: 2026-09-08
- **Last Updated**: 2026-09-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🚀 RootDesk: 可能是最优雅的开源 Web 远程控制方案

> 打破设备边界，让远程控制像刷网页一样简单！

RootDesk 是一款专为开发者和极客打造的**全栈远程控制系统**。无需安装臃肿的桌面软件，只要有浏览器，你就能随时随地掌控你的远程设备，兼顾便捷性与安全性，适配个人、工作室及小型企业的私有化远控需求。

🔥 在线体验直达：[**rootdesk\.cn**](http://rootdesk.cn)，无需部署，打开浏览器即可快速体验所有核心远控功能，零门槛上手！


---

## ✨ 为什么选择 RootDesk？

传统的远控软件要么收费昂贵、功能冗余，要么体积庞大、操作繁琐。RootDesk 坚守“极简+强大”的核心定位，精准解决开发者与极客的远程控制痛点：

- 🌐 **纯 Web 控制**：打开浏览器即用，无需安装任何客户端（被控端除外），支持手机/平板/电脑跨端无缝操作，摆脱设备限制。
- 🏠 **支持私有化部署**：数据完全由你自主掌控，可轻松部署在内网、私有云或个人服务器，避免公网传输带来的安全隐患，隐私无忧。
- ⚙️ **灵活配置**：客户端内置可视化设置面板，支持自定义服务器 IP/域名及端口，一键适配你的私有控制端，部署后快速上手。
- ⚡ **毫秒级响应**：基于 WebSocket 实时双向加密通信，指令下发瞬间到达，桌面同步无延迟，操作体验媲美本地操作。
- 🐍 **轻量级客户端**：基于 Python 核心编译，绿色免安装、无捆绑插件，代码透明可审计，安全可控，不占用过多系统资源。
- 🎨 **颜值即正义**：采用 Shadcn UI + Tailwind CSS 构建，极简黑白灰设计风格，界面简洁流畅，高级感拉满，兼顾美观与实用性。
- 🛠️ **全能工具箱**：不止于基础屏幕控制，更集成文件管理、进程监控、远程终端、双向语音、音频监听、私有屏幕等深度功能，满足多场景使用需求。

---

## 🛠️ 核心功能一览

| 功能 | 描述 |
| :--- | :--- |
| 🖥️ 实时桌面 | 高清流畅的屏幕画面同步，支持远程点击、拖拽、缩放，操作精准无偏差，适配不同分辨率设备。 |
| 📁 文件管理 | 像网盘一样便捷浏览远程设备文件，支持上传、下载、删除、重命名、新建文件夹，跨设备传文件更高效。 |
| 💻 远程终端 | 直接在网页端执行 CMD/Shell 命令，支持命令历史记录、复制粘贴，运维调试更便捷，堪称开发者神器。 |
| 📊 进程监控 | 实时查看远程设备 CPU、内存、硬盘、网络资源占用情况，可一键结束流氓进程、释放系统资源。 |
| 🏠 私有化连接 | 客户端内置设置面板，支持填写私有服务器 IP/域名及端口，自定义连接参数，适配不同部署环境。 |
| 🔄 开机自启 | 支持系统服务安装，远程设备重启后自动运行客户端，确保设备永久在线，无需手动启动。 |
| 🔒 锁屏解锁 | 深度集成系统权限，支持远程锁定与解锁屏幕，保护远程设备数据安全，防止他人误操作。 |
| 🎧 音频监听 | 实时同步远程设备音频输出，清晰听见远程设备的声音，适用于远程排查音频问题、监控设备状态。 |
| 🎤 麦克风通话 | 支持双向语音对讲，远程喊话、技术指导、协同办公更高效，无需额外借助通讯工具。 |
| 🎮 虚拟按键 | 支持模拟游戏手柄按键，实现手机端远程玩电脑游戏，适配主流游戏操作布局。 |
| 🕵️ 私有屏幕 | 远程操作时可开启“隐私模式”，黑掉对方显示器，隐藏操作内容，保护敏感操作隐私，避免信息泄露。 |
| 📱 安卓被控 | **(即将推出)** 支持安卓设备作为被控端，实现电脑、手机跨平台远控，覆盖更多设备场景。 |
| ℹ️ 系统详情 | 远程设备 CPU、内存、硬盘、网络、系统版本等信息一目了然，便于快速了解设备状态。 |
| 📢 广告推送 | 内置灵活的广告/通告位，支持远程动态更新，适合企业内部推送通知、公告等内容。 |

---
![客户端](%E5%AE%A2%E6%88%B7%E7%AB%AF%E7%95%8C%E9%9D%A2.png)
![服务端](%E6%8E%A7%E5%88%B6%E7%AB%AF%E7%95%8C%E9%9D%A2.png)

## 🚀 服务端快速部署与访问

### 1. 脚本一键安装 (推荐)

针对 Linux 服务器，我们提供了极简的一键安装脚本，自动处理环境依赖与服务部署：
服务器最低配置要求：
- CPU：2核
- 内存：2GB
- 硬盘：10GB 
- 宽带：100Mbps

```bash
# Linux 一键安装命令
curl -sSL https://rootdesk.cn/install_script/install.sh | bash -s

```

### 2. Nginx 配置 (可选)

如果你需要使用域名访问或配置 SSL 证书，可以使用以下脚本快速安装并配置 Nginx（需提前准备好域名和证书）：

```bash
# 安装 Nginx 并配置域名 (请将 rootdesk.cn 替换为你的域名)
curl -sSL https://rootdesk.cn/install_script/install_nginx.sh | bash -s -- rootdesk.cn

```
  


## 🚀 客户端部署与配置网络

### 1. 下载与运行客户端 (Client)
windows 下载并安装python 3.8.10 环境
- 下载[Python 3.8.10 安装包](https://www.python.org/ftp/python/3.8.10/python-3.8.10-amd64.exe)
- 双击安装包，按照提示安装 Python 3.8.10 环境
- 下载客户端源代码 进入 客户端 文件夹 运行 打包为exe.cmd 脚本，即可生成客户端可执行文件。




#### 系统支持

Windows 7 / 8 / 10 / 11（x64/x86 架构），确保系统已安装 Python 3.8.10 环境（客户端依赖该版本 Python 核心运行，不建议使用其他版本，避免出现兼容性问题）。

#### 配置服务器连接
1. 进入客户端主界面；
2. 在客户端界面的 “设置” - "网络设置" 选项卡中，填写你部署的控制端 **服务器地址**（IP 或域名）和 **端口**，点击“保存配置”；
3. 连接成功：返回首页，系统会自动尝试连接服务器，连接成功后会显示设备 ID 和连接状态，此时 Web 控制端即可搜索并控制该设备；
4. 可选设置：在“设置”中可开启“开机自启”“后台运行”，确保设备重启后仍能正常连接。

---

## 📦 客户端第三方依赖说明

<small>所有组件均为官方原版，无篡改、无捆绑，来源可溯源、合规安全。</small>

| 组件名称 | 用途说明 | 官方来源 / 源码仓库 |
| :--- | :--- | :--- |
| **Interception** | 开源 Windows 底层键鼠监听、输入模拟驱动，用于系统级输入控制 | [oblitum/Interception](https://github.com/oblitum/Interception) |
| **PsExec** | 微软官方工具，用于 Windows 本地/远程高权限进程调用、指令执行 | [Microsoft Docs](https://learn.microsoft.com/zh-cn/sysinternals/downloads/psexec) |
| **NSSM** | 开源轻量服务托管工具，用于将程序封装为系统服务，实现常驻运行 | [nssm.cc](https://nssm.cc/download) |

---

## ⚔️ RootDesk 对比 ToDesk 核心优势

ToDesk 作为主流远程控制工具，虽具备基础远控功能，但在隐私安全、功能灵活性及成本控制上存在明显局限，RootDesk 针对性突破 these 痛点，更适配开发者、工作室及小型企业的核心需求：

- 🔒 **隐私安全更有保障**：RootDesk 支持私有化部署，数据全程 TLS 加密传输，无第三方平台介入，从根源上避免数据被窃取、滥用的可能。
- 💸 **全功能免费**：所有核心功能（远程桌面、文件管理、进程监控、双向语音等）完全免费，无设备连接数量、功能使用时长限制。
- 🌐 **纯 Web 控制**：无需安装多余客户端，打开浏览器即可使用，支持手机、平板、电脑跨端无缝操作。
- 🐍 **轻量无捆绑**：绿色免安装，基于 Python 核心编译，无任何捆绑插件，体积小巧，启动速度更快。
- 🛠️ **更贴合开发者需求**：内置远程终端（CMD/Shell）、进程监控、系统详情查看等专业运维功能。
- ⚙️ **灵活可控**：支持自定义服务器地址，可灵活部署在内网、私有云等多种环境。

 

---

## 📅 下期版本预告 (Roadmap)
- [ ] **自动化运维监控**（开发中 🚀，实现屏幕自动化操作与自动通知）
- [ ] **Android 被控端**（开发中 🚀，预计近期上线）


---

## 💡 注意事项

- 服务端部署时请确保服务器 3000/3478 端口未被占用；
- 客户端运行需依赖 Python 3.8.10 环境，若启动失败请检查版本；

**如果这个项目对你有帮助，请点个 ⭐️ Star 关注我们的进度，你的支持是我们持续优化的动力！**