在 Linux 上安装、更新和卸载 AWS CLI 版本 1

您可以使用pip软件包管理器或捆绑的安装程序在大多数 Linux 发行版上安装 AWS Command Line Interface (AWS CLI) 版本 1 及其依赖项。

尽管该awscli软件包可在存储库中供其他包管理器（例如apt和）使用yum，但这些软件包不受制作、管理或支持 AWS。我们建议您仅 AWS CLI 从官方 AWS 分发点安装，如本指南中所述。

Sections

先决条件
使用捆绑的安装程序在 Linux 上安装和卸载 AWS CLI 版本 1
使用 pip 安装和卸载 AWS CLI 版本 1

先决条件

您必须已安装 Python 3.8 或更高版本。有关安装说明，请参阅 Python 的初学者指南 中的下载 Python 页面。

Python 版本支持矩阵
AWS CLI 版本	支持的 Python 版本
1.32.0 – 当前	Python 3.8+
1.27.0 – 1.31.x	Python 3.7+
1.20.0 – 1.26.x	Python 3.6+
1.19.0 — 1.19.x	Python 2.7+、Python 3.6+
1.17 – 1.18.x	Python 2.7+、Python 3.4+
1.0 – 1.16.x	Python 2.6 及更早版本，Python 3.3 及更早版本

使用捆绑的安装程序在 Linux 上安装和卸载 AWS CLI 版本 1

在 Linux 或 macOS 上，可以使用捆绑安装程序来安装 AWS CLI的版本 1。捆绑安装程序包含所有依赖项，并可以离线使用。

注意

捆绑安装程序不支持安装到包含空格的路径。

使用捆绑的安装程序安装 AWS CLI 版本 1 `sudo`

以下步骤使您能够在任何 AWS CLI 版本的 Linux 或 macOS 上通过命令行安装版本 1。

以下是可剪切和粘贴以作为一组命令运行的安装命令的摘要，各个命令的具体解释见下文。

要获取最新版本的 AWS CLI，请使用以下命令块：


$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"
unzip awscli-bundle.zip
sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws

对于的特定版本 AWS CLI，请在文件名后面附加连字符和版本号。在本示例中，版本 1.16.312 的文件名为 awscli-bundle-1.16.312.zip，这会生成以下命令：


$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip"
unzip awscli-bundle.zip
sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws

按照命令行中的以下步骤使用捆绑的安装程序安装 AWS CLI 版本 1。

使用捆绑的安装程序安装 AWS CLI 版本 1

使用以下方法之一下载 AWS CLI 版本 1 捆绑安装程序。
- 使用 curl 命令下载。
  
  要获取最新版本的 AWS CLI，请使用以下命令块：
```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"
```
  对于的特定版本 AWS CLI，请在文件名后面附加连字符和版本号。在本示例中，版本 1.16.312 的文件名为 awscli-bundle-1.16.312.zip，这会生成以下命令：
```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip"
```
- 使用直接链接下载。
  
  对于最新版本的 AWS CLI：https://s3.amazonaws.com/aws-cli/awscli-bundle.zip
  
  对于的特定版本 AWS CLI，请在文件名后面附加连字符和版本号。在本示例中，版本 1.16.312 的文件名为 awscli-bundle-1.16.312.zip，这会生成以下 URL：https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip
从程序包中提取文件。如果没有 unzip 来提取文件，请使用 Linux 发行版的内置程序包管理器进行安装。
```
$ unzip awscli-bundle.zip
```
运行安装程序。安装程序安装 AWS CLI at /usr/local/aws 并在/usr/local/bin目录中创建符aws号链接。使用 -b 选项创建符号链接将免除在用户的 $PATH 变量中指定安装目录的需要。这应该允许所有用户 AWS CLI 通过aws从任何目录进入来呼叫。
```
$ sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws
```
默认情况下，安装脚本在系统默认版本的 Python 下运行。如果您已经安装了 Python 的替代版本并想使用该版本来安装 AWS CLI，请按照 Python 可执行文件的绝对路径使用该版本运行安装脚本，如下所示。
```
$ sudo /usr/local/bin/python3.7 awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws
```

验证 AWS CLI 安装是否正确。


$ aws --version
aws-cli/1.32.40 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6

如果出现错误，请参阅排查 AWS CLI 错误。

使用捆绑的安装程序安装 AWS CLI 版本 1，而不使用 `sudo`

如果您没有sudo权限或 AWS CLI 只想为当前用户安装，则可以使用先前命令的修改版本。前两个命令是相同的。

要获取最新版本的 AWS CLI，请使用以下命令块：


$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"
unzip awscli-bundle.zip
./awscli-bundle/install -b ~/bin/aws

对于的特定版本 AWS CLI，请在文件名后面附加连字符和版本号。在本示例中，版本 1.16.312 的文件名为 awscli-bundle-1.16.312.zip，这会生成以下命令：


$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip"
unzip awscli-bundle.zip
./awscli-bundle/install -b ~/bin/aws

为当前用户安装 AWS CLI 版本 1

通过以下方式之一下载 AWS CLI 版本 1 捆绑安装程序。
- 使用 curl 命令下载。
  
  要获取最新版本的 AWS CLI，请使用以下命令块：
```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"
```
  对于的特定版本 AWS CLI，请在文件名后面附加连字符和版本号。在本示例中，版本 1.16.312 的文件名为 awscli-bundle-1.16.312.zip，这会生成以下命令：
```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip"
```
- 使用直接链接下载。
  
  对于最新版本的 AWS CLI：https://s3.amazonaws.com/aws-cli/awscli-bundle.zip
  
  对于的特定版本 AWS CLI，请在文件名后面附加连字符和版本号。在本示例中，版本 1.16.312 的文件名为 awscli-bundle-1.16.312.zip，这会生成以下 URL：https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip
使用 unzip 从程序包中提取文件。如果没有 unzip，请使用 Linux 发行版的内置程序包管理器进行安装。
```
$ unzip awscli-bundle.zip
```
运行安装程序。安装程序安装 AWS CLI at /usr/local/aws 并在/usr/local/bin目录中创建符aws号链接。此命令使用 -b 参数以指定安装程序放置 aws 符号链接文件的目录。您必须具有对指定文件夹的写入权限。
```
$ ./awscli-bundle/install -b ~/bin/aws
```
这会将安装 AWS CLI 到默认位置 (~/.local/lib/aws)，并在上创建一个符号链接（符号链接）。~/bin/aws确保您的 ~/bin 环境变量中包含 PATH，以使该符号链接生效。
```
$ echo $PATH | grep ~/bin     // See if $PATH contains ~/bin (output will be empty if it doesn't)
$ export PATH=~/bin:$PATH     // Add ~/bin to $PATH if necessary
```
确保该目录中包含 AWS CLI 版本 1 的PATH变量。
1. 在您的用户文件夹中查找 Shell 的配置文件脚本。如果您不能确定所使用的 Shell，请运行 echo $SHELL。
```
$ ls -a ~
.  ..  .bash_logout  .bash_profile  .bashrc  Desktop  Documents  Downloads
```
  - Bash – .bash_profile、.profile 或 .bash_login
  - Zsh – .zshrc
  - Tcsh – .tcshrc、.cshrc 或 .login
2. 在配置文件脚本末尾添加与以下示例类似的导出命令。
```
export PATH=~/.local/bin:$PATH
```
  此命令将路径（在本示例中为 ~/.local/bin）插入到现有 PATH 变量的前面。
3. 将配置文件重新加载到当前会话中，以使更改生效。
```
$ source ~/.bash_profile
```

验证 AWS CLI 安装是否正确。


$ aws --version
aws-cli/1.32.40 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6

如果出现错误，请参阅排查 AWS CLI 错误。

卸载 AWS CLI 版本 1 的捆绑安装程序

如果您 AWS CLI 使用捆绑的安装程序安装，请按照以下说明进行操作。除了可选的符号链接之外，捆绑安装程序不会将任何内容放在安装目录之外，所以卸载十分简单，就是直接删除这两个项目。
```
$ sudo rm -rf /usr/local/aws
$ sudo rm /usr/local/bin/aws
```
（可选）移除.aws文件夹中的共享 AWS SDK 和 AWS CLI 设置信息。

警告
这些配置和凭据设置在所有 AWS 软件开发工具包和之间共享。 AWS CLI如果删除此文件夹，则系统上仍存在的任何 AWS SDK 都无法访问它们。

.aws 文件夹的默认位置因平台而异，默认情况下，该文件夹位于 ~/.aws/。如果您的用户对此目录具有写入权限，则无需使用 sudo。
```
$ sudo rm -r ~/.aws/
```

使用 pip 安装和卸载 AWS CLI 版本 1

主题

安装 pip
使用 pip 安装并更新 AWS CLI 版本 1
将 AWS CLI 版本 1 可执行文件添加到命令行路径中
AWS CLI 使用 pip 卸载
AWS CLI 安装和卸载错误疑难解答

安装 pip

如果尚未安装 pip，可以使用 Python 打包权威机构 提供的脚本进行安装。运行 pip --version 可查看您的 Linux 版本是否已包含 Python 和 pip。如果您安装了 Python 3 或更高版本，我们建议您使用 pip3 命令。

使用 curl 命令下载安装脚本。以下命令使用 -O（大写字母“O”）参数指定下载的文件将使用与远程主机上相同的名称存储在当前的目录中。
```
$ curl -O https://bootstrap.pypa.io/get-pip.py
```
使用 python 或 python3 命令运行脚本以下载并安装最新版本的 pip 和其他必需的支持包。当您包含 --user 开关时，脚本将 pip 安装到路径 ~/.local/bin。
```
$ python3 get-pip.py --user
```
确保包含 pip 的目录是您的 PATH 变量的一部分。
1. 在您的用户文件夹中查找 Shell 的配置文件脚本。如果您不能确定所使用的 Shell，请运行 echo $SHELL。
```
$ ls -a ~
.  ..  .bash_logout  .bash_profile  .bashrc  Desktop  Documents  Downloads
```
  - Bash – .bash_profile、.profile 或 .bash_login
  - Zsh – .zshrc
  - Tcsh – .tcshrc、.cshrc 或 .login
2. 在配置文件脚本末尾添加与以下示例类似的导出命令。
```
export PATH=~/.local/bin:$PATH
```
  此命令将路径（在本示例中为 ~/.local/bin）插入到现有 PATH 变量的前面。
3. 将配置文件重新加载到当前会话中，以使更改生效。
```
$ source ~/.bash_profile
```

要验证 pip 是 pip3 否已正确安装，请运行以下命令。


$ pip3 --version
pip 24.0 from ~/.local/lib/python3.7/site-packages (python 3.7)

使用 pip 安装并更新 AWS CLI 版本 1

使用 pip 或 pip3 命令安装或更新 AWS CLI。如果您使用的是 Python 3 或更高版本，我们建议您使用 pip3 命令。--user交换机pip将安装 AWS CLI 到~/.local/bin。

要获取最新版本的 AWS CLI，请使用以下命令块：
```
$ pip3 install awscli --upgrade --user
```
对于的特定版本 AWS CLI，在文件名后面附加两个等号=和版本号。在本示例中，版本 1.16.312 的文件名为 ==1.16.312，这会生成以下命令：
```
$ pip3 install awscli==1.16.312 --upgrade --user
```
注意
为您的终端使用适当的引用规则。要使用 = 字符，您可能需要使用单引号或双引号适当地进行转义。以下示例使用单引号进行转义：
```
$ pip3 install 'awscli==1.16.312' --upgrade --user
```

验证 AWS CLI 安装是否正确。


$ aws --version
aws-cli/1.32.40 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6

如果出现错误，请参阅排查 AWS CLI 错误。

将 AWS CLI 版本 1 可执行文件添加到命令行路径中

在使用 pip 进行安装后，可能需要将 aws 可执行文件添加到操作系统的 PATH 环境变量中。

您可以通过运行以下命令来验证pip安装的是哪个文件夹。 AWS CLI


$ which aws
/home/username/.local/bin/aws

您可以将此路径 ~/.local/bin/ 作为参考，因为在 Linux 中 /home/username 对应于 ~。

如果您忽略了 --user 开关且未在用户模式下安装，可执行文件可能位于 Python 安装的 bin 文件夹中。如果您不知道 Python 的安装位置，请运行此命令。


$ which python
/usr/local/bin/python

输出可能是符号链接的路径，而不是实际的可执行文件。运行 ls -al 以查看所指向的路径。


$ ls -al /usr/local/bin/python
/usr/local/bin/python -> ~/.local/Python/3.6/bin/python3.6

pip 将程序安装到 Python 应用程序所在的文件夹中。将此文件夹添加到 PATH 变量。

修改您的 `PATH` 变量

在您的用户目录中查找 Shell 的配置文件脚本。如果您不能确定所使用的 Shell，请运行 echo $SHELL。
```
$ ls -a ~
.  ..  .bash_logout  .bash_profile  .bashrc  Desktop  Documents  Downloads
```
- Bash – .bash_profile、.profile 或 .bash_login
- Zsh – .zshrc
- Tcsh – .tcshrc、.cshrc 或 .login
向配置文件脚本中添加导出命令。
```
export PATH=~/.local/bin:$PATH
```
在本示例中，此命令将路径 ~/.local/bin 添加到当前 PATH 变量中。
将更新的配置文件加载到当前会话中。
```
$ source ~/.bash_profile
```

AWS CLI 使用 pip 卸载

如果您使用安装 AWS CLI 版本 1pip，则还必须使用进行卸载pip。
```
$ pip uninstall awscli
```
如果您使用的是 Python 版本 2 或 3，则可能需要使用 pip2 或 pip3 命令。使用aws --version命令确定与您安装的版本 1 关联的 Python AWS CLI 版本。
```
$ pip3 uninstall awscli
```
您可能需要重新启动命令提示符窗口或电脑才能删除所有文件。
（可选）移除.aws文件夹中的共享 AWS SDK 和 AWS CLI 设置信息。

警告
这些配置和凭据设置在所有 AWS 软件开发工具包和之间共享。 AWS CLI如果删除此文件夹，则系统上仍存在的任何 AWS SDK 都无法访问它们。

.aws 文件夹的默认位置因平台而异，默认情况下，该文件夹位于 ~/.aws/。如果您的用户对此目录具有写入权限，则无需使用 sudo。
```
$ sudo rm ~/.aws/
```

AWS CLI 安装和卸载错误疑难解答

如果您在安装或卸载后遇到问题 AWS CLI，排查 AWS CLI 错误请参阅，了解故障排除步骤。有关相关性最高的故障排除步骤，请参阅找不到命令错误、“aws --version”命令返回的版本与您安装的版本不同和卸载 AWS CLI 后，“aws --version”命令返回一个版本。

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

文档惯例

Amazon Linux

macOS

在 Linux 上安装、更新和卸载 AWS CLI 版本 1

Sections

先决条件

使用捆绑的安装程序在 Linux 上安装和卸载 AWS CLI 版本 1

注意

主题

使用捆绑的安装程序安装 AWS CLI 版本 1 sudo

使用捆绑的安装程序安装 AWS CLI 版本 1

使用捆绑的安装程序安装 AWS CLI 版本 1，而不使用 sudo

为当前用户安装 AWS CLI 版本 1

卸载 AWS CLI 版本 1 的捆绑安装程序

警告

使用 pip 安装和卸载 AWS CLI 版本 1

主题

安装 pip

使用 pip 安装并更新 AWS CLI 版本 1

注意

将 AWS CLI 版本 1 可执行文件添加到命令行路径中

修改您的 PATH 变量

AWS CLI 使用 pip 卸载

警告

AWS CLI 安装和卸载错误疑难解答

使用捆绑的安装程序安装 AWS CLI 版本 1 `sudo`

使用捆绑的安装程序安装 AWS CLI 版本 1，而不使用 `sudo`

修改您的 `PATH` 变量