STACIO WIKI · 用户指南

Stacio 使用指南

适用版本：Stacio 0.14.x
更新日期：2026-07-25
面向读者：第一次使用 Stacio，或需要快速熟悉工作台的 macOS 用户

1. Stacio 能做什么

Stacio 把常见远程工作集中在一个原生 macOS 工作台中：

保存、分组和搜索 SSH、SFTP、FTP、SCP、Telnet、VNC、串口及本地终端会话；
在标签页或分屏中使用本地和远程终端；
浏览、搜索、上传、下载、编辑和备份远端文件；
管理 Local、Remote 和 Dynamic SSH 隧道；
查看 Linux 主机的 CPU、内存、网络和磁盘指标；
使用 MultiExec、宏、AI 助手和本地 Agent 组织重复工作；
在本地保留必要的会话、传输、诊断和审计信息。

部分高级入口受 License 控制。无有效授权时，相关按钮或菜单会保持灰色并显示升级提示。

2. 系统要求与安装

2.1 系统要求

macOS 14 或更高版本；
可以到达目标主机的网络；
已知目标 IP 或域名，以及非默认服务端口；
目标协议对应的账号和凭据；
使用串口时，需要 macOS 能识别相应设备路径；
使用 VNC 或其他图形能力时，需要当前安装包包含相应适配器。

2.2 安装建议

从 Stacio 官方发布页获取对应 Mac 架构的安装包。
打开 DMG，并按安装包界面把 Stacio 放入“应用程序”。
从“应用程序”启动 Stacio，确认“关于 Stacio”中的版本与下载版本一致。
macOS 若提示来源或签名异常，不要绕过系统安全策略；先确认安装包来源、文件是否完整以及是否下载了正确架构。

官方发布页：https://github.com/Fengoffer/Stacio/releases

3. 认识工作台

3.1 左侧会话列表

左侧用于管理保存的会话和分组：

搜索框可按会话名称、主机或标签过滤；
“最近使用”最多显示最近打开的 5 个会话，可在设置中关闭；
标签为 favorite、favorites 或“收藏”的会话会进入“收藏”分组；
会话和分组支持拖放排序与移动；
右键会话可执行连接为、Ping、编辑、复制、移动、导出、重命名或删除等操作。

删除会话会移除保存配置和该会话的本地编辑缓存，但不会自动删除本地凭据库中的凭据。

3.2 中央工作区

中央区域承载终端、文件、浏览器和图形会话：

每个连接通常以标签页打开；
标签页支持重命名、着色、复制、固定、分离、全屏和批量关闭；
终端可切换单终端、垂直分屏、水平分屏和网格分屏；
当前标签决定右侧 Files、看板、AI 和历史命令使用的上下文。

3.3 工具栏与“面板”菜单

常用入口包括：

新建会话：创建并保存连接；
导入会话：从其他终端工具导入配置；
多执行：选择多个终端并同步输入；
分屏：选择终端布局；
文件、浏览器、隧道、设备看板、AI：打开相应能力；
面板：集中打开文件、浏览器、隧道、诊断、宏、历史命令、看板或 AI；
检查器：显示或隐藏右侧面板。

3.4 右侧检查器

检查器可显示：

文件与传输队列；
SSH 隧道；
内置浏览器；
诊断、导入报告、审计和应用日志；
设备看板；
宏和历史命令；
AI 助手。

4. 完成第一个 SSH 连接

4.1 使用快速连接

点击工具栏快速连接，或在开始页输入连接目标。

输入以下任一格式：

192.168.1.20
192.168.1.20:2222
root@192.168.1.20
deploy@192.168.1.20:2222
server.example.com
deploy@server.example.com
deploy@server.example.com:2222
ssh://deploy@192.168.1.20:2222

确认用户名、认证方式和凭据。
如需保存，勾选连接成功后保存为会话并填写会话名称。
点击连接。
首次连接时核对主机、端口、算法和 SHA-256 指纹，再决定是否信任。

多数情况下可直接使用服务器 IPv4 地址。仅输入 IP 或域名时，Stacio 默认使用 SSH 端口 22 和当前 macOS 用户名；追加 :2222 可指定自定义端口，前置 deploy@可指定用户。

快速连接把目标写在一个输入框中，而保存会话使用独立字段。例如 deploy@192.168.1.20:2222 保存后应拆成：

字段	值
主机	`192.168.1.20`
端口	`2222`
用户	`deploy`

不要把完整的 deploy@192.168.1.20:2222 粘贴到保存会话的主机字段。

4.2 创建保存会话

选择文件 > 新建会话，快捷键为 Command+Shift+N。
选择 SSH（安全 Shell）。
填写名称、主机、端口和用户。主机只填 192.168.1.20 或 server.example.com，端口单独填写。
选择认证方式：
- 密码：填写密码并保存到 Stacio 本地凭据库；
- 私钥：选择私钥路径，私钥有口令时一并保存；
- SSH 代理：由可用的 SSH agent 提供认证。
按需填写标签、环境、AI 执行策略、连接超时和跳板机。
点击保存，再从左侧双击会话打开。

连接成功后，终端顶部会显示连接摘要。若会话配置了“启动命令”或“环境变量”，当前版本会把它们显示为 Startup plan，但不会自动执行；只有“连接脚本”会在 SSH 终端就绪后自动写入并执行。详情见自动化。

5. 终端日常操作

5.1 新建与关闭

文件 > 新建本地终端或 Command+N：打开本机 Shell；
文件 > 关闭当前终端或 Command+W：关闭当前标签；
若设置中启用了“关闭终端前确认”，关闭前会再次询问；
应用退出时如有运行中的 SSH 隧道，会提示退出将停止隧道。

5.2 查找、复制和粘贴

终端 > 查找或 Command+F：搜索当前终端输出；
Command+C、Command+V：复制或粘贴；
可在设置中启用“选中自动复制”；
建议启用“多行粘贴前确认”，避免把整段脚本直接提交到远端 Shell。

5.3 分屏

打开一个或多个终端标签。
选择工具栏分屏或终端 > 分屏布局。
选择单终端、垂直、水平或网格布局。
点击目标 pane，使 Files、看板、AI 和历史命令绑定到正确终端。

分屏只是布局；它不会自动把输入发送到所有 pane。需要同步输入时使用 MultiExec，并在发送前检查目标列表。

5.4 输出与显示设置

在Stacio > 设置 > 终端中可配置：

字体、主题、光标、命令高亮和硬件加速；
滚动缓冲行数、行号、时间戳和毫秒显示；
SSH 保活间隔；
右键行为、Option/Meta、macOS 输入法兼容；
命令联想、历史候选和 Tab 接受候选；
长命令完成通知；
多行粘贴保护和图片粘贴为路径。

6. 打开文件、看板、隧道和 AI

6.1 Files

选中一个已连接的 SSH 终端，或打开 SFTP/FTP/SCP 会话。
选择视图 > 文件或工具栏文件。
使用面包屑、返回上一级、刷新、搜索和隐藏文件开关浏览目录。
上传、下载和编辑操作会在传输队列中显示状态。

完整说明见文件。

6.2 设备看板

选中已连接的 SSH 标签。
选择视图 > 显示/隐藏设备看板。
查看系统信息、CPU、内存、网络和磁盘。
在设置 > 看板调整刷新间隔、模块、历史长度和告警阈值。

设备看板依赖远端 Linux 探针。目标系统缺少 /proc 或兼容的 df 输出时，部分指标可能不可用。

6.3 隧道

选择视图 > 隧道，创建并绑定 SSH/SFTP/SCP 会话端点。建议默认监听 127.0.0.1。完整说明见隧道。

6.4 AI 助手

在设置 > AI 与执行配置模型供应商、Base URL、模型和 API Key。
选择当前终端，再打开视图 > AI 助手。
选择规则建议或模型推理，输入排查问题。
检查命令卡片的目标、风险和内容后再执行。

AI API Key 写入 Stacio 本地凭据库。AI 是否附带最近终端输出取决于“终端上下文”设置。

7. 会话管理

7.1 分组与搜索

使用侧栏新增分组，可建立子分组；
拖动会话或分组调整位置；
右键分组可重命名、删除或导出；
删除非空分组时，可选择同时删除会话，或只删除分组并把会话移到根目录。

7.2 导入与导出

文件 > 导入会话支持 Stacio、Xshell、MobaXterm、WindTerm、SecureCRT、FinalShell、Termius、Electerm、通用 JSON 和堡垒机来源。导入前会显示预览和冲突状态。

普通导出不应被视为凭据备份。迁移含凭据的单个会话时，应使用应用提供的加密会话迁移流程，并单独保管迁移口令。

7.3 右键快捷操作

会话右键菜单可包含：

连接为...：临时更换用户名，不修改保存会话；
Ping 主机：持续显示系统 Ping 输出，可手动停止；
复制会话、移动会话、重命名会话；
导出会话、创建桌面快捷方式、保存为默认预设、复制会话设置；
编辑会话和删除会话。

批量或分组导出可能受 License 控制。

8. 设置与本地数据

Stacio > 设置主要包含：

分类	用途
终端	显示、输入、缓冲、通知、保活和会话侧栏。
终端主题	系统、浅色、深色及导入主题。
AI 与执行	模型、上下文、命令确认、允许/拒绝模式和 Agent Bridge。
文件	目录跟随、隐藏文件、Remote Edit 检测、冲突策略、队列和缓存。
看板	采集间隔、模块、兼容过滤、历史长度和告警。
更新	Stable/Beta 通道和手动检查更新。
安全	审批、凭据中心、审计导出范围和本地存储路径。

Stacio 的会话数据库、应用日志、凭据库和编辑缓存都保存在当前 macOS 用户的应用支持目录中。可在设置 > 安全 > 本地存储复制具体路径。

9. License 与离线使用

在帮助 > License查看授权状态、版本、到期和宽限信息；
支持在线激活，以及导出设备申请、导入签名离线授权文件；
已验证并持久化的有效授权可在离线状态继续使用，具体以状态和到期时间为准；
License 只决定 Stacio 功能入口，不授予远端服务器权限；
授权不可用时，受限入口保持灰色，不应通过修改本地数据库或配置绕过。

10. 常见问题

现象	先检查什么
SSH 连接超时	IP 或域名是否正确、端口是否单独填写、VPN/代理、网络路由、连接超时设置和远端 SSH 服务。
SSH 认证失败	用户名、认证方式、凭据引用、私钥路径和私钥口令。
主机密钥已变更	不要直接放行；向管理员核对主机重装、密钥轮换或 DNS/跳板变更。
Files 显示“没有可用的 SSH 文件上下文”	先选中已连接 SSH 终端，或直接打开 SFTP/FTP/SCP 会话。
设备看板采集失败	目标是否为兼容 Linux、`/proc` 是否可读、`df` 是否可用、SSH 会话是否仍连接。
隧道无法启动	License、SSH 端点、本地端口占用、监听地址和目标端口。
AI 无法执行命令	模型配置、当前终端、全局审批、会话 AI 策略、生产环境强制确认和 License。
功能按钮灰色	将鼠标停在入口上查看提示，并在`帮助 > License`确认授权。

问题仍无法定位时，打开视图 > 诊断，收集已脱敏的错误、应用日志和时间点，再按远程运维中的升级材料清单提交。