ConfigSSH 应用图标
开源 · 原生 macOS · 本地优先 · 预览版

ConfigSSH

可视化管理 SSH 配置,选中主机一键连接。

直接读写你的 ~/.ssh/config,不另建主机数据库。改动先预览差异、写入前自动备份, 连接交给你常用的终端;不用它时,ssh、scp、VS Code Remote 照常工作。

macOS 14+ · Apple Silicon · MIT 开源

ConfigSSH 全部主机页面:左侧功能导航,中部按 Engineering 和 Personal 分组并高亮 api 主机,右侧是该主机的连接参数和部署公钥入口

全部主机(示例数据):按分组浏览,右侧直接看到连接参数和配置原文。

配置还是你的,只是更好管理

很多 SSH 客户端要把主机导入自己的数据库,之后在两套配置间来回同步。ConfigSSH 不这样做。

定位原生 macOS SSH 配置管理器,直接读写 ~/.ssh/config 和它 Include 的文件
改动每次保存前展示逐行差异,写入前自动备份,随时可以恢复
连接应用只把请求交给你的终端,登录仍由系统 OpenSSH 完成;不保存 SSH 密码
兼容不用 ConfigSSH 时,ssh、scp、VS Code Remote 等工具照常使用同一份配置
技术Swift / SwiftUI 原生应用,macOS 14 Sonoma 及以上,Apple Silicon,MIT 开源

管理、编辑、连接,一个窗口搞定

主机管理

按分组浏览,支持搜索、收藏和折叠;可以创建空分组,也能在分组旁直接新增主机。

安全编辑

用表单改 HostName、User、Port、IdentityFile、ProxyJump 等常用字段,或直接编辑 config 原文。保存前预览差异,写入前备份。

快速连接

双击主机即连。在任何应用里按全局快捷键 ⌥⌘K,或点菜单栏图标,搜索主机后直接打开终端。

用你的终端

自动识别 Terminal、Ghostty、Otty,其他终端可手动配置;可按主机选择新窗口或新标签页。

密钥管理与部署公钥

索引公钥并显示被哪些主机引用,可生成 Ed25519 / RSA 密钥。输入一次密码,向导就把公钥装到服务器并改用密钥登录。

快照与恢复

每次修改自动备份;默认每天为配置创建本机快照(可改每周或关闭),也能手动创建,预览差异后恢复。

iCloud 加密同步

把配置加密后推送到 iCloud Drive,在另一台 Mac 预览差异后拉取。口令不上传,不同步私钥。

冲突不覆盖

写入前再次核对文件版本;若期间被别的程序改动,应用保留对方的版本并提示冲突。

免费开源

以 MIT 协议开源,Swift 编写,源码、测试和发布流程都在 GitHub 上。

三步用起来

打开应用

启动后读取 ~/.ssh/config 及其 Include 文件,按来源目录自动分组。这一步只读取,不写入。

新增或编辑主机

填写别名、地址、用户名和端口,保存前先看差异,确认后才写入并备份。

一键连接

双击主机,或按 ⌥⌘K 搜索,应用用你的终端打开 ssh <别名>。

随时搜索,直接连接

不必切到 ConfigSSH 主窗口。全局快捷键和菜单栏图标都能搜索主机并打开终端,焦点只在你选定主机之后才离开当前应用。

全局快捷键呼出的搜索框:输入 eng 后只列出 Engineering 分组的主机,底部写明将用 Ghostty 新窗口连接
全局快捷键 ⌥⌘K:输入关键词筛选主机
菜单栏图标的下拉面板:未输入时按最近连接列出主机,显示地址、分组标签和默认终端
菜单栏图标:点击后在下拉面板中搜索
快捷键作用
⌥⌘K在任何应用中呼出主机搜索框(可在设置里改成别的组合,或关闭)
⌘K在主窗口中打开快速连接面板
↑ ↓ ↩在搜索框中选择主机并连接;未输入时按最近连接排序
⌘↩用新标签页打开选中的主机
⌘N新增主机
⌘R重新载入配置

搜索框支持别名、地址、用户名、显示名称、分组或标签的任意部分,多个关键词用空格分隔。全局快捷键只在 ConfigSSH 运行时有效,建议同时开启“登录时启动”。

配置文件如何保存

分组就是子目录,每台新主机是一个独立文件;已有的配置不迁移,照常读取和显示。

目录结构

~/.ssh/
├── config              ← 全局参数与 Include 入口
└── config.d/
    ├── api.conf        ← 未分组主机,一台一个文件
    └── Work/           ← 分组 = 子目录
        └── staging.conf

几个约定

  • config 只做入口:第一次新增主机时,应用在 Host 规则之前加入 Include config.d/*.conf 等两行,并在预览中展示。
  • 已有的 Host 块照常读取和显示,应用不会把它们搬走。
  • 删除分组前先预览,组内主机移到“未分组”;遇到同名文件或无法识别的内容就停止,不覆盖任何文件。
全局配置页面:预览主 config 原文,显示主机、规则和已读取文件数量,并提供编辑入口
全局配置:查看主 config 原文,逐个查看 Include 文件
密钥页面:选中示例 Ed25519 公钥,右侧显示类型、指纹、文件路径、私钥存在状态和关联主机
密钥:查看指纹、引用关系,以及私钥是否存在

安全与隐私

它碰的是你的 SSH 配置,所以每一步都留了余地。

会做的

  • 写入前展示逐行差异,并保存备份(默认保留最近 50 条,可调整)。
  • 写入前再次核对文件版本,被别的程序改动时保留对方版本并提示冲突。
  • 原子方式替换文件,拒绝写入符号链接或 ~/.ssh 之外的路径。
  • 索引密钥时只读取 .pub 公钥文件。

不会做的

  • 不保存 SSH 密码,日常使用不会把私钥内容读进应用。
  • 不会自动运行 ssh -G,因为 Match exec 可能执行本机命令。
  • 不会用简化表单改写无法安全定位的复杂配置,这类主机保持只读。
  • 不会把私钥上传到 iCloud。

本机快照不额外加密:手动快照默认只含配置文件。若要在快照中包含私钥,必须单次确认并逐个勾选;能访问快照文件的人可能拿到私钥,建议先为私钥设置口令。

iCloud 加密同步

在多台 Mac 之间共享同一份 SSH 配置,需要时才开。

本机加密

内容在本机用 AES-GCM 加密,密钥由你设定的共享口令派生(至少 12 个字符)。口令不会上传。

每台 Mac 一个文件

每台设备在 iCloud Drive 中有独立的 Devices/<设备ID>.cssh,彼此不会覆盖。

先预览再拉取

推送和拉取都先看文件数量与逐文件差异;拉取只覆盖同路径的文件,并先备份。只同步 config 和 config.d/ 下的 .conf。

注意:应用只能确认文件已写入本机的 iCloud Drive 目录,无法确认已上传到云端,请在 Finder 中查看同步状态。口令丢失后,云端配置无法解密。不同 Mac 的绝对路径和 IdentityFile 位置可能不同,拉取后请检查。

下载与安装

需要 macOS 14 Sonoma 或更新版本、Apple Silicon(arm64)。连接时使用系统自带的 OpenSSH。

预览版:预发布包没有签名,也没有公证,只适合个人预览,请不要再分发给他人。第一次打开时 macOS 会提示无法验证开发者。

下载预发布包 推荐

在 Releases 页面下载 ConfigSSH-vX.Y.Z-unsigned-macos-arm64.zip 和 SHA256SUMS.txt,放在同一目录后校验:

shasum -a 256 -c SHA256SUMS.txt

解压后把 ConfigSSH.app 拖入“应用程序”。第一次打开时,到“系统设置 › 隐私与安全性”,在页面下方点击“仍要打开”。

前往 Releases

从源码构建

需要 Swift 6 工具链。直接运行,或打包成可放进“应用程序”的 .app:

git clone https://github.com/AlexWuYh/ConfigSSH.git
cd ConfigSSH
swift run ConfigSSH

# 打包成 .app
./scripts/package-macos.sh
open dist/ConfigSSH.app
查看源码
终端权限第一次用 Terminal 或 Ghostty 启动时,macOS 会请求“自动化”权限,请选择允许
连接没反应检查“系统设置 › 隐私与安全性 › 自动化”,并在应用“设置 › 终端”里查看该终端的检测状态;自定义终端要用 CLI 的绝对路径,参数里包含 {alias} 或 {ssh}
改错了“设置 › 配置与备份”里找到对应变更记录选择恢复,恢复前同样展示差异
已知限制全文编辑的静态检查不能保证所有 OpenSSH 参数在当前系统上有效;目前只提供 Apple Silicon 版本

把 SSH 配置管得清清楚楚

免费、开源,配置始终在你自己的 Mac 上。