安装 gsutil

本页面介绍了 gsutil 的安装和设置，该工具可让您从命令行使用 HTTPS 访问 Cloud Storage。

安装 gsutil 后，您可以立即访问公开数据，并根据权限进行读取和写入。如需使用与您共享的受保护数据进行交互，您必须向 Cloud Storage 服务进行身份验证。通过启用结算功能，您可以创建和管理自己的存储桶。

系统要求

  • gsutil 工具在 Linux/Unix、Mac OS、Windows（XP 或更高版本）上运行。

  • gsutil 5.35 版及更高版本需要使用 Python 3.9 到 3.13，您可以通过使用 Python 版本管理器或安装相应版本来获取。

以下说明介绍了如何管理 Python 版本：

Linux

前提条件：安装 Python 版本管理器 (pyenv) 并安装合适的 Python 版本。

  1. 设置全局 Python 版本：
    • 如需将 Python 3.13 设置为全局版本，请运行以下命令： 
      pyenv global 3.13
    • 或者，在本地为特定项目文件夹设置 Python 版本： 
      pyenv local 3.13
  2. 确认使用的是正确的 Python 版本： 
    python --version

    您应该会看到：

    Python 3.13
macOS

方法 1：使用 Homebrew (brew)

前提条件：安装 Homebrew，并通过 homebrew 安装合适的 Python 版本。

  1. 将特定的 Python 版本设置为默认版本：
    • 将所需版本添加到 $PATH 中。例如，如需使用 Python 3.13，请运行以下命令： 
      export PATH="/usr/local/opt/python@3.13/bin:$PATH"
    • 如需使此更改永久生效，请添加 shell 配置文件的路径（~/.bash_profile、~/.zshrc 或 ~/.bashrc）。
  2. 确认使用的是正确的 Python 版本： 
    python --version

    您应该会看到：

    Python 3.13

方法 2：使用 pyenv

前提条件：安装 Python 版本管理器 (pyenv) 并通过 pyenv 安装合适的 Python 版本。

  1. 设置全局 Python 版本：
    • 如需全局设置 Python 版本（适用于所有终端），请运行以下命令： 
      pyenv global 3.13
    • 或者，在本地为特定项目文件夹设置 Python 版本： 
      pyenv local 3.13
  2. 确认使用的是正确的 Python 版本： 
    python --version

    您应该会看到：

    Python 3.13
Windows

前提条件：安装 Python 版本管理器 (pyenv-win) 并通过 pyenv 安装合适的 Python 版本。

  1. 设置全局 Python 版本：
    • 如需将 Python 3.13 设置为全局版本，请运行以下命令： 
      pyenv global 3.13
    • 或者，在本地为特定项目文件夹设置 Python 版本： 
      pyenv local 3.13
  2. 确认使用的是正确的 Python 版本： 
    python --version

    您应该会看到：

    Python 3.13
  • 如果您计划使用复合对象，则需要安装已编译的 crcmod。在 Windows 系统中，已编译的 crcmod 仅适用于 32 位 Python。如需详细了解 crcmod，请安装 gsutil 并使用 gsutil help crc32c 命令查看帮助主题。

安装 gsutil

官方支持的 gsutil 安装和更新方法已包含在 Google Cloud CLI 中。

准备工作

Google Cloud CLI 和 gsutil 具有 Python 版本依赖项，可能会导致兼容性问题。Google Cloud CLI 需要 Python 3.9 到 3.14，而 gsutil 需要 Python 3.9 到 3.13。

如需安装 gsutil，我们建议您将 gsutil 作为 Google Cloud CLI 的一部分进行安装。如果您选择直接安装 gsutil，请使用 Python 3.9 到 3.13 以避免兼容性问题。

将 gsutil 作为 Google Cloud CLI 的一部分进行安装

按照您的操作系统对应的说明操作，将 gsutil 作为 Google Cloud CLI 的一部分进行安装：

Linux
  1. 确认您拥有受支持的 Python 版本。Google Cloud CLI 需要 Python 3.9 到 3.14。x86_64 Linux 软件包中包含默认首选的捆绑式 Python 解释器。如需了解如何选择和配置 Python 解释器，请参阅 gcloud topic startup 文档。
  2. 下载以下内容之一：
    平台 软件包名称 大小 SHA256 校验和
    Linux 64 位

    (x86_64)

    		 google-cloud-cli-linux-x86_64.tar.gz 203.2 MB 00ad1adc3ee30ead317cce7176011ce4fa984339d5c41a08eff9504301f9ee85
    Linux 64 位

    (Arm)

    		 google-cloud-cli-linux-arm.tar.gz 58.0 MB 19394fc05dbc4984533a2eea57ff007a8c8dad428d0d283fec1349ffda4941a5
    Linux 32 位

    (x86)

    		 google-cloud-cli-linux-x86.tar.gz 58.0 MB 8d67ea49ddddfe86ac889acd32fe709ed1af82759cdceef61debcd99ee98c1c5

    如需下载 Linux 归档文件，请运行以下命令：

    curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-cli-linux-x86_64.tar.gz

    请参阅上表并将 google-cloud-cli-linux-x86_64.tar.gz 替换为适用于您的配置的 *.tar.gz 软件包名称。

  3. 如需将文件内容解压缩到文件系统，请运行以下命令： 
    tar -xf google-cloud-cli-linux-x86_64.tar.gz
     如需替换现有安装，请删除现有的 google-cloud-sdk 目录，然后将归档解压缩到同一位置。
  4. 从解压缩到的文件夹的根目录运行安装脚本： 
    ./google-cloud-sdk/install.sh
     脚本会提示您执行以下设置操作。如要接受，请在出现提示时回答 Y。 您还可以通过提供标志以非交互方式执行安装。 如需查看可用标志，请运行以下命令： 
    ./google-cloud-sdk/install.sh --help
  5. 可选：如果您在上一步中更新了 PATH，请打开一个新终端，让更改生效。
  6. 运行 gcloud init 以初始化、授权和配置 gcloud CLI。
  7. 可选：使用组件管理器安装其他组件。
Debian/Ubuntu

软件包内容

对于 Debian 和 Ubuntu 系统，可以通过软件包格式的 gcloud CLI 进行安装。此软件包仅包含 gcloud、gcloud alpha、gcloud beta、gsutil 和 bq 命令行工具。而不包括 kubectl 或使用 gcloud 命令部署应用所需的 App Engine 扩展程序。如果您需要这些组件，则必须单独安装。

准备工作

在安装 gcloud CLI 之前，确保您的操作系统满足以下要求：

  • 这是尚未达到服务终止期限的 Ubuntu 版本或尚未达到服务终止期限的 Debian 稳定版本。
  • 它最近更新了其软件包：如需立即执行此操作，请运行以下命令： 
    sudo apt-get update
  • 它安装了 apt-transport-https、ca-certificates、gnupg 和 curl。如需安装这些软件包，请运行以下命令： 
    sudo apt-get install apt-transport-https ca-certificates gnupg curl

安装

  1. 导入 Google Cloud 公钥。

    • 对于较新的发行版（Debian 9+ 或 Ubuntu 18.04+），请运行以下命令：

      curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg
    • 对于较旧的发行版，请运行以下命令： 
      curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key --keyring /usr/share/keyrings/cloud.google.gpg add -

    • 如果您的发行版的 apt-key 命令不支持 --keyring 参数，请运行以下命令：

      curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -

    • 如果您由于密钥过期而无法获取最新更新，请获取最新的 apt-get.gpg 密钥文件。

  2. 添加 gcloud CLI 发行版 URI 作为软件包源。
    • 对于较新的发行版（Debian 9+ 或 Ubuntu 18.04+），请运行以下命令： 
      echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list

    • 对于不支持 signed-by 选项的旧发行版，请运行以下命令：

      echo "deb https://packages.cloud.google.com/apt cloud-sdk main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list
  3. 更新并安装 gcloud CLI：
    sudo apt-get update && sudo apt-get install google-cloud-cli
     如需了解其他 apt-get 选项（例如停用提示或试运行），请参阅 apt-get 手册页面。

    Docker 提示：如果安装 Docker 映像中的 gcloud CLI，请改用单个 RUN 步骤：

    RUN echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" | tee -a /etc/apt/sources.list.d/google-cloud-sdk.list && curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg && apt-get update -y && apt-get install google-cloud-cli -y
    对于不支持 gpg --dearmor 命令的旧基础映像： 
    RUN echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" | tee -a /etc/apt/sources.list.d/google-cloud-sdk.list && curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | apt-key --keyring /usr/share/keyrings/cloud.google.gpg  add - && apt-get update -y && apt-get install google-cloud-cli -y
  4. 可选：安装以下任何其他组件：
    • google-cloud-cli-anthos-auth
    • google-cloud-cli-app-engine-go
    • google-cloud-cli-app-engine-grpc
    • google-cloud-cli-app-engine-java
    • google-cloud-cli-app-engine-python
    • google-cloud-cli-app-engine-python-extras
    • google-cloud-cli-bigtable-emulator
    • google-cloud-cli-cbt
    • google-cloud-cli-cloud-build-local
    • google-cloud-cli-cloud-run-proxy
    • google-cloud-cli-config-connector
    • google-cloud-cli-datastore-emulator
    • google-cloud-cli-firestore-emulator
    • google-cloud-cli-gke-gcloud-auth-plugin
    • google-cloud-cli-kpt
    • google-cloud-cli-kubectl-oidc
    • google-cloud-cli-local-extract
    • google-cloud-cli-minikube
    • google-cloud-cli-nomos
    • google-cloud-cli-pubsub-emulator
    • google-cloud-cli-skaffold
    • google-cloud-cli-spanner-emulator
    • google-cloud-cli-terraform-validator