ssh config

SSH 配置

由於組織中不再有活躍的維護者，因此該項目已設定為唯讀。

用於協助自動維護 SSH 用戶端配置的工具。它可用於維護遠端主機登入的資料庫。

SSH-Config 能夠使用 DNS 服務探測（新）主機並將主機新增至 SSH 設定。除此之外，它可以連接到 SSH 伺服器並找出哪些伺服器可以訪問，哪些伺服器不能訪問。

目的

SSH-Config 的目的是簡化包含許多主機的 SSH 用戶端設定的維護。如果您有維護良好的 SSH 用戶端配置，則 Unix shell 完成機制可協助在鍵入時擴充主機名稱。這就是該工具的用武之地。

用法

在命令列中使用它。實作了多個用例：

• 發現 (-d)：使用 DNS 尋找發現命令列中給予的新主機。
• 更新 (-u)：使用 DNS 和測試的主機可達性更新資料庫中的已知主機。
• 匯出（-e）：將資料庫匯出到文件/stdout。支援按使用者名稱或群組名稱過濾。
• 匯入 (-i)：從檔案/stdin 匯入資料庫。

完整的命令列參數：

 -database (-D) FILE : The database to use. (default: /home/$USER/.sshconfig.json
                       )
 -discover (-d)      : Discover hosts given in the command line using DNS.
                       (default: false)
 -export (-e)        : Export the database. Writes to stdout or file argument.
                       User and group parameters can be used for filtering.
                       (default: false)
 -group (-G) GROUP   : The group name to use for the entry for discovery or
                       export filtering.
 -help (-h)          : Show this command line help. (default: true)
 -import (-i)        : Import a database. Reads either from argument or stdin.
                       (default: false)
 -sshcfg (-s) FILE   : The ssh config to update. (default:
                       /home/$USER/.ssh/config)
 -update (-u)        : Update all database hosts IP addresses. (default: false)
 -user (-U) USER     : The user name to use for the entry for discovery or
                       export filtering.

用例 1：將新主機新增至$HOME/.ssh/config

若要將新主機新增至 ssh 配置中，您通常會發出下列命令：

 $ ssh-config -d vm-alpha vm-beta vm-gamma
$

此後，資料庫$HOME/.sshconfig.json中有條目

 ...
   {
      "name" : "vm-alpha",
      "createdAt" : 1504778353193,
      "enabled" : true,
      "fqdn" : "vm-alpha.foo.domain",
      "sshServerVersion" : "SSH-2.0-OpenSSH_6.7p1 Debian-5+deb8u3",
      "id" : "a7369847-e833-49bd-af95-e0d1292b3ed6",
      "updatedAt" : 1520958429041,
      "ips" : [
         "10.123.123.123"
      ]
   },
...

在你的 $HOME/.ssh/config 中：

 ...
# <<< BEGIN{a7369847-e833-49bd-af95-e0d1292b3ed6}
Host vm-alpha
	Hostname vm-alpha.foo.domain
	Hostname 10.123.123.123
# >>> END{a7369847-e833-49bd-af95-e0d1292b3ed6}
...

用例 2：將主機更新為 ~/.ssh/config

若要將現有主機更新至您的 ssh 配置，您通常會發出以下命令：

 $ ssh-config -u
$

此後，資料庫 $HOME/.sshconfig.json 中的條目已更新

 ...
   {
      "name" : "vm-alpha",
      "createdAt" : 1504778353193,
      "enabled" : false,
      "fqdn" : "vm-alpha.foo.domain",
      "sshServerVersion" : "SSH-2.0-OpenSSH_6.7p1 Debian-5+deb8u3",
      "id" : "a7369847-e833-49bd-af95-e0d1292b3ed6",
      "updatedAt" : 1520959605730,
      "ips" : [
         "10.123.123.123"
      ]
   },
...

由於 $HOME/.ssh/config 中不再可訪問，因此主機被刪除。

文件

涉及的文件有：

• ~/.ssh/config ：正在讀取和寫入的 SSH 配置。 SSH-Config 特定部分標有特殊的魔術標記，因此配置不會完全混亂。
• ~/.sshconfig.json ：保存所有主機資料的 JSON 檔案。用於追蹤哪些主機可存取或不可訪問，因為只有可存取的主機才會被納入上面的 SSH 用戶端設定中。

安裝

提供了 Debian 和 CentOS 軟體包用於安裝。請參閱 Github 上的發布部分。兩者都在/usr/bin/ssh-config中安裝了 shell 包裝器。

大樓

建構的系統需求是

• 甲骨文JDK 8
• 用於建置的 Apache Maven

可以使用命令觸發構建

 mvn clean package

執照

版權所有 2018 1&1 Internet SE 版權所有 2019 1&1 Ionos SE

根據 Apache 許可證 2.0 版（“許可證”）獲得許可；除非遵守許可證，否則您不得使用此文件。您可以在以下位置取得許可證副本：

http://www.apache.org/licenses/LICENSE-2.0

除非適用法律要求或書面同意，否則根據許可證分發的軟體均以「原樣」分發，不帶任何明示或暗示的保證或條件。請參閱許可證，了解許可證下管理權限和限制的特定語言。