mmh

一个使用 Go 编写的简单多服务器登录管理小工具.

安装

可直接从 release 页下载预编译的二进制文件，然后执行 mmh install (需要root 权限，自动请求 sudo)即可； 卸载直接执行 mmh uninstall，卸载命令不会删除 ~/.mmh 配置目录。

默认安装到 /usr/bin 目录下，如果受权限限制无法安装，请使用 --dir 选项指定其他安装目录

基本命令

➜  ~ mmh --help

A simple Multi-server ssh tool.

Usage:
  mmh [flags]
  mmh [command]

Available Commands:
  cp          Copies files between hosts on a network
  ctx         Change current context
  exec        Batch exec command
  go          Login single server
  help        Help about any command
  install     Install mmh
  ping        Ping server
  server      Server command
  tun         SSH tunnel
  uninstall   Uninstall mmh
  version     Print version

Flags:
  -h, --help   help for mmh

Use "mmh [command] --help" for more information about a command.

部分命令被重命名为快捷命令方便操作(安装后自动软连接)

• mmh go ==> mgo
• mmh exec ==> mec
• mmh cp ==> mcp
• mmh server ==> mcs
• mmh ctx ==> mcx
• mmh ping ==> mping
• mmh tun ==> mtun

配置文件

从 v1.3.0 版本开始，支持多配置文件切换功能；安装完成后将会自动在 $HOME/.mmh 下创建样例配置，默认配置文件结构如下

➜  ~ tree .mmh
.mmh
├── default.yaml
└── main.yaml

main.yaml

主配置文件结构如下

basic: default
current: test
contexts:
- name: default
  config_path: /Users/mritd/MEGA/mmh/default.yaml
- name: test
  config_path: test.yaml

主配置文件中可以配置多个 context，由 current 字段指明当前使用哪个 context, basic 设置的 context 会作为 额外补充服务器加入 current 指明的 context 中；basic 适用于存放一些常规服务器，比如个人的 vps 等，以保证在任 何 context 都可以访问这些服务器。config_path 字段可以是绝对路径，也可以为相对路径，相对路径默认位置为 ~/.mmh 目录

default.yaml

这个是真正的 SSH 配置，一般情况下其与对应的 context 名称相同；该配置文件样例如下

basic:
  password: ""
  port: 22
  private_key: /Users/mritd/.ssh/id_rsa
  private_key_password: ""
  proxy: ""
  user: root
max_proxy: 5
servers:
- name: nginx
  address: 172.16.1.10
  tags: ["docker"]
- name: gitlab
  address: 172.16.1.101
  tags: ["docker"]
  port: 2222
- name: wiki
  address: 172.16.1.104
  tags: ["docker"]
tags:
- k8s
- docker

basic 段为默认配置，用于在 servers 段中某项配置不存在时进行填充；servers 段中可以配置 N 多个服务器(server)； 每个 server 除了常规的 SSH 相关配置外还增加了 proxy 字段用于支持无限跳板(具体见下文)；tag 字段必须存在于在下面的 tags 段中，该配置主要是为了给服务器打 tag 方便批量复制与执行；max_proxy 是一个数字，用于处理当出现配置错误导致 "真·无限跳板" 情况时自动断开链接；server_alive_interval 用于实现保持链接。

自动登录

可以使用 mgo SERVER_NAME 直接登录，如需交互式登录可执行 mmh 即可

无限跳板

在每个服务器配置中可以设置一个 proxy 字段，当登录带有 proxy 字段的服务器时，工具会首先链接代理节点进行跳转； 这种能力方便于在使用跳板机的情况下无感的直连跳板机之后的主机；并且其支持无限的跳板登录，如 A、B、C 三台机器， 如果 C 的 proxy 设置为 B，同时 B 的 proxy 设置为 A，那么实际在登录 C 时，工具实际连接顺序为: local->A->B->C

不要去尝试循环登录，比如 A->B->C->A 这种配置，工具内部已经做了检测防止产生这种 "真·无限跳板" 的情况， 默认最大跳板机数量被限制为 5 台，可通过在配置文件中增加 max_proxy 字段进行调整

管道式批量执行

在某些情况下可能需要对某些机器执行一些小命令，工具提供了 mec 命令用于批量执行命令:

➜  ~ mec --help

Batch exec command.

Usage:
  exec SERVER_TAG CMD [flags]

Aliases:
  exec, mec

Flags:
  -h, --help     help for exec
  -s, --single   single server

在配置文件中每个服务器可以配置多个 tag，mec 默认对给定的 tag 下所有机器执行命令，如需对单个机器执行请使用 -s 选项； 该命令目前支持管道处理和持续执行，比如批量执行 tail -f 命令等；除此之外还可以配合 grep 等命令进行自由发挥:

默认在批量执行模式下，每行输出前会加入当前服务器的名称前缀，在 v1.1.0 版本调整了颜色渲染代码，从而支持了前缀顺次颜色变换 (不会出现两个相邻服务器名字颜色一样的情况)；在单服务器下则每行输出不显示当前服务器前缀

批量复制

为了尽量方便使用，模仿了一下 scp 命令，增加了批量复制功能 mcp；批量复制支持 本地到远端多机器的文件/目录批量复制 和 单一远端机器到本地的文件/目录复制；当指定 -g 选项时，则会类似 mec 命令一样向目标 tag 的一组服务器发起复制

➜  ~ mcp --help

Copies files between hosts on a network.

Usage:
  cp [-r] FILE/DIR|SERVER_TAG:PATH SERVER_NAME:PATH|FILE/DIR [flags]

Aliases:
  cp, mcp

Flags:
  -r, --dir     useless flag
  -g, --group   multi-server copy
  -h, --help    help for cp

注意: 批量复制并不可靠，请谨慎使用；并非说代码不可靠，只是相对来说对于登录等功能，即使工具出问题，也很难造成灾难性后果； 但是复制功能是有能力造成文件覆盖的，从而造成灾难性后果；所以请谨慎使用，目前只针对常规情况作了大部分测试。

多环境切换

考虑到同时将多个环境的配置放在同一个配置文件中会有混乱，同时也可能出现误操作的情况，v1.3.0 版本增加了 context 的概念； 每个 context 被认为是一种环境，比如 prod、test、uat 等，每个环境的机器配置被分成了独立的文件以方便单独修改与加载； 控制使用哪个 context 可以使用 mcx set CONTEXT_NAME 命令

➜  ~ mcx --help

Change current context.

Usage:
  ctx [flags]
  ctx [command]

Aliases:
  ctx, mcx

Available Commands:
  help        Help about any command
  ls          List context
  set         Set context

Flags:
  -h, --help   help for ctx

Use "ctx [command] --help" for more information about a command.