本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# **eb ssh**
<a name="eb3-ssh"></a>

## 说明
<a name="eb3-sshdescription"></a>

**注意**  
此命令不适用于运行 Windows Server 实例的环境。

使用安全外壳 (SSH) 连接到您环境中的 Linux Amazon EC2 实例。如果一个环境具有多个正在运行的实例，EB CLI 将提示您指定要连接到的实例。为了使用此命令，SSH 必须已安装到您的本地计算机上，并且必须可在命令行中使用。私钥文件必须位于您的用户目录`.ssh`下名为的文件夹中，并且您环境中的 EC2 实例必须具有公有 IP 地址。

如果根目录包含一个指定自定义平台的 `platform.yaml` 文件，则该命令还会连接到自定义环境中的实例。

 

**SSH 密钥**  
如果以前没有配置过 SSH，可以在运行 **eb init** 时使用 EB CLI 创建一个密钥。如果您已运行 **eb init**，请使用 `--interactive` 选项再次运行，并且在系统提示设置 SSH 时选择 **Yes**（是）和 **Create New Keypair**（创建新密钥对）。在此过程中创建的密钥将由 EB CLI 存储在适当的文件夹中。

对于从 0.0.0.0/0（所有 IP 地址）传入的流量，如果尚未实施端口 22 的任何规则，则该命令将临时打开您的环境的安全组中的端口 22。如果您已配置了环境的安全组，以便针对限定的 CIDR 范围打开端口 22 来提高安全性，EB CLI 将采用该设置并且放弃对安全组的任何更改。要覆盖此行为并且强制 EB CLI 对所有传入流量打开端口 22，请使用 `--force` 选项。

有关配置环境的安全组的信息，请参阅[EC2 安全组](using-features.managing.ec2.console.md#using-features.managing.ec2.securitygroups)。

## 语法
<a name="eb3-sshsyntax"></a>

 **eb ssh** 

 **eb ssh *environment-name*** 

## 选项
<a name="eb3-sshoptions"></a>


****  

|  Name  |  描述  | 
| --- | --- | 
|  `-i` 或 `--instance`  |  指定您连接到的实例的实例 ID。建议您使用此选项。  | 
|  `-n` 或 `--number`  |  指定要通过数字连接的实例。  | 
|  `-o` 或 `--keep_open`  |  在 SSH 会话结束后，将安全组上的端口 22 保留打开状态。  | 
|  `--command`  |  在指定的实例上执行 Shell 命令，而不是启动 SSH 会话。  | 
|  `--custom`  |  指定要使用的 SSH 命令，而不是 'ssh -i keyfile'。请勿包括远程用户和主机名。  | 
|  `--setup`  |  更改分配到环境的实例的密钥对（需要替换实例）。  | 
|  `--force`  |  在环境的安全组中针对来自 0.0.0.0/0 的传入流量打开端口 22，即使已为 SSH 配置安全组也是如此。 如果环境的安全组配置为针对限定的 CIDR 范围打开端口 22，而该范围不包括您尝试发出连接的 IP 地址，请使用此选项。  | 
|  `--timeout` *minutes*  |  命令超时之前的设定分钟数。 只能与 `--setup` 参数一起使用。  | 
|  [常用选项](eb3-cmd-options.md)  |  | 

## Output
<a name="eb3-sshoutput"></a>

如果成功，命令将打开与实例的 SSH 连接。

## 示例
<a name="eb3-sshexample"></a>

以下示例将您连接到指定环境。

```
$ eb ssh
Select an instance to ssh into
1) i-96133799
2) i-5931e053
(default is 1): 1
INFO: Attempting to open port 22.
INFO: SSH port 22 open.
The authenticity of host '54.191.45.125 (54.191.45.125)' can't be established.
RSA key fingerprint is ee:69:62:df:90:f7:63:af:52:7c:80:60:1b:3b:51:a9.
Are you sure you want to continue connecting (yes/no)? yes
Warning: Permanently added '54.191.45.125' (RSA) to the list of known hosts.

       __|  __|_  )
       _|  (     /   Amazon Linux AMI
      ___|\___|___|

https://aws.amazon.com/amazon-linux-ami/2014.09-release-notes/
No packages needed for security; 1 packages available
Run "sudo yum update" to apply all updates.
[ec2-user@ip-172-31-8-185 ~]$ ls
[ec2-user@ip-172-31-8-185 ~]$ exit
logout
Connection to 54.191.45.125 closed.
INFO: Closed port 22 on ec2 instance security group
```