如何快速安装OmnySSH:macOS、Linux、Windows三大平台一键部署完整指南

原创2026-10-13 18:26:161,993 阅读

如何快速安装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 桌面GUI仪表盘:实时显示多台服务器的CPU、内存与磁盘指标

值得强调的是: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 仅安装终端版 omny
  • sh -s -- --both GUI + TUI 全装
  • 交互模式下回车默认安装 GUI 桌面版

脚本安装逻辑可完整溯源:install.sh(含平台探测、校验、PATH 提示),文档页 doc/omny.1。

macOS 安装步骤

方式一:一条命令(推荐)

直接执行上面的一键命令,脚本会自动挂载 DMG 并把应用装进 /Applications,无需任何手动操作。

方式二:手动安装

  1. 在发布页下载 OmnySSH-aarch64-apple-darwin.dmg(Apple Silicon)或 OmnySSH-x86_64-apple-darwin.dmg(Intel)
  2. 双击 DMG,把 OmnySSH 拖入 Applications
  3. 首次打开若提示无法验证开发者,前往 系统设置 → 隐私与安全性 点击"仍要打开"

💡 手动从发布页下载的 .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 桌面版:

  1. 下载 OmnySSH-x86_64-setup.exe
  2. 双击运行安装向导,一路确认
  3. 开始菜单出现 OmnySSH,右键即可"固定到任务栏"

终端版: 在 Git Bash / MSYS2 中执行一键命令(加 --tui),或手动下载发布页的 omny-* 预编译文件解压到任意目录;若提示不在 PATH 中,把安装目录加入系统环境变量即可。

终端版 TUI 首次使用

安装完成后运行 omny,你会看到这样的实时仪表盘:

OmnySSH 终端TUI版演示:在终端内管理多台服务器的仪表盘界面

常用操作:按 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)。

登录后查看全文
omnyssh