跳到主要内容

Podman 开发者手册 - 列出Podman服务的SSH目标连接

一、概述​

Podman 允许你通过 SSH 连接到远程的 Podman 服务，以管理和操作远程服务器上的容器。为了帮助你管理这些远程连接，Podman 提供了 podman system connection list 命令，该命令用于列出所有已配置的 SSH 目标连接。

二、命令格式​

podman system connection list [OPTIONS]

或者可以使用简写形式：

podman system connection ls [OPTIONS]

这些命令将列出所有已配置的 SSH 目标连接，包括连接名称、URI、身份认证信息、是否默认连接以及是否可读写。

三、选项说明​

--format, -f=format​

这个选项允许你指定输出的格式。Podman 支持多种格式，包括 JSON 和 Go 模板。Go 模板可以让你自定义输出的内容和格式。以下是一些可用的占位符：

  • .Default：表示该连接是否为默认连接。
  • .Identity：包含 SSH 标识的文件路径。
  • .Name：连接名称/标识符。
  • .ReadWrite：表示是否可以使用系统连接命令修改此连接。
  • .URI：Podman 服务的 URI，包括协议、主机、端口和可能的 Unix 套接字路径。

--quiet, -q​

使用这个选项时，命令将仅显示连接名称，而不显示其他详细信息。这可以帮助你快速查看所有连接的名称列表。

四、使用示例​

列出所有连接​

执行以下命令将列出所有已配置的 SSH 目标连接及其详细信息：

podman system connection list

输出可能类似于：

Name     URI                                                  Identity            Default  ReadWrite
conn1    ssh://user1@remote1.example.com:22/run/podman/podman.sock /path/to/key1   true     true
conn2    ssh://user2@remote2.example.com/run/user/1000/podman/podman.sock /path/to/key2 false    false

仅显示连接名称​

如果你只想快速查看连接名称列表，可以使用 --quiet 选项：

podman system connection list --quiet

输出可能只包含：

conn1
conn2

五、注意事项​

  • 在使用 podman system connection list 命令之前，请确保你已经正确配置了 SSH 连接，并且 Podman 服务在远程服务器上正在运行。
  • 如果你还没有添加任何 SSH 连接，该命令将不会显示任何输出。你可以使用 podman system connection add 命令来添加新的 SSH 连接。
  • 输出的详细信息可以帮助你识别每个连接的配置和状态，从而方便你进行进一步的管理或操作。

六、相关文档与命令​

  • podman(1)：Podman 的主文档，提供了关于 Podman 的整体介绍和常用命令的说明。
  • podman-system(1)：关于 Podman 系统级操作的文档，包括连接管理、存储管理等。
  • podman-system-connection(1)：详细描述了与 Podman SSH 连接管理相关的命令和选项，包括如何添加、删除、列出和设置默认连接等。

七、总结​

podman system connection list 命令是 Podman 开发者手册中用于列出所有已配置的 SSH 目标连接的重要工具。通过该命令，你可以方便地查看和管理远程连接，从而更有效地在多个服务器之间部署和管理容器。希望这份开发者手册能够帮助你更好地理解和使用 Podman 的 SSH 连接管理功能。

历史​

2020年7月，最初由Jhon Honce（jhonce at redhat dot com）整理编写。

通过使用podman system connection list命令，开发者可以轻松地查看所有已配置的Podman服务连接，并据此进行进一步的管理或操作。