使用文档

简介

Cloud Term 是一个基于 React + Rust（Tauri）的跨平台终端工具，提供 Web 端和 Windows / macOS 桌面客户端两种形态，核心能力包括：

• 连接资产管理（文件夹、标签、收藏），SSH Web Terminal
• 集成 SFTP，终端与文件传输一体
• 代码片段、命令历史，键盘流畅操作
• 连接、身份凭证、片段与配置的多端云同步（端到端加密）

无论使用哪种形态，登录同一账号后，连接信息、身份凭证、代码片段与部分设置都可以通过云同步在多台设备间保持一致。

安装

macOS

在下载页选择对应芯片架构的安装包：

• Apple 芯片（M 系列）：下载 Apple Silicon 版本
• Intel 芯片：下载 x86_64 版本

下载完成后打开 .dmg，将 Cloud Term 拖入「应用程序」文件夹即可。桌面客户端支持自动检查更新，有新版本时顶部会出现提醒气泡。

Windows

在下载页下载 Windows 10 / 11（x64）安装包，运行 .exe 按提示安装。同样支持应用内自动检查更新。

Web 端

无需安装，浏览器直接打开 cloud-term.luger.me 即可使用。Web 端与桌面端共用同一套云同步数据。

简单使用

1. 首次打开后，在侧边栏新建一个「连接」，填写主机地址、端口、认证方式（密码 / 私钥）。
2. 双击连接或点击「打开」，会在顶部新建一个终端标签页，即可开始使用终端。
3. 可以使用文件夹对连接分组，使用标签筛选，将常用连接加入收藏（收藏栏支持 快捷键 1-9 快速打开）。
4. 需要传输文件时，在终端面板打开 SFTP 面板，即可在同一个界面完成命令操作和文件上传下载。
5. 想要多台设备保持一致的连接与配置，可以在「设置 → 云同步」中开启云同步，详见 云同步。

功能列表

连接管理

• 文件夹分组、标签筛选、收藏置顶，支持在侧边栏用 Shift + 点击 区间多选、Ctrl/Cmd + 点击 单个增减选中。
• 身份标识（Identity）集中管理密码 / 私钥 / 私钥口令，可在多个连接间复用，凭证加密存储。

SFTP 文件管理

终端面板内可直接打开 SFTP 抽屉，支持目录浏览、返回上级/主目录、刷新，以及文件上传下载，无需切换到其他工具。

代码片段（Snippets）

将常用命令保存为代码片段，终端内右键菜单可直接插入或执行，减少重复输入。

命令历史

记录终端内执行过的命令，方便回溯和再次执行。

外观与主题

支持深色 / 浅色模式、终端主题（背景色、前景色、光标样式）自定义，以及界面字体调整。

快捷键

设置面板的「快捷键」页可以查看和自定义以下快捷键（主修饰键固定为 macOS 下的 ⌘、Windows / Linux 下的 Ctrl，可修改的是配合的字母/符号键位）：

功能	默认快捷键（macOS）	默认快捷键（Windows / Linux）	是否可自定义
打开连接选择器（新建标签）	⌘ T	Ctrl T	✅
关闭当前标签页	⌘ W	Ctrl W	✅
切换到上一个标签页	⌘ [	Ctrl [	✅
切换到下一个标签页	⌘ ]	Ctrl ]	✅
打开 / 关闭终端内搜索	⌘ F	Ctrl F	✅
快速打开收藏栏第 1-9 个连接	⌘ 1 ~ ⌘ 9	Ctrl 1 ~ Ctrl 9	固定，不可改绑（按收藏添加顺序排序）

补充说明：

• 在设置面板对应快捷键上点击按键框即可重新录制，系统会检测是否与其他快捷键冲突；点击「恢复默认」可一键还原全部快捷键。
• 分屏目前通过拖拽标签页到终端面板边缘实现，暂无对应的键盘快捷键。
• 终端内的复制/粘贴通过右键菜单，或在设置中开启「选中即复制」；Ctrl+L 等属于 Shell 自身行为，不是应用层快捷键。

云同步

云同步用于在多台设备之间同步 Cloud Term 的连接、文件夹、标签、收藏、代码片段与部分设置，数据端到端加密，密钥仅保存在本机。当前支持两种 provider（同一时间只能启用一个）：

• GitHub Gist（OAuth 登录，简单快捷）
• GitHub 私有仓库（默认推荐，数据保存在你指定的私有仓库文件中，每次同步产生一个 commit，可通过历史回滚）

云同步 GitHub 私有仓库配置流程

第一步：生成 Fine-grained Personal Access Token

1. 打开 github.com/settings/personal-access-tokens/new（设置面板内也有「打开 token 页面」的直达链接）。
2. Resource owner 选择该私有仓库所属的用户或组织。
3. Repository access 选择 Only select repositories，只勾选用于同步的那个私有仓库。建议单独新建一个专用仓库，因为同步产生的历史 commit 会一直保留在仓库中。
4. 在 Repository permissions 中，将 Contents 权限设置为 Read and write。
5. 生成 Token 并复制保存（Token 只会显示一次）。

第二步：设置同步密钥（Sync Key）

首次使用云同步时，打开 Cloud Term「设置 → 云同步」，需要先创建一个「同步密钥」，用于加密上传到云端的数据。

⚠️ 同步密钥仅保存在本机，用于本地加解密，不会上传。一旦丢失将无法解密已上传的历史数据，请务必妥善保管；也不要与上一步的 GitHub Token 混淆。

第三步：选择并配置「GitHub 私有仓库」

1. 在云服务商列表中选择「GitHub 私有仓库」（默认推荐、置顶），点击「配置」。

2. 在弹出的表单中依次填写：

   字段	说明
   Repository	支持 owner/repo 或 GitHub 仓库 URL（HTTPS / .git 均可），例如 luger1990/cloud-term-sync，保存时会自动解析 owner 和 repo
   Branch	目标分支，默认 main
   同步文件路径	默认 .cloud-term/sync.json；文件不存在时会在首次上传时自动创建
   Fine-grained Personal Access Token	粘贴第一步生成的 Token
   同步连接敏感信息（可选勾选）	勾选后，连接与身份标识中的密码 / 私钥 / 私钥口令也会加密后随云同步数据同步；不勾选则只同步结构，密码等需各设备自行补录

3. 点击「保存」。

保存时的自动校验

保存配置时，Cloud Term 会自动请求 GitHub 校验仓库和 Token，常见提示：

情况	提示
仓库是公开仓库	「该 GitHub 仓库是公开仓库。为了避免同步数据暴露，请改用私有仓库后再保存。」
Token 无效 / 已过期	「GitHub Token 无效或已失效，请重新生成 Token 后再试。」
Token 无权限	「GitHub Token 没有访问该仓库的权限，请确认已选择目标仓库并授予 Contents: Read and write。」
仓库不存在或无权访问	「未找到该私有仓库，或当前 Token 无权访问。请检查仓库地址、Resource owner、Repository access 和 Contents 权限。」

按提示重新检查仓库地址、Token 的 Resource owner / Repository access / Contents 权限设置即可。

第四步：开始同步

保存成功后 Cloud Term 会自动进行首次同步；此后可在云同步面板手动点击「拉取远端」/「上传本地」，也可以开启「自动同步」在数据变更后自动上传。其他设备只需使用相同的同步密钥、相同的仓库配置（可各自生成自己的 Token）即可加入同步。

注意事项

• 每次同步都会在目标仓库产生一次 commit，长期使用会累积较多历史记录，建议使用专用仓库，不要复用有其他用途的仓库。
• 一次只能启用一个云服务商，切换到另一个服务商前需要先断开当前服务商。
• 若两台设备几乎同时修改，Cloud Term 会基于三方合并自动处理新增/删除/修改；真正冲突到同一条数据时以本地为准，并会提示。

本地备份与恢复

每次从云端拉取/合并/按历史恢复数据前，Cloud Term 都会自动在本机生成一份备份（每用户最多保留 5 份），可在「设置 → 存储」中查看并一键恢复，恢复本身也会再次自动备份，操作可逆。