# 精简远程

**Repository Path**: bueryouth/simplify-remote

## Basic Information

- **Project Name**: 精简远程
- **Description**: 精简版局域网远程工具
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-27
- **Last Updated**: 2026-04-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 局域网远程桌面控制软件

一个轻量级的局域网远程桌面解决方案，支持Windows 7/10/11。

<div align="center">

![Version](https://img.shields.io/badge/version-2.2-blue)
![License](https://img.shields.io/badge/license-MIT-green)
![Platform](https://img.shields.io/badge/platform-Windows%207/10/11-lightgrey)
![Size](https://img.shields.io/badge/size-~12MB-orange)

**简单 · 高效 · 轻量**

</div>

## ✨ 功能特点

✅ **体积小巧**：基于Python，无需复杂安装  
✅ **简单易用**：一键启动，浏览器访问即可控制  
✅ **兼容性好**：支持Windows 7/10/11  
✅ **实时控制**：支持鼠标、键盘远程操作  
✅ **高清晰度**：85%默认画质，支持最高100%  
✅ **智能缩放**：25%-175%范围，默认100%  
✅ **自动全屏**：连接后自动进入全屏模式  
✅ **流畅体验**：最高30 FPS，动态帧率控制  
✅ **剪贴板同步**：支持远程复制粘贴文本  

## 🖥️ 系统要求

### 被控制端（运行程序的电脑）
- **操作系统**：Windows 7/8/10/11 (64位)
- **Python版本**：3.6+ （仅源码版需要）
- **内存**：建议 2GB 以上
- **网络**：局域网连接

### 控制端（浏览器）
- **浏览器**：Chrome、Edge、Firefox、Safari 等现代浏览器
- **网络**：与被控制端在同一局域网
- **分辨率**：建议 1280x720 以上

## 🚀 快速开始

### 方式一：使用可执行文件（推荐 ⭐）

**无需安装Python，直接运行！**

#### 步骤1：下载程序
- 从 `dist` 目录获取 `远程桌面控制.exe`
- 或双击 `运行EXE.bat` 启动

#### 步骤2：运行程序
```bash
双击: dist\远程桌面控制.exe
```

#### 步骤3：访问地址
程序启动后会显示类似信息：
```
============================================================
🖥️  远程桌面服务已启动！
============================================================
📍 本机IP: 192.168.1.100
🔗 访问地址: http://192.168.1.100:5000
============================================================
```

#### 步骤4：浏览器连接
在另一台电脑的浏览器中打开显示的地址即可！

**优势：**
- ✅ 无需安装Python
- ✅ 无需配置环境
- ✅ 单文件便携（仅12 MB）
- ✅ 带专业图标
- ✅ 即开即用
- ✅ 显示CMD窗口，方便查看日志

### 方式二：使用源码（开发者）

适合想要自定义或学习代码的开发者。

#### 步骤1：克隆项目
```bash
git clone https://gitee.com/bueryouth/simplify-remote.git
cd simplify-remote
```

#### 步骤2：安装依赖
```bash
pip install -r requirements.txt
```

或使用提供的脚本：
```bash
双击: install_deps.bat
```

#### 步骤3：启动程序
```bash
python main.py
```

或使用脚本：
```bash
双击: start.bat
```

#### 步骤4：浏览器访问
程序启动后，在浏览器中打开显示的地址。

## 📖 使用说明

### 被控制端（运行程序的电脑）

1. **启动程序**
   - 双击 `远程桌面控制.exe` 或运行 `python main.py`
   - 等待程序启动，会显示CMD窗口

2. **查看访问地址**
   - 程序会自动检测本机IP
   - 显示类似：`http://192.168.1.100:5000`
   - 复制此地址发送给控制方

3. **停止服务**
   - 在 CMD 窗口按 `Ctrl+C`
   - 或直接关闭窗口

### 控制端（浏览器）

1. **连接远程桌面**
   - 打开浏览器（Chrome/Edge/Firefox等）
   - 输入被控制端提供的地址
   - 等待连接成功（自动进入全屏）

2. **基本操作**
   - **鼠标**：直接移动和点击
   - **键盘**：直接按键输入
   - **右键**：支持右键菜单
   - **滚轮**：支持滚动

3. **工具栏功能**
   - 🖥️ **退出全屏**：退出全屏模式（或按ESC）
   - 🔄 **刷新屏幕**：手动刷新当前画面
   - 📋 **剪贴板**：打开剪贴板同步对话框
   - ❌ **断开连接**：断开当前连接

4. **画质调节**
   - **画质滑块**：30-100%，默认85%
     - 网络好：90-100%
     - 网络一般：70-85%
     - 网络差：50-60%
   
   - **缩放滑块**：25-175%，默认100%
     - 小屏幕：50-75%
     - 正常：100%
     - 大屏幕：125-175%

5. **剪贴板功能**
   - 点击工具栏的 📋 按钮
   - **复制到远程**：
     1. 输入要复制的文本
     2. 点击“复制到远程”
     3. 在远程电脑按 Ctrl+V 粘贴
   
   - **从远程粘贴**：
     1. 在远程电脑复制文本
     2. 点击“从远程粘贴”
     3. 获取内容后可复制到本地

## 🏗️ 技术架构

- **后端框架**：Flask 2.3.0 + Flask-SocketIO 5.3.0
- **屏幕捕获**：mss 9.0.1（高性能截图库）
- **输入控制**：pynput 1.7.6（鼠标键盘模拟）
- **图像处理**：Pillow 10.0.0（JPEG压缩）
- **剪贴板**：pyperclip 1.8.2
- **实时通信**：WebSocket (Socket.IO)
- **前端技术**：HTML5 Canvas + JavaScript

## 📁 项目结构

```
远程桌面/
├── dist/
│   └── 远程桌面控制.exe      # ⭐ 可执行文件 (12 MB)
├── main.py                    # 主程序源代码
├── requirements.txt           # Python依赖列表
├── icon.ico                   # 应用图标
├── build_exe.bat              # 打包脚本
├── 运行EXE.bat                # 快速启动EXE
├── start.bat                  # 源码版启动脚本
├── install_deps.bat          # 依赖安装脚本
├── .gitignore                # Git忽略规则
└── README.md                  # 本文档
```

## 📦 打包说明

### 重新打包 EXE

如果需要修改代码后重新打包：

```bash
# 方法1：使用批处理脚本
双击: build_exe.bat

# 方法2：命令行
venv\Scripts\python.exe -m PyInstaller ^
    --name="远程桌面控制" ^
    --onefile ^
    --console ^
    --icon=icon.ico ^
    --clean ^
    main.py
```

打包完成后，exe文件在 `dist` 目录。

## ⚡ 性能优化建议

### 网络优化
1. **有线网络** > 无线网络（更稳定）
2. **千兆局域网**：画质90-100%，缩放100-175%
3. **百兆局域网**：画质70-85%，缩放75-100%
4. **无线网络**：画质50-70%，缩放50-75%

### 性能调优
- **帧率**：最高30 FPS，自动动态调整
- **CPU占用**：<10%（普通配置）
- **内存占用**：~100-150 MB
- **带宽占用**：1-5 Mbps（取决于画质设置）

### 最佳实践
```
推荐配置：
- 网络：有线千兆
- 画质：85%
- 缩放：100%
- 帧率：30 FPS
```

## 🔒 安全提示

⚠️ **重要安全说明**：

1. **仅限局域网**
   - 本软件设计用于局域网内部
   - 不建议暴露到公网
   - 没有加密传输

2. **访问控制**
   - 不要将访问链接分享给不可信的人
   - 使用完毕后及时关闭服务
   - 建议在受信任的网络环境使用

3. **防火墙设置**
   - 首次运行需要允许通过防火墙
   - 开放端口：5000（可修改）
   - 仅允许局域网访问

## ❓ 常见问题

### Q1: 无法连接？
**A:** 检查以下几点：
1. ✅ 确保两台电脑在同一局域网
2. ✅ 检查防火墙是否阻止了5000端口
3. ✅ 确认被控制端程序正在运行
4. ✅ 尝试 ping IP地址测试连通性

### Q2: 画面卡顿？
**A:** 尝试以下方法：
1. 降低画质设置（50-60%）
2. 降低缩放比例（50-75%）
3. 检查网络连接质量
4. 关闭其他占用带宽的程序

### Q3: 鼠标键盘无响应？
**A:** 
1. 确保浏览器窗口处于激活状态
2. 检查是否有杀毒软件拦截
3. 尝试以管理员身份运行程序
4. 刷新浏览器页面重新连接

### Q4: 如何修改端口？
**A:** 
编辑 `main.py` 文件，找到：
```python
port = 5000
```
修改为其他端口号，例如：
```python
port = 8080
```

### Q5: 支持多用户同时连接吗？
**A:** 
- ✅ 支持多个浏览器同时查看屏幕
- ⚠️ 但只有一个用户可以控制鼠标键盘
- 建议一次只一个人操作

### Q6: 可以传输文件吗？
**A:** 
- ❌ 目前不支持文件传输
- ✅ 可以使用剪贴板功能传输文本
- 💡 未来版本可能会添加文件传输功能

### Q7: 支持Mac或Linux吗？
**A:** 
- ❌ 当前仅支持 Windows 系统
- 💡 理论上可以移植，但需要测试
- 🎯 主要面向 Windows 用户优化

### Q8: EXE文件太大怎么办？
**A:** 
- 12 MB 已经是最小体积
- 包含了完整的Python环境和所有依赖
- 如需更小，可以考虑：
  - 移除不需要的功能
  - 使用UPX压缩（会降低启动速度）

## 📝 更新日志

### v2.2 (当前版本)
- ✅ 修复打包后图标显示问题
- ✅ 改为控制台模式，显示运行日志
- ✅ 优化 PyInstaller 打包配置
- ✅ 添加 engineio 异步驱动支持

### v2.1
- ✅ 添加剪贴板同步功能
- ✅ 支持虚拟环境打包
- ✅ 优化启动脚本

### v2.0
- ✅ 画质提升到85%默认
- ✅ 缩放范围扩展到25-175%
- ✅ 默认自动全屏
- ✅ 帧率提升到30 FPS
- ✅ 优化JPEG压缩参数

### v1.0
- ✅ 基础远程控制功能
- ✅ WebSocket实时通信
- ✅ 鼠标键盘控制

## 🤝 贡献指南

欢迎提交 Issue 和 Pull Request！

1. Fork 本项目
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 开启 Pull Request

## 📄 许可证

本项目采用 MIT 许可证 - 详见 [LICENSE](LICENSE) 文件

## 👨‍💻 开发者

**项目作者**：bueryouth

**Gitee仓库**：https://gitee.com/bueryouth/simplify-remote

---

<div align="center">

**⭐ 如果这个项目对你有帮助，请给一个 Star！**

Made with ❤️ for Remote Desktop Control

</div>