本頁面說明如何下載 Cloud Service Mesh 的疑難排解工具。如要對 Cloud Service Mesh 部署作業進行偵錯及檢查，您必須安裝 Google Cloud CLI 的 istioctl 元件。
下載 istioctl
受管理的控制層
更新 Google Cloud CLI：
gcloudcomponentsupdate
下載內嵌的 Cloud Service Mesh 疑難排解工具：
gcloudcomponentsinstallistioctl
如果您收到 You cannot perform this action because the
Google Cloud CLI component manager is disabled for this installation 錯誤訊息，表示您先前曾透過 Debian/Ubuntu 安裝 Google Cloud CLI。請改用下列指令：
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["難以理解","hardToUnderstand","thumb-down"],["資訊或程式碼範例有誤","incorrectInformationOrSampleCode","thumb-down"],["缺少我需要的資訊/範例","missingTheInformationSamplesINeed","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間：2025-09-04 (世界標準時間)。"],[],[],null,["Downloading the troubleshooting tool\n\nThis page shows you how to download the troubleshooting tool for\nCloud Service Mesh. To debug and review your Cloud Service Mesh deployment\nyou need to install the istioctl component for Google Cloud CLI.\n\nDownload istioctl \n\nManaged control plane\n\n1. Update Google Cloud CLI:\n\n gcloud components update\n\n2. Download the embedded Cloud Service Mesh troubleshooting tool:\n\n gcloud components install istioctl\n\nIf you receive error message `You cannot perform this action because the\nGoogle Cloud CLI component manager is disabled for this installation`, you\nhave previously installed Google Cloud CLI through\n[Debian/Ubuntu](https://cloud.google.com/sdk/docs/install#deb). Use the\nfollowing commands instead:\n\n1. Update Google Cloud CLI\n\n sudo apt-get update\n\n2. Download the embedded Cloud Service Mesh troubleshooting tool:\n\n sudo apt-get install google-cloud-sdk-istioctl\n\nIn-cluster control plane \n\nLinux\n\n1. Download the Cloud Service Mesh installation file to your current working directory:\n\n ```\n curl -LO https://storage.googleapis.com/gke-release/asm/istio-1.26.4-asm.1-linux-amd64.tar.gz\n ```\n2. Download the signature file and use `openssl` to verify the\n signature:\n\n ```\n curl -LO https://storage.googleapis.com/gke-release/asm/istio-1.26.4-asm.1-linux-amd64.tar.gz.1.sig\n openssl dgst -verify /dev/stdin -signature istio-1.26.4-asm.1-linux-amd64.tar.gz.1.sig istio-1.26.4-asm.1-linux-amd64.tar.gz \u003c\u003c'EOF'\n -----BEGIN PUBLIC KEY-----\n MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEWZrGCUaJJr1H8a36sG4UUoXvlXvZ\n wQfk16sxprI2gOJ2vFFggdq3ixF2h4qNBt0kI7ciDhgpwS8t+/960IsIgw==\n -----END PUBLIC KEY-----\n EOF\n ```\n\n The expected output is: `Verified OK`.\n3. Extract the contents of the file to any location on your file system. For\n example, to extract the contents to the current working directory:\n\n ```\n tar xzf istio-1.26.4-asm.1-linux-amd64.tar.gz\n ```\n\n The command creates an installation directory in your current working\n directory named `istio-1.26.4-asm.1` that contains: \n\n - Sample applications in the `samples` directory.\n - The `istioctl` command-line tool that you use to install Cloud Service Mesh is\n in the \u003ccode\u003ebin\u003c/code\u003e directory.\n - The Cloud Service Mesh configuration profiles are in the `manifests/profiles`\n directory.\n\n4. Ensure that you're in the Cloud Service Mesh installation's root directory.\n\n ```\n cd istio-1.26.4-asm.1\n ```\n\nMac OS\n\n1. Download the Cloud Service Mesh installation file to your current working\n directory:\n\n ```\n curl -LO https://storage.googleapis.com/gke-release/asm/istio-1.26.4-asm.1-osx.tar.gz\n ```\n2. Download the signature file and use `openssl` to verify the signature:\n\n ```\n curl -LO https://storage.googleapis.com/gke-release/asm/istio-1.26.4-asm.1-osx.tar.gz.1.sig\n openssl dgst -sha256 -verify /dev/stdin -signature istio-1.26.4-asm.1-osx.tar.gz.1.sig istio-1.26.4-asm.1-osx.tar.gz \u003c\u003c'EOF'\n -----BEGIN PUBLIC KEY-----\n MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEWZrGCUaJJr1H8a36sG4UUoXvlXvZ\n wQfk16sxprI2gOJ2vFFggdq3ixF2h4qNBt0kI7ciDhgpwS8t+/960IsIgw==\n -----END PUBLIC KEY-----\n EOF\n ```\n\n The expected output is: `Verified OK`.\n3. Extract the contents of the file to any location on your file system. For\n example, to extract the contents to the current working directory:\n\n ```\n tar xzf istio-1.26.4-asm.1-osx.tar.gz\n ```\n\n The command creates an installation directory in your current working\n directory named `istio-1.26.4-asm.1` that contains: \n\n - Sample applications in the `samples` directory.\n - The `istioctl` command-line tool that you use to install Cloud Service Mesh is\n in the \u003ccode\u003ebin\u003c/code\u003e directory.\n - The Cloud Service Mesh configuration profiles are in the `manifests/profiles`\n directory.\n\n4. Ensure that you're in the Cloud Service Mesh installation's root directory.\n\n ```\n cd istio-1.26.4-asm.1\n ```\n\nWindows\n\n1. Download the Cloud Service Mesh installation file to your current working\n directory:\n\n ```\n curl -LO https://storage.googleapis.com/gke-release/asm/istio-1.26.4-asm.1-win.zip\n ```\n2. Download the signature file and use `openssl` to verify the signature:\n\n ```\n curl -LO https://storage.googleapis.com/gke-release/asm/istio-1.26.4-asm.1-win.zip.1.sig\n openssl dgst -verify - -signature istio-1.26.4-asm.1-win.zip.1.sig istio-1.26.4-asm.1-win.zip \u003c\u003c'EOF'\n -----BEGIN PUBLIC KEY-----\n MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEWZrGCUaJJr1H8a36sG4UUoXvlXvZ\n wQfk16sxprI2gOJ2vFFggdq3ixF2h4qNBt0kI7ciDhgpwS8t+/960IsIgw==\n -----END PUBLIC KEY-----\n EOF\n ```\n\n The expected output is: `Verified OK`.\n3. Extract the contents of the file to any location on your file system. For\n example, to extract the contents to the current working directory:\n\n ```\n tar xzf istio-1.26.4-asm.1-win.zip\n ```\n\n The command creates an installation directory in your current working\n directory named `istio-1.26.4-asm.1` that contains: \n\n - Sample applications in the `samples` directory.\n - The `istioctl` command-line tool that you use to install Cloud Service Mesh is\n in the \u003ccode\u003ebin\u003c/code\u003e directory.\n - The Cloud Service Mesh configuration profiles are in the `manifests/profiles`\n directory.\n\n4. Ensure that you're in the Cloud Service Mesh installation's root directory.\n\n ```\n cd istio-1.26.4-asm.1\n ```\n\nWhat's next\n\n- [Troubleshoot Cloud Service Mesh step-by-step](/service-mesh/docs/troubleshooting/troubleshoot-intro)"]]
