在受到 Proxy/防火牆保護的情況下設定 gcloud CLI

如果您受到企業 Proxy 或防火牆的保護，Google Cloud CLI 可能無法以預設設定來存取網際網路。

安裝 gcloud CLI

互動式 gcloud CLI 安裝程式會在安裝過程中從網際網路下載元件，如果您使用 Proxy 或防火牆，這項程序可能無法正常運作。

如為必須使用 Proxy 設定的簡易安裝程序，請使用其中一個獨立的版本化封存檔安裝 gcloud CLI。您也可以從下載封存下載所有舊版 gcloud CLI。

Proxy 配置

安裝 gcloud CLI 後，您可以執行 gcloud config，使用 gcloud CLI 屬性設定 Proxy。如要進一步瞭解 gcloud CLI 屬性及其使用方式，請參閱「屬性」頁面。

首先，設定您要使用的 Proxy 類型、位址和用來連線的通訊埠：

gcloud config set proxy/type [PROXY_TYPE]

gcloud config set proxy/address [PROXY_IP_ADDRESS]

gcloud config set proxy/port [PROXY_PORT]
  • gcloud CLI 支援下列可用於 PROXY_TYPE 的值：http、http_no_tunnel、socks4、socks5
  • PROXY_IP_ADDRESS 是 Proxy 可以連線的主機名稱或 IP 位址。
  • PROXY_PORT 是可以執行 Proxy 的通訊埠 (例如 8080)。

如需已驗證的 Proxy，您需要使用屬性設定 Proxy 使用者名稱和密碼，如下所示：

gcloud config set proxy/username [USERNAME]

gcloud config set proxy/password [PASSWORD]

或者，如要避免將 Proxy 憑證記錄在任何記錄檔 (例如殼層記錄或 gcloud CLI 記錄檔)，或者 gcloud CLI 設定檔中，您可以透過下列方式來使用環境變數設定屬性：

export CLOUDSDK_PROXY_USERNAME [USERNAME]

export CLOUDSDK_PROXY_PASSWORD [PASSWORD]

gcloud CLI 不會儲存這些值。這樣一來，憑證可儲存在本機的加密檔案中，也可以儲存在安全網路位置，並在必要時加以擷取。

如果您使用 Proxy，並收到 SSL 交握錯誤，可能是因為 Proxy 是使用自訂 CA 的中間人 Proxy。您需要設定下列屬性，指向自訂 CA 檔案：

gcloud config set core/custom_ca_certs_file [PATH_TO_CUSTOM_CA]

如需相關屬性的完整說明，請執行 gcloud topic configurations 或 gcloud config set，並在「Available properties」(可用屬性) 區段下方尋找 proxy。