Voltius 是一款轻量快速的本地优先（Local-first）SSH/SFTP 客户端，也是 Termius 的开源替代品。本教程面向新手，带你从零安装 Voltius，三分钟建立第一条 SSH 连接，并掌握文件夹整理、命令面板、分屏终端与 SFTP 文件传输等高效管理服务器的实用技巧。

Voltius 是什么？为什么推荐它 🤔

Voltius 用 Rust + Tauri 构建，安装包约 40MB，内存占用约 300MB，比传统 Electron 客户端轻得多。它不需要注册账号就能完整使用——所有数据（私钥、密码、服务器清单）经加密后只保存在你的设备上，支持 Windows、Linux、macOS 和 Android。

完整特性与架构说明见项目入口文档 README.md。

一键安装 Voltius：3 个平台的最快方法 🚀

几点小提示：

• Linux：预编译包需要 glibc 2.39+（Ubuntu 24.04+ / Debian 13+ / Fedora 40+），旧发行版可改用 Flatpak 安装。
• macOS：0.63.0 起已签名并通过 Apple 公证，首次启动若仍被 Gatekeeper 拦截，右键应用选择"打开"即可。
• Windows：SmartScreen 提示发布者未验证时，选择"更多信息 → 仍要运行"。
• Android（早期预览版）：通过 Obtainium 应用跟踪官方发布自动更新；远程 SSH 为主，本地终端暂不支持。

三步建立第一条 SSH 连接 ⚡

这是新手最重要的部分，跟着做只要 3 分钟：

第 1 步：打开 Hosts 页面启动后无需登录，左侧导航点击Hosts标签，默认就是你的 Personal（个人）库。

第 2 步：点击右上角「+ New Host」按钮，在表单中填写：

表单默认端口与用户名逻辑可参考源码 ConnectionForm.tsx。跳板机、环境变量、端口敲门、代理等高级选项默认折叠，第一次使用完全不用管。

第 3 步：保存并连接双击主机卡片即可打开终端。卡片左上角的绿色圆点是实时连通状态——探针连续失败 15 秒才会变红，短暂离线不用慌。

进阶一点：用 SSH 密钥代替密码（推荐）🔑

切换到左侧导航的Keychain标签，可以生成新密钥对（Ed25519/RSA）或导入现有私钥，然后回到连接表单直接选这把密钥；公钥支持一键复制，写入服务器的~/.ssh/authorized_keys即可。密钥与身份管理页面源码在 KeychainPage.tsx。

高效管理服务器：文件夹 + 标签 📁

服务器超过 5 台就该整理。Voltius 的主机列表支持：

• 文件夹：在 FOLDERS 区域新建，比如按项目或环境划分（Kubernetes / Databases / Homelab）
• 标签：每台主机可打多个标签（prod、web），点标签即可过滤
• 搜索框：顶部输入关键字即时筛选全部主机

主机管理相关源码位于 src/components/hosts/。

Ctrl+K 命令面板：秒级跳转到任意主机 🔍

按Ctrl+K（macOS 为⌘K）呼出命令面板：

• 模糊搜索所有主机、密钥、身份、代码片段、设置
• 顶部直接展示"当前活动连接"与"最近主机"
• 全程键盘操作，不用来回点鼠标

分屏终端：同时操作多台服务器 🖥️

批量运维场景下特别好用：

• 顶部标签栏打开多个终端，再把单个标签任意分屏成网格
• 广播输入：一次按键同时发送到所有面板，20 台机器执行同一条命令不再手抖
• 持续会话：默认借助远端 tmux/screen 保活，断网甚至重启应用后重连，现场还在；开启同步后还能在另一台设备上接着操作

SFTP 双栏文件传输：拖拽即可 📦

切到顶部SFTP标签，文件传输就变成"拖文件"这件事：

• 左栏是本地机器，右栏是远程主机（也支持主机↔主机互传）
• 直接拖拽上传/下载，底部 TRANSFERS 栏实时显示进度
• 支持目录浏览、过滤、权限查看与本地编辑器打开

从旧客户端一键迁移：不用重新录入 🔄

如果你从 Termius、MobaXterm、PuTTY/KiTTY、SecureCRT、ZOC Terminal 迁移过来，甚至手里只有 CSV 或~/.ssh/config，都不需要手动重录：

1. Hosts 页点击Import/Export → Import
2. 选择来源格式（Termius JSON、MobaXterm、PuTTY 注册表、SecureCRT、ZOC、CSV、OpenSSH 配置）
3. 预览清单后勾选要导入的主机与密钥，选择目标库即可

OpenSSH 导入还会跟随Include行与通配符解析。各格式解析器实现见 importers.ts，导入界面在 ImportTab.tsx。

团队共享：端到端加密同步与角色权限 👥（可选）

• 零知识同步：无论官方云、自建 Gist、Cloudflare 还是任意 S3 兼容存储，离开设备的数据全部是密文，服务商看不到内容
• 团队库：邀请成员、分配 Owner/Member 角色，支持按成员和按对象控制编辑权限
• 实时共享：付费套餐可把活着的终端共享给队友，多人操作同一会话

个性化与进阶玩法 🎨

• 主题编辑器：自定义窗口配色与完整 16 色终端调色板
• 插件：Docker 容器管理、Proxmox LXC、系统监控、进程管理器，从插件目录一键安装
• MCP 服务器：可让 Claude Code、Cursor 等 AI 工具直接驱动 Voltius 管理主机（默认关闭，Settings → Integrations 一键开启）

常见问题 FAQ ❓

需要注册账号吗？不需要。Voltius 是本地优先设计，装完即用；只有云同步、团队库等协作功能才需要账号。

密码和私钥安全吗？凭据存储在本地加密库中（Argon2id 派生密钥 + XChaCha20-Poly1305 加密），也可选择存入系统钥匙串（macOS Keychain / Windows Credential Manager / Linux Secret Service）。

免费版功能少吗？核心功能永久免费。付费套餐主要是团队席位、实时同步与终端共享额度。

会话断了工作会丢吗？默认不丢：远端 tmux/screen 持续保活，重连后终端现场原样恢复。

写在最后 ⚡

到这里，你已经完成了 Voltius 安装、建立第一条 SSH 连接、组织主机清单、分屏运维与文件传输的全套流程。建议把常用的服务器打标签、放进文件夹，并养成用Ctrl+K跳转的习惯，服务器再多也不会乱。

更多资料：

• 项目介绍与特性：README.md
• 版本更新记录：CHANGELOG.md
• 参与贡献指南：CONTRIBUTING.md