RemoteConsole

轻量级远程主机管理与实时监控工具，参考 Termius 设计，采用 Python + 原生前端三件套，界面简洁、科技感十足。

功能一览

• 主机管理：添加 / 编辑 / 删除 / 导入 ~/.ssh/config
• 一键连接：SSH 密码或密钥登录，自动端口扫描
• 实时监控：CPU/GPU/内存/进程/网络/磁盘指标，2s 刷新
• 跨平台：macOS / Linux / Windows（WSL）均可运行
• 双击即用：提供 .command 快捷启动，自动安装依赖

快速开始

1. 克隆仓库

   git clone https://github.com/yourname/RemoteConsole.git
   cd RemoteConsole

2. 一键启动（macOS 可双击 Start WebUI.command）

   ./start_webui.sh

   脚本会自动创建虚拟环境、安装依赖、检测端口并打开浏览器。

3. 打开 WebUI 后：

   • 手动添加主机，或点击「从本机SSH配置导入」
   • 点击「连接」→ 成功自动进入监控页，失败显示红色 ✗
   • 监控页右上角「退出监控」可返回主机列表

端口与地址

默认监听 localhost:5000，如被占用会自动递增。自定义示例：

PORT=8000 HOST=0.0.0.0 ./start_webui.sh   # 局域网可访问

开发说明

文件	说明
app.py	Flask 后端 + SSH 连接 + 指标采集
templates/	主页 & 监控页 HTML
static/	CSS（浅色科技风） + JS（无框架）
start_webui.sh	自动装依赖、端口扫描、浏览器打开
data/hosts.json	本地主机数据（已加入 .gitignore）

安全提示

• 密码/密钥仅保存在本地 data/hosts.json，不会被提交到 GitHub
• 若需多人共用，建议改用密钥认证，并限制文件权限 chmod 600
• 生产环境请使用 WSGI（gunicorn / uvicorn）部署，并加 HTTPS / 登录鉴权

常见问题

Q1: 双击 .command 提示“无法打开，因为无法验证开发者”？
A: 右键 → 打开 → 仍要打开，即可绕过 Gatekeeper，仅首次需要。

Q2: 连接主机失败？
A: 检查远程是否开启 PasswordAuthentication 或对应密钥是否匹配；查看浮层详细报错。

Q3: 监控页 GPU 无数据？
A: 确保远程已安装 NVIDIA 驱动与 nvidia-smi；AMD/Intel 显卡暂不支持。

后续计划

• WebSocket 推送，降低轮询开销
• 暗黑主题一键切换
• 多用户 / 权限系统
• 移动端适配

许可证

MIT © 2025 RemoteConsole Contributors