如何快速安装OmnySSH:macOS、Linux、Windows三大平台一键部署完整指南
如何快速安装OmnySSH:macOS、Linux、Windows三大平台一键部署完整指南
OmnySSH 安装只需一条命令即可完成。OmnySSH 是一款用 Rust 编写的开源 SSH 客户端与服务器管理工具,提供 macOS、Windows、Linux 三大平台的桌面 GUI 和终端 TUI 两种形态,内置实时指标仪表盘、标签页终端、SFTP 文件管理、端口转发、一键 SSH 密钥配置和命令片段广播功能。无论你是新手还是资深运维,都能在这篇指南中找到对应平台的最快安装路径。
安装前:先了解 OmnySSH 长什么样
安装完成后的 OmnySSH 主界面如下:左侧是导航栏(Dashboard、Snippets、SFTP、Terminal),右侧是每台服务器的实时卡片,显示 CPU、RAM、磁盘占用、运行时长、发行版和 Top 进程,点击 sh 即可进入终端,点击 files 即可打开双栏 SFTP 浏览器。
值得强调的是:OmnySSH 无需注册账号、无登录界面、无遥测,启动即读你本地的 ~/.ssh/config(包括 ProxyJump 跳板机配置),开箱即用。
两种形态怎么选:GUI 桌面版 vs TUI 终端版
| 维度 | GUI 桌面版 | TUI 终端版(omny) |
|---|---|---|
| 界面 | 图形窗口,鼠标操作 | 终端内交互 |
| 适用人群 | 新手、日常主力使用 | 服务器运维、极简党 |
| 体积 | 下载约 20 MB | 单文件二进制 |
| 平台 | macOS / Linux x86_64 / Windows | 全平台(含 Termux) |
两个前端共用同一个 Rust 核心引擎(crates/omnyssh-core/),功能完全一致,可以同时安装互不冲突。
一键安装命令:三大平台通用
官方提供了一条跨平台安装脚本 install.sh,它会自动检测你的操作系统与架构(x86_64 / aarch64),下载对应版本、校验 SHA256 后完成安装:
curl -fsSL https://raw.githubusercontent.com/timhartmann7/omnyssh/main/install.sh | sh
想装终端版或两个都装,加一个参数即可:
sh -s -- --tui仅安装终端版omnysh -s -- --bothGUI + TUI 全装- 交互模式下回车默认安装 GUI 桌面版
脚本安装逻辑可完整溯源:install.sh(含平台探测、校验、PATH 提示),文档页 doc/omny.1。
macOS 安装步骤
方式一:一条命令(推荐)
直接执行上面的一键命令,脚本会自动挂载 DMG 并把应用装进 /Applications,无需任何手动操作。
方式二:手动安装
- 在发布页下载
OmnySSH-aarch64-apple-darwin.dmg(Apple Silicon)或OmnySSH-x86_64-apple-darwin.dmg(Intel) - 双击 DMG,把 OmnySSH 拖入 Applications
- 首次打开若提示无法验证开发者,前往 系统设置 → 隐私与安全性 点击"仍要打开"
💡 手动从发布页下载的
.dmg若提示"已损坏",用install.sh方式重装即可彻底解决(1.1.4 版本已修复签名覆盖问题,详见 CHANGELOG.md)。
终端版可选安装渠道:
cargo install omnyssh # cargo
brew install timhartmann7/tap/omnyssh # Homebrew
安装后运行 omny 即进入终端版。
Linux 安装步骤
install.sh 会按发行版自动择优:RPM 系(dnf)优先装 .rpm,Debian/Ubuntu 系优先装 .deb,都不行时回退到免依赖的 AppImage。
手动安装对应关系:
| 文件 | 适用环境 |
|---|---|
OmnySSH-x86_64.rpm |
Fedora、RHEL 系 |
OmnySSH-x86_64.deb |
Ubuntu、Debian 系 |
OmnySSH-x86_64.AppImage |
任意发行版(需 FUSE) |
AppImage 注意事项:
chmod +x OmnySSH-x86_64.AppImage # 赋予执行权限
./OmnySSH-x86_64.AppImage # 若启动报错,先装 libfuse2
# 或免 FUSE 运行:
./OmnySSH-x86_64.AppImage --appimage-extract-and-run
卸载原生包只需 apt remove omny-ssh 或 dnf remove omny-ssh。
⚠️ ARM64(aarch64)Linux 没有桌面版构建,脚本会自动改装终端版
omny,功能不受影响。
Windows 安装步骤
GUI 桌面版:
- 下载
OmnySSH-x86_64-setup.exe - 双击运行安装向导,一路确认
- 开始菜单出现 OmnySSH,右键即可"固定到任务栏"
终端版: 在 Git Bash / MSYS2 中执行一键命令(加 --tui),或手动下载发布页的 omny-* 预编译文件解压到任意目录;若提示不在 PATH 中,把安装目录加入系统环境变量即可。
终端版 TUI 首次使用
安装完成后运行 omny,你会看到这样的实时仪表盘:
常用操作:按 a 添加主机、/ 模糊搜索、? 查看帮助、Shift+K 对选中主机一键配置密钥。完整参数、键位映射与主题配置(default、dracula、nord、gruvbox)执行 man omny 查看。
配置文件位置:
| 平台 | 配置目录 |
|---|---|
| Linux | ~/.config/omnyssh/ |
| macOS | ~/Library/Application Support/omnyssh/ |
| Windows | %APPDATA%\omnyssh\ |
你的 ~/.ssh/config 只在启动时被读取,永远不会被写入或修改。
安装后常见问题排查
- 提示
omny: command not found:把安装目录加入 PATH。bash 用户执行echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc - Linux 窗口打开是空的黑框:部分显卡驱动下 WebKit 硬件渲染失败,应用会自动重启一次并切换到软件渲染(1.1.2 起内置自恢复)
- macOS 提示"已损坏":改用
install.sh安装,或到 系统设置 → 隐私与安全性 中放行 - AppImage 启动报 FUSE 错误:
sudo apt install libfuse2或用--appimage-extract-and-run运行
总结
| 平台 | 最快路径 |
|---|---|
| macOS | 一键命令 或 DMG 拖入 Applications |
| Linux | 一键命令自动选择 .rpm / .deb / AppImage |
| Windows | 下载 .exe 安装器双击 |
全程无需账号、不收集遥测、不改动你的 ~/.ssh/config,一分钟即可完成部署。装好后建议优先体验两个杀手级功能:实时指标仪表盘(哪台机器异常一眼可见)和一键 SSH 密钥配置(生成 Ed25519 密钥、写入 authorized_keys、验证成功后自动关闭密码登录,源码可审计:crates/omnyssh-core/src/ssh/key_setup.rs)。

