DOCUMENTATION

HelloShell 使用方式

从第一次连接服务器开始,了解终端、文件管理、监控、隧道和便携数据的使用方式。

安装与便携版

安装版

下载安装程序后按向导完成安装,可自动创建桌面快捷方式并注册卸载入口。默认不会删除已有配置,卸载时也会保留应用数据。

绿色便携版

下载 ZIP 后解压,会得到一个完整的 HelloShell-Portable-版本号/ 文件夹。打开文件夹并运行 HelloShell.exe;首次启动时,程序会在自身旁边自动生成 data/ 配置目录。

以后移动或备份整个文件夹,程序与配置会一起迁移。拷贝到另一台电脑即可继续使用,无需重新配置。

不要把绿色版放在需要管理员权限才能写入的系统目录(如 Program Files),否则配置保存和自动更新可能失败。

创建连接

  1. 点击新建连接,填写名称、主机地址和 SSH 端口。
  2. 选择密码、私钥或 SSH Agent 认证;私钥可配置 passphrase。
  3. 首次连接时核对服务器主机指纹,选择接受一次或保存到本地。
  4. 连接成功后,终端、SFTP 和服务器监控会自动初始化。

连接可以放入文件夹并拖拽排序;跳板机场景可配置多级 ProxyJump。常用连接支持设置快捷命令与隧道规则自动启动。

终端操作

终端支持多标签、搜索、Unicode、网页链接、中文输入法和断线自动重连。标签可以拖出为独立窗口,再重新附着回主窗口,会话跨窗口转移。

  • 右键行为、选中即复制、字体、光标与配色可在设置中调整。
  • 终端执行 cd 后,可同步更新文件管理器的远程目录。
  • 快捷命令支持参数模板,并可发送到全部已连接会话。
  • 终端背景支持主题色、亮色、暗色与自定义背景图,与配色方案完整联动。

文件管理

文件管理器包含目录树、文件列表、地址栏和搜索。支持上传、下载、重命名、删除、复制、权限修改、压缩与解压。

  • 大文件会根据大小自动选择并行分段传输路径。
  • 中断的下载可以续传,文件夹传输显示逐文件进度。
  • 文本文件可直接使用 Monaco 编辑器打开并保存。
  • 图片、文本、PDF 和常见音视频可以直接预览。
  • 工具栏支持按文件与文件夹分别上传,目录任务多路并发。

服务器监控

连接后自动采集 CPU、内存、磁盘、网络、负载和运行时间。大部分 Linux 指标直接读取 /proc,减少额外 shell 进程开销。

监控面板展示资源曲线、连接状态与 Ping 延迟;网络柱每秒更新,指标稳定排序显示。

进程管理器可以搜索和排序进程,查看单个进程详情,并发送 SIGTERM 或 SIGKILL。终止进程前请确认目标 PID。

端口隧道

HelloShell 支持三种 SSH 转发:

  • 本地转发:把本地端口映射到远程服务。
  • 远程转发:让远程服务器访问本地服务。
  • 动态转发:创建 SOCKS5 代理。

常用规则可以设为连接后自动启动,并在隧道管理器中查看实时状态、一键启停。

数据与安全

密码、私钥、代理和跳板机凭据使用 Windows safeStorage(DPAPI)保护,敏感凭据不会回传到渲染界面,Worker 进程只接收解密后的会话凭据。

导出配置前请妥善保护导出文件。绿色版的 data/ 目录包含连接配置,不应上传到公开网盘或版本库。

同机自动解锁;如需跨电脑迁移凭据,可在"设置 → 安全"启用恢复密码。

软件更新

HelloShell 启动后会静默检查更新。有新版本时,左上角版本号旁出现"更新"气泡,悬停可查看更新说明。

  1. 点击"更新"后台下载,并校验 SHA256 与签名。
  2. 下载完成后按钮变为"重启更新"。
  3. 点击后自动备份当前版本、安装并重启,升级后展示本次更新内容。

更新失败时自动恢复备份并重新启动旧版本,日志保存在 data/update.log

常用快捷键

  • Ctrl + N:新建连接
  • Ctrl + ,:打开设置
  • Ctrl + W:关闭当前弹窗或标签
  • Ctrl + = / - / 0:终端缩放
  • Ctrl + Shift + F:终端搜索
  • F11:切换全屏
  • Alt + / :切换终端与文件管理区域

常见问题

Windows 提示未知发布者

HelloShell 当前可能没有商业代码签名证书。确认下载地址为本站并核对 SHA256 后,可以通过"更多信息"继续运行。

自动更新失败

确认程序目录具有写入权限,并检查安全软件是否拦截。绿色版不要放在 Program Files 等受保护目录,更新失败会自动回滚。

连接失败

确认主机、端口、防火墙和认证信息。错误提示会提供中文参考,但仍应结合服务器 SSH 日志定位。

中文输入异常

若中文输入法确认时丢字,请更新到 6.1.1+;该版本已修复 IME 提交与空格重复问题。