SSH Pilot：面向 Linux 与 macOS 的跨平台 SSH/SFTP 连接管理器
SSH Pilot 是一款基于 GTK4/libadwaita 的用户友好型 SSH 与 SFTP 客户端，支持直接复用现有 ~/.ssh/config，内置带标签页和分屏的终端、双窗格 SFTP 文件管理器、SCP 上传下载、ssh-copy-id 密钥传输、known_hosts 与授权密钥管理、图形化 Docker 容器管理、多种安全存储后端、Bitwarden/Vaultwarden 备份恢复、命令片段与插件扩展，采用 GPL-3.0 许可证。
社区作者 · zZz
它解决什么问题
SSH Pilot 是一个面向 Linux 和 macOS 的用户友好型 SSH 与 SFTP 客户端，将侧边栏、终端和 SFTP 面板整合在同一个窗口中（配图 1）。
主要功能：
- 直接使用现有的 ~/.ssh/config 配置；
- 集成终端，支持标签页界面与分屏视图（也兼容你常用的终端应用）；
- 直观、极简的界面，支持键盘导航和自定义快捷键；
- 内置 SFTP 双窗格文件管理器（配图 2）；
- 支持 SCP 下载/上传；
- 支持向服务器传输密钥（ssh-copy-id，配图 4）；
- known hosts 与 Authorized keys 管理（本地和远程）；
- 图形化 Docker 容器管理器；
- 支持多种安全存储后端（libsecret、Keepass、Bitwarden/Vaultwarden、pass）；
- 支持向 Bitwarden/Vaultwarden 或自有服务器备份与恢复（涵盖应用设置、密钥与凭据）；
- 提供 Snippets 片段，用于快速执行脚本/命令；
- 可通过插件扩展。
终端支持分屏多终端视图（配图 3）。
文档入口：用户指南与 FAQ 见 https://github.com/mfat/sshpilot/wiki ；架构参考见 docs/architecture.md；诊断与日志见 docs/diagnostics.md；仓库内开发者与平台文档见 docs/ 目录；编码智能体配置见 SSH Pilot MCP quickstart；编写插件（协议与 UI 页面）见 docs/plugins/。
第三方库：pyxtermjs —— 浏览器中功能完整的终端，作为备选终端后端使用（MIT 许可证）。
许可证：SSH Pilot 采用 GNU General Public License v3.0 授权。
其他信息：Telegram 频道 https://t.me/sshpilot ；图标由 Blisterexe 设计。
— 本文由 AI 根据公开来源辅助整理，命令、版本与许可证请在使用前到原始页面复核。
安装 / 开始使用
【准备环境】 SSH Pilot 官方推荐通过下列软件源安装以获得自动更新；也可直接从 Releases 章节下载。最低系统版本要求：Debian 13（trixie）、Ubuntu 24.04（noble）、Linux Mint 22、Fedora 43、RHEL / CentOS Stream 10、Arch Linux（rolling）、macOS 14（Sonoma）。其他 Linux 发行版请安装 Flatpak，它能在所有支持 Flatpak 的平台上运行。
依赖库最低版本
Python 3.12、GTK 4 4.6、libadwaita 1.5、VTE (GTK4) 0.70、PyGObject 3.42、pycairo 1.20.0、cryptography 42.0、keyring 24.3、psutil 5.9.0、pykeepass 4.0、certifi 2023.7.22、GtkSourceView 5.0。【方式一：Ubuntu PPA】（配图 5 Ubuntu 图标）
sudo add-apt-repository ppa:mfat/sshpilot
sudo apt update
sudo apt install sshpilot
- 添加 PPA：
- 更新索引：
- 安装：
【方式二：Debian APT 仓库】（配图 6 Debian 图标）
- 添加 GPG 密钥：
curl -fsSL https://mfat.github.io/sshpilot-ppa/pubkey.gpg | sudo gpg --dearmor -o /usr/share/keyrings/sshpilot-ppa.gpgecho " deb [signed-by=/usr/share/keyrings/sshpilot-ppa.gpg] https://mfat.github.io/sshpilot-ppa any main " | sudo tee /etc/apt/sources.list.d/sshpilot-ppa.list
sudo apt update sudo apt install sshpilot 更多信息见：https://mfat.github.io/sshpilot-ppa/
- 添加软件源：
- 更新并安装：
【方式三：Fedora/RHEL COPR 仓库】（配图 7 Fedora 图标） 该仓库为基于 RPM 的发行版提供自动更新。
- 启用 COPR：
dnf copr enable mahdif62/sshpilot- 安装：
dnf install sshpilot【方式四：Flatpak】 已在 Flathub 上架，或在终端执行： flatpak install flathub io.github.mfat.sshpilot
【方式五：Arch Linux】（配图 8 Arch Linux 图标） AUR 包地址：https://aur.archlinux.org/packages/sshpilot
将 yay 替换为你使用的 AUR 助手，例如 paru
yay -S sshpilot 或使用社区维护的 Nightly 包：https://aur.archlinux.org/packages/sshpilot-git
将 yay 替换为你使用的 AUR 助手，例如 paru
yay -S sshpilot-git
【方式六：Homebrew（macOS + Linux）】（配图 9 Homebrew 图标）
- 添加 tap：
brew tap mfat/sshpilot- 安装：
brew install sshpilot更多信息见：https://github.com/mfat/homebrew-sshpilot 说明：该 formula 为源码构建（build-from-source），首次安装会拉取 GTK4 技术栈并编译一个带运行时依赖的 Python 虚拟环境。安装完成后，请在活跃的桌面会话中从终端启动 sshPilot（Linux 需 Wayland/X11 + dbus；macOS 为原生运行）。
【方式七：macOS 安装包（aarch64 与 x86-64）】（配图 10 Apple 图标） 从 Releases 章节下载 dmg 文件：https://github.com/mfat/sshpilot/releases/ 在 macOS 上做开发时，先安装依赖：
brew install gtk4 libadwaita pygobject3 py3cairo vte3 gobject-introspection adwaita-icon-theme pkg-config glib graphene icu4c sshpass gtksourceview5注意：webkitgtk 仅限 Linux，macOS 上无法通过 Homebrew 获取；因此 PyXterm.js 后端在 macOS 上不可用，应用会改用 VTE 后端。
【方式八：从源码运行】 参见 docs/running-from-source.md。
【首次运行】 启动后 SSH Pilot 会读取你现有的 ~/.ssh/config，已配置的主机可直接使用；可通过侧边栏、终端、SFTP 面板组成的单窗口界面（配图 1）连接，需要时在双窗格 SFTP 文件管理器（配图 2）中传文件，或使用 split view 打开多个终端（配图 3），也可通过 ssh-copy-id 对话框把本机公钥复制到服务器（配图 4）。
【常见问题】
- macOS 上缺失 PyXterm.js 终端后端：属预期行为，因 webkitgtk 仅支持 Linux，应用会回退到 VTE 后端。
- 不在最低版本列表中的 Linux 发行版：请改用 Flatpak 安装。
- 安装后无法启动：Linux 需在活跃桌面会话（Wayland/X11 且 dbus 可用）中从终端启动；macOS 为原生启动。
- 用户指南与 FAQ：https://github.com/mfat/sshpilot/wiki ；诊断与日志：docs/diagnostics.md 。
