跳到主要内容

快速开始

Termia 是一款桌面终端(Electron + Go),在常规 shell 之上加入了主机库、远程连接、文件预览与终端内 AI Agent。这一页介绍如何安装、首次打开时会看到什么、如何登录,以及上手后最先该做的几件事。

macOS 用户请使用原生客户端

这个应用是 Termia 面向 Windows 与 Linux 发布的版本。macOS 有独立的原生客户端,是另一个应用, 文档也是单独一套——请从 Termia for macOS 开始。如果你以前在 Mac 上用的是这个 应用,参见从 Electron 版迁移了解哪些数据会带过去。

当前功能指南汇总各项已实现能力与边界。

系统要求​

平台支持架构系统版本
Windowsx64Windows 10 1809 或更高版本、Windows 11
Linuxx64glibc 2.28 或更高(Debian ≥10、RHEL ≥8、Ubuntu ≥20.04 等)

两个平台目前都只打包 x64:electron-builder.config.cjs 没有为 Windows 和 Linux 设置 arch, 因此各自只使用默认架构构建。

安装 Termia​

Termia 按平台打包为:

  • Windows:NSIS 或 MSI 安装包,或 .zip
  • Linux:.deb、.rpm、.snap、.AppImage、.pacman,或 .zip

从你所在组织的发布渠道获取对应平台的安装包,或者自行从源码构建——构建要求以及 task package / task package:enterprise 见仓库根目录的 README。

数据与配置位置​

Termia 把配置和数据分别存放在两个目录,目录名都是 termia,而不是它所派生自的上游项目的名字:

配置(settings.json 及相关文件)在两个平台上都位于 ~/.config/termia,Windows 也是 如此——它没有遵循各平台通常的惯例。

数据(本地数据库、日志与运行时文件)按平台各不相同;保管库文件位于配置目录:

  • Windows:%LOCALAPPDATA%\termia\Data
  • Linux:~/.local/share/termia

以上两个位置都可以通过环境变量 TERMIA_CONFIG_HOME 和 TERMIA_DATA_HOME 覆盖(Linux 上也可用 $XDG_CONFIG_HOME / $XDG_DATA_HOME)。配置目录里具体有什么,见配置。

你连接的每一台远程主机上,也会各自安装一份 wsh 助手,安装位置是该主机上的 ~/.termia——参见 连接。

首次启动​

从本机终端或主机资料库开始;本地使用不要求账号。
从本机终端或主机资料库开始;本地使用不要求账号。查看原图 ↗

首次启动看到的画面取决于这个构建是怎么配置的:

  • 标准构建:Termia 直接打开一个窗口,里面有一个标签页和一个终端区块,可以立即使用。不需要账号 ——终端、标签页、布局、Widgets 与本地文件预览都能完全离线工作。
  • 未预置服务器地址的企业版构建:在主窗口出现之前,Termia 会先显示一个一次性的设置界面,要求填写 你所在组织的 Termia 服务器地址(由你的 IT 管理员提供)。填写后点击"连接";成功后地址会被保存,之后 不会再出现这个界面。如果企业版构建已经预置了服务器地址,则完全跳过这一步。

登录账号​

登录是可选的——本地功能(终端、标签页、布局、Widgets、本地文件预览)不需要账号也能完整使用。登录后 额外获得:

  • 主机及其主密钥、片段、笔记、环境变量与口令封装 SSH 密钥的云同步
  • 使用 Termia Agent 的内置 AI 模型(自定义的、自带 Key 的模型无需登录也能使用)

登录步骤:

  1. 点击标签栏右上角的头像按钮(提示文字:"设置")。
  2. 在 账号 标签页点击"注册或登录"。
  3. Termia 会在你的默认浏览器中打开登录页面,在那里完成注册或登录。
  4. 应用会自动获取登录结果,账号标签页随即显示你的邮箱和"已登录"状态。

要退出登录,回到账号页点击退出登录。可以选择保留本机资料,或在核对云端副本后清理资料库文件(包括主机与主密钥);具体范围见保管库同步与版本管理。

最先该做的几件事​

主机常用字段局部:填写演示地址、用户名与端口,再到检查器下方核对认证设置。
主机常用字段局部:填写演示地址、用户名与端口,再到检查器下方核对认证设置。查看原图 ↗

打开一个终端​

第一个标签页里已经有一个运行着默认 shell 的终端区块——直接开始输入即可。此外:

用添加面板菜单打开终端,或执行新建本地终端(tab:new)开新标签页。当前平台/预设快捷键见键位表。

新建的区块和标签页使用你操作系统账号的默认 shell(bash、zsh、fish、PowerShell 等);wsh—— Termia 自带的 CLI——在每个终端区块里都可以直接使用,用来和应用本身通信(见 wsh 命令)。

保存一个主机​

点击标签栏左上角的房子图标(提示文字:"主页")打开 Vaults 面板,或者在聚焦某个终端区块时按 切换连接(conn:switch)打开连接切换器。在连接切换器里:

  • 选择一个已保存的主机直接连接;或
  • 直接输入 user@host 连接一次,不保存;或
  • 选择"新建 SSH 主机",填写主机地址、用户名、端口和认证方式(密码或密钥),然后点击"保存并连接"。

已保存的主机存放在本地 Vaults 中;完整介绍见主机与 Vaults,当前可同步的数据范围见 Vaults 同步与版本管理。

连接​

主机保存后,随时可以通过连接切换器(切换连接)重新连接,或者直接对着它新建一个终端区块。如果 远程主机可达,但其远程助手(wsh)安装失败,终端本身仍然可以正常使用——只有文件浏览、系统监控和远程 Termia Agent 会受影响,直到你解决根本问题(磁盘空间不足、权限不够、文件系统只读,或远程平台不受支持) 并重新连接。详见连接。

接下来​

  • 在快捷键里了解剩余的快捷键
  • 用布局排列你的区块
  • 用自定义 Widgets为自己的工具添加入口
  • 在Termia Agent里了解如何在终端区块中运行 AI Agent
  • 在配置里深入了解 settings.json 及配置目录下的其他文件

获取帮助​