Skip to content

webssh.md

Latest commit

 

History

History
290 lines (189 loc) · 9.46 KB

webssh.md

File metadata and controls

290 lines (189 loc) · 9.46 KB

Web SSH 终端指南

English

R-Bot 客户端内置了完整的 Web SSH 终端，通过浏览器即可连接和管理远程服务器，无需安装任何客户端软件。

访问方式

启动客户端后，访问：

https://你的IP:9527

默认使用 HTTPS + TLSv1.3，首次访问时浏览器会提示证书不受信任，可手动信任或配置 ACME 自动证书。

页面布局

登录后进入主界面，采用四视图切换布局：

┌─────────────────────────────────────────────────────┐
│ 顶部栏：品牌标识 | 语言 | 主题 | 闪电 | 设置 | 登出 │
├─────────────────────────────────────────────────────┤
│                                                     │
│  主内容区（视图切换）         配置抽屉（右侧滑出）  │
│  · 主机面板                                         │
│  · 终端工作区                                       │
│  · 云管理面板                                       │
│  · 闪电权益                                         │
│                                                     │
└─────────────────────────────────────────────────────┘
区域 说明
顶部栏 品牌标识「R·Cloud·SSH」、语言切换、主题选择（8 种）、闪电权益入口、设置菜单（SSL 证书 / 配置文件）、明暗模式切换、登出
主机面板 登录后默认视图，以卡片网格展示所有已保存的主机会话，支持搜索、云主机同步、添加会话、批量选择
终端工作区 点击主机卡片连接后自动切换，包含标签页栏、终端窗口、SFTP 面板（可拖拽调整高度）
云管理面板 多云资源管理工作台，详见 Web 云管理面板指南
配置抽屉 从右侧滑出的面板，用于填写连接信息、认证方式、端口转发配置

登录认证

支持两种登录方式：

密码登录

使用 client_config 中配置的 username 和 password 直接登录。

Telegram 验证码登录

  1. 点击「发送验证码」
  2. 机器人会通过 Telegram 发送 8 位数字验证码
  3. 在 60 秒内输入验证码完成登录

防护机制：10 分钟内连续请求超过 3 次将触发图片验证码（算术题），防止暴力攻击。

登录页面

SSH 连接

新建连接

  1. 在主机面板点击「添加会话」按钮，右侧滑出配置抽屉
  2. 填写连接信息：
    • 会话名称 — 自定义名称（可选）
    • 主机 — IP 地址或域名
    • 端口 — 默认 22
    • 用户名 — SSH 登录用户
    • 认证方式 — 密码或私钥
  3. 点击「连接」，自动切换到终端工作区

认证方式

方式 说明
密码 输入 SSH 密码
私钥 粘贴私钥内容或选择已保存的密钥，支持 passphrase

SOCKS5 代理

SSH 连接支持通过 SOCKS5 代理建立，适用于网络受限环境。在配置抽屉中填写代理地址和端口即可。

主机指纹验证

首次连接会显示 SHA256 主机指纹，确认后保存。后续连接如果指纹变更（可能是服务器重装或安全风险），会发出警告。

快速连接

在主机面板中，点击已保存主机卡片上的「快速连接」按钮可直接连接，无需重新填写信息。点击卡片上的「加载」按钮可打开配置抽屉编辑连接参数。

断线自动重连

SSH 连接中断时（如服务器 reboot 或网络波动），终端自动尝试重连，采用指数退避策略，无需手动操作即可恢复会话。

多标签页

支持同时打开多个 SSH 连接，每个连接独立一个标签页，可自由切换。标签页栏同时集成了系统资源监控指标（CPU / 内存 / 硬盘 / 网络）。

终端主界面

终端工具条

终端连接后，工具条提供常用功能的快捷入口：

  • 收藏 — 快速收藏当前会话
  • 搜索 — 终端内容搜索
  • 工具栏 — 常用运维工具快捷操作

SFTP 文件管理

连接 SSH 后，点击标签页栏的「SFTP」按钮打开文件管理面板。SFTP 面板位于终端窗口下方，支持拖拽分隔条调整终端和 SFTP 的高度比例。

功能列表

操作 说明
浏览目录 点击文件夹进入，面包屑导航支持快速跳转
上传文件 支持分片上传，显示进度
下载文件 流式传输，512KB 分片 + 滑动窗口确认
在线编辑 支持语法高亮，直接在浏览器中编辑服务器文件
删除文件/文件夹 行内确认操作，支持递归删除目录
创建目录 在当前路径下创建新文件夹

端口转发

在配置抽屉中可配置 SSH 端口转发（连接状态下）。

本地转发（Local Forward）

将远程服务映射到本地端口，例如访问远程数据库：

参数 示例
绑定地址 127.0.0.1
绑定端口 3306
目标地址 127.0.0.1
目标端口 3306

远程转发（Remote Forward）

将本地服务暴露到远程服务器端口。

批量命令

向多个主机同时发送相同命令，适用于批量运维场景。

  1. 在主机面板中勾选目标主机卡片（支持多选）
  2. 底部自动出现批量操作栏，显示已选数量
  3. 在命令输入框中输入命令，点击执行
  4. 进入结果工作台，以网格卡片形式实时展示每台主机的执行状态和输出
  5. 支持在结果工作台中连续执行新命令，无需返回重新选择主机

会话管理

主机面板

登录后默认显示主机面板，以响应式网格布局展示所有已保存的会话卡片。每张卡片显示：

  • 会话名称和描述
  • 主机规格（OS、CPU、内存、硬盘，连接后自动检测）
  • IP 地址（支持一键复制）
  • 最后修改时间
  • 操作按钮：快速连接、加载配置、删除

面板顶部提供搜索框（支持按名称 / IP 过滤）和「添加会话」按钮。

保存会话

连接成功后可在配置抽屉中将当前配置保存为会话，下次在主机面板中直接点击即可连接。保存的信息包括：

  • 会话名称、描述
  • 主机、端口、用户名
  • 认证方式和凭据（加密存储）

SSH 密钥管理

集中管理所有 SSH 私钥：

  • 添加/删除密钥
  • 连接时并发智能匹配已保存的密钥
  • 密钥使用 AES 加密存储

云主机同步

一键从多个云平台发现主机并自动导入到 SSH 会话列表，省去手动添加的麻烦。

支持平台

平台 同步内容
Oracle Cloud (OCI) 所有实例的公网/私有 IP、名称、规格、区域
AWS EC2 实例的公网/私有 IP、名称（Name 标签）、机型、区域
GCP Compute Engine 实例的公网/私有 IP、名称、机型、可用区
DigitalOcean Droplet 的公网/私有 IP、名称、区域、规格
Azure 虚拟机的 IP 地址和实例信息
SolusVM VPS 节点的 IP 地址
VirtFusion 实例的首个公网 IPv4 / IPv6、名称、厂商标识

工作方式

  1. 点击主机面板顶部的「云主机同步」按钮
  2. 系统并行查询所有已配置的云平台 Profile
  3. 通过 SSE（Server-Sent Events）实时显示各平台查询进度
  4. 发现的新主机自动添加到主机面板（已存在的 IP 自动跳过）
  5. 同步完成后显示新增数量、跳过数量和错误信息

同步的主机默认使用 SSH 端口 22，支持 IPv6 地址自动识别。

OCI 对象存储管理

在 Web 界面中直接管理 OCI Object Storage：

操作 说明
浏览 Bucket 列出所有存储桶
浏览对象 支持前缀过滤和分页
上传文件 流式上传，防路径遍历
下载文件 流式下载
删除对象 删除单个文件
创建文件夹 创建目录结构

SSL 证书配置

内置自签证书

客户端默认使用自签 PKCS12 证书，开箱即用。

ACME 自动证书（Let's Encrypt）

支持自动签发和续期 Let's Encrypt 证书，需要：

  1. 一个指向服务器的域名
  2. 80 端口可访问（用于 HTTP-01 验证）

在 Web 界面的「设置」中配置：

参数 说明
域名/IP 证书绑定的域名
邮箱 Let's Encrypt 通知邮箱
验证端口 HTTP-01 验证端口，默认 80

配置后自动签发证书，到期前 2 天自动续期。

多语言支持

Web 界面支持中英文切换，在顶部栏的语言选择器中切换。

  • 简体中文 (zh-CN)
  • English (en)