🔐 CLAY 远程管理系统：跨平台设备集中控制解决方案

CLAY 远程管理系统是一款基于 Python 与 WebSocket 技术栈开发的轻量级远程控制工具，旨在通过浏览器界面实现对多台不同平台的设备进行集中化管理。无论是个人设备远程维护、小型办公网络管控，还是跨地域设备监控，CLAY 都能提供稳定、高效的解决方案。

官网 CLAY 远程管理系统

开源地址CLAY 远程管理系统：跨平台设备集中控制解决方案

✨ 功能亮点

基础控制能力

📋 交互式终端：支持所有系统原生命令，实时输出执行结果，保留完整命令历史
⚡ 低延迟响应：基于 WebSocket 全双工通信，命令执行与反馈几乎无感知延迟
📂 目录导航：支持 cd 命令切换工作目录，自动显示目录内容，操作体验与本地终端一致

设备监控功能

🖥️ 屏幕捕获：实时获取设备屏幕内容，支持画质（0-100%）与刷新频率调节，平衡清晰度与带宽占用
📹 摄像头访问：远程调用设备摄像头，一键捕获实时画面，支持应急监控场景
📊 系统信息：实时展示 CPU 使用率、内存占用、磁盘空间、网络流量等硬件状态

设备管理特性

🔗 多客户端支持：服务器可同时管理数十台设备，通过设备名称快速区分与切换
🔄 自动重连：网络中断后自动尝试重连，恢复连接后无缝继续控制
🚀 开机自启：客户端支持开机自动运行，设备重启后无需手动干预即可重新上线
🕵️ 进程隐藏：客户端可隐藏运行窗口与进程名称，适合无人值守场景

🎨 界面预览

功能场景	界面截图
登录验证
设备列表
终端控制
内置指令
媒体监控

🛠️ 详细部署指南

服务器端部署

环境要求

操作系统：Windows 10/11、Linux（Ubuntu 18.04+、CentOS 7+）、macOS 10.15+
Python 版本：3.7 及以上
网络：确保服务器端口（默认 5000）可被客户端访问

安装步骤

获取源码 克隆仓库或下载源码包，解压后进入项目目录。

安装依赖

# 进入服务器目录
cd server
# 安装依赖包
pip install -r requirements.txt

配置服务器参数 编辑 server/config.py 文件，根据实际需求修改核心配置：

# 核心配置：安全密钥登录密码（必填）
SECRET_KEY # 更改为您自己的安全密钥
ADMIN_PASSWORD # 更改为您自己的登录密码

# 可选配置：根据网络环境调整
SERVER_HOST # 设置监听地址（默认0.0.0.0表示所有网络接口）
SERVER_PORT # 设置监听端口（默认5000）

客户端部署

环境要求

支持系统：Windows 7+、Linux（Ubuntu/Debian/CentOS）、macOS 10.13+
Python 版本：3.7 及以上（打包后可脱离 Python 环境运行）

安装步骤

安装依赖

# 进入客户端目录
cd client
# 安装依赖包
pip install -r requirements.txt

配置服务器连接 编辑 client/config.py 文件，设置服务器地址：

# 核心配置：服务器地址（必填）
SERVER_URL = "http://your_server_ip:5000"  # 替换为实际服务器IP和端口

# 可选配置：根据网络环境调整
HEARTBEAT_INTERVAL = 30  # 心跳包发送间隔（秒）
RECONNECT_DELAY = 10     # 断线重连间隔（秒）
SCREENSHOT_INTERVAL = 2  # 屏幕截图刷新间隔（秒）

功能开关配置 可根据需求开启 / 关闭以下功能：

HIDE_PROCESS = True  # 隐藏进程窗口（默认开启）

🚀 系统运行指南

启动服务器

cd server
# Windows 系统
python app.py
# Linux/macOS 系统
python3 app.py

启动成功后，终端将显示：Running on http://0.0.0.0:5000/ (Press CTRL+C to quit)

启动客户端

cd client
# Windows 系统
python client.py
# Linux/macOS 系统
python3 client.py

客户端启动后无界面（默认隐藏），可通过服务器 Web 界面确认连接状态。

访问控制界面

打开浏览器，访问 http://服务器IP:5000（替换为实际服务器地址）
输入 server/app.py 中配置的 ADMIN_PASSWORD 登录
在「设备列表」中选择已连接的客户端，即可进行远程操作

📦 客户端打包为可执行文件

为简化在无 Python 环境设备上的部署，可将客户端打包为系统原生可执行文件：

打包步骤

安装打包工具
```
pip install pyinstaller
```

执行打包命令

cd client

# Windows 平台（生成 .exe 文件）
pyinstaller --onefile --noconsole --icon=icon.ico client.py

# Linux 平台（生成可执行文件）
pyinstaller --onefile --noconsole --icon=icon.png client.py

# macOS 平台（生成 .app 应用）
pyinstaller --onefile --noconsole --icon=icon.icns client.py

--onefile：打包为单个文件
--noconsole：隐藏控制台窗口（调试时可移除）
--icon：指定程序图标（可选）

获取打包产物 打包完成后，可在 client/dist 目录下找到生成的可执行文件（如 client.exe），直接复制到目标设备运行即可。

🔒 安全加固建议

基础安全措施

修改默认密码：务必替换 server/config.py 中的 SECRET_KEY 和 ADMIN_PASSWORD，避免使用弱密码
限制网络访问：通过防火墙仅开放服务器端口给信任的 IP 地址
定期更新：及时更新客户端和服务器代码，修复潜在安全漏洞

❓ 常见问题解决

客户端无法连接服务器
- 检查 SERVER_URL 是否正确（IP、端口是否可达）
- 确认服务器已启动且防火墙未拦截端口
- 测试网络连通性：ping 服务器IP + telnet 服务器IP 端口
屏幕截图 / 摄像头无画面
- Windows：检查设备是否开启「屏幕捕获权限」「摄像头权限」
- Linux：确保当前用户有 sudo 权限（部分桌面环境需要）
- macOS：在「系统设置 - 安全性与隐私」中授予终端 / 应用访问权限
打包后无法运行
- 确保打包时已关闭杀毒软件（可能误删文件）
- 检查 config.py 中服务器地址是否正确（打包后无法修改）
- 尝试移除 --noconsole 参数，查看运行时错误信息