建立虛擬機器 (VM) 執行個體時, Google Cloud 會根據 VM 名稱建立內部 DNS 名稱。除非您指定了自訂主機名稱,否則 Google Cloud 會使用自動建立的內部 DNS 名稱做為主機名稱,並提供給 VM。
您可以指定任何完整的 DNS 名稱,使用自訂主機名稱建立 VM。自訂主機名稱可協助您維持慣例,或支援預期使用特定主機名稱之應用程式的需求。
即使您指定了自訂主機名稱, Google Cloud 仍會建立 Compute Engine 內部 DNS 名稱。您可以使用這個自動建立的內部 DNS 記錄連線至 VM。內部 DNS 記錄會解析為內部 DNS 名稱,而非自訂主機名稱。使用自訂主機名稱時,您仍需要在適當的區域中建立對應的 DNS 記錄,例如使用 Cloud DNS。
事前準備
-
如果尚未設定驗證,請先完成設定。
「驗證」是指驗證身分的程序,確認您有權存取 Google Cloud 服務和 API。如要從本機開發環境執行程式碼或範例,請選取下列其中一個選項,向 Compute Engine 進行驗證:
Select the tab for how you plan to use the samples on this page:
Console
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
-
After installing the Google Cloud CLI, initialize it by running the following command:
gcloud init
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
- Set a default region and zone.
-
Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
-
Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
-
Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
-
Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
-
Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
-
專案的
compute.instances.create
-
如要使用自訂映像檔建立 VM:
compute.images.useReadOnly
在映像檔上 -
如要使用快照建立 VM:
compute.snapshots.useReadOnly
快照 -
如要使用執行個體範本建立 VM,請按照下列步驟操作:
compute.instanceTemplates.useReadOnly
在執行個體範本上 -
如要將舊版網路指派給 VM,請按照下列步驟操作:
compute.networks.use
專案 -
如要為 VM 指定靜態 IP 位址:
專案的
compute.addresses.use
-
使用舊版網路時,如要將外部 IP 位址指派給 VM,請在專案中設定
compute.networks.useExternalIp
。 -
如要為 VM 指定子網路,請在專案或所選子網路上授予
compute.subnetworks.use
權限。 -
使用虛擬私有雲網路時,如要將外部 IP 位址指派給 VM,請在專案或所選子網路上取得
compute.subnetworks.useExternalIp
權限。 -
如要為 VM 設定 VM 執行個體中繼資料,請在專案中執行下列指令:
compute.instances.setMetadata
-
如要為 VM 設定標記,請按照下列步驟操作:
compute.instances.setTags
在 VM 上 -
如要為 VM 設定標籤,請按照下列步驟操作:
compute.instances.setLabels
在 VM 上 -
如要設定 VM 使用的服務帳戶:
compute.instances.setServiceAccount
在 VM 上 -
為 VM 建立新磁碟:
compute.disks.create
專案的 -
如要以唯讀或讀寫模式附加現有磁碟:
磁碟的
compute.disks.use
-
如要以唯讀模式連接現有磁碟:
compute.disks.useReadOnly
磁碟的 您必須針對自訂主機名稱手動設定 DNS 記錄。自訂主機名稱無法依 Compute Engine 內部 DNS 提供的自動建立記錄來進行解析。您可以使用下列任何一項託管自訂主機名稱的 DNS 記錄:
其他任何公開 DNS 名稱伺服器
建立 VM 之後,就不能變更自訂主機名稱。
- 主機名稱至少包含兩個標籤,說明如下:
- 每個標籤都包含規則運算式,且只包含以下字元:
[a-z]([-a-z0-9]*[a-z0-9])?
。 - 標籤會以半形句號串連。
- 每個標籤的長度介於 1 到 63 個字元之間。
- 每個標籤都包含規則運算式,且只包含以下字元:
- 主機名稱長度不超過 253 個字元。
前往 Google Cloud 控制台的「Create an instance」(建立執行個體) 頁面。
指定 VM 的「Name」(名稱)。詳情請參閱資源命名慣例。
展開「Advanced options」(進階選項) 區段,然後執行下列操作:
- 展開「Networking」(網路) 區段。
- 在「Hostname」(主機名稱) 欄位中,指定自訂主機名稱。
視需要進一步自訂 VM。
如要建立並啟動 VM,請按一下 [Create] (建立)。
VM_NAME
:VM 的名稱HOST_NAME
:您要指派的完整網域主機名稱- 前往 Google Cloud 控制台的「VM instances」(VM 執行個體) 頁面。
- 點選「建立執行個體」。
- 指定所需參數。
- 按一下頁面頂端或底部的「對等程式碼」,然後點選「Terraform」分頁標籤,即可查看 Terraform 程式碼。
如要查看 VM 的自訂主機名稱,請前往「VM instances」(VM 執行個體) 頁面。
按一下執行個體名稱,開啟「VM instance details」(VM 執行個體詳細資料) 頁面。
查看「Hostname」(主機名稱) 部分。只有在設定自訂主機名稱時,才會顯示「主機名稱」欄位。
Terraform
如要在本機開發環境中使用本頁的 Terraform 範例,請安裝並初始化 gcloud CLI,然後使用使用者憑證設定應用程式預設憑證。
詳情請參閱 Set up authentication for a local development environment。
Go
如要在本機開發環境中使用本頁的 Go 範例,請安裝並初始化 gcloud CLI,然後使用使用者憑證設定應用程式預設憑證。
詳情請參閱 Set up authentication for a local development environment。
Java
如要在本機開發環境中使用本頁的 Java 範例,請安裝並初始化 gcloud CLI,然後使用使用者憑證設定應用程式預設憑證。
詳情請參閱 Set up authentication for a local development environment。
Node.js
如要在本機開發環境中使用本頁的 Node.js 範例,請安裝並初始化 gcloud CLI,然後使用使用者憑證設定應用程式預設憑證。
詳情請參閱 Set up authentication for a local development environment。
Python
如要在本機開發環境中使用本頁的 Python 範例,請安裝並初始化 gcloud CLI,然後使用使用者憑證設定應用程式預設憑證。
詳情請參閱 Set up authentication for a local development environment。
REST
如要在本機開發環境中使用本頁的 REST API 範例,請使用您提供給 gcloud CLI 的憑證。
After installing the Google Cloud CLI, initialize it by running the following command:
gcloud init
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
詳情請參閱 Google Cloud 驗證說明文件中的「Authenticate for using REST」。
必要的角色
如要取得建立自訂主機名稱 VM 所需的權限,請要求管理員授予您專案的Compute 執行個體管理員 (v1) (
roles/compute.instanceAdmin.v1
) 身分與存取權管理角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和機構的存取權」。這個預先定義的角色具備使用自訂主機名稱建立 VM 所需的權限。如要查看確切的必要權限,請展開「必要權限」部分:
所需權限
如要使用自訂主機名稱建立 VM,必須具備下列權限:
限制
支援的作業系統
自訂主機名稱是在客體環境中,使用與客體網路軟體整合的掛鉤指令碼設定。如果 Linux 作業系統沒有與客體網路軟體整合的指令碼,可能就無法取得正確的主機名稱。
如需支援自訂主機名稱的作業系統版本完整清單,請參閱「作業系統詳細資料」中的客體環境支援資訊。
命名慣例
自訂主機名稱必須符合 RFC 1035 要求,才算是有效主機名稱。為符合這些規定,自訂主機名稱必須符合下列格式規格:
無效:包含單一標籤
my-host1234
有效:包含以半形句號串連的三個標籤
my-host1234.example.com
使用自訂主機名稱建立 VM
主控台
下一步:設定 DNS 記錄。詳情請參閱「管理記錄」。
gcloud
使用 Google Cloud CLI,按照操作說明透過映像檔建立執行個體或透過快照建立執行個體,新增
--hostname
旗標,然後使用gcloud compute instances create
指令,如下所示:gcloud compute instances create VM_NAME \ --hostname=HOST_NAME
更改下列內容:
舉例來說,如要建立名為
myinstance
的 VM,並使用test.example.com
做為自訂主機名稱,請執行下列指令:gcloud compute instances create myinstance \ --hostname=test.example.com
下一步:設定 DNS 記錄。詳情請參閱「管理記錄」。
Terraform
您可以使用 Terraform 資源,透過
如要產生 Terraform 程式碼,可以使用 Google Cloud 控制台中的「對等程式碼」元件。hostname
引數建立具有自訂主機名稱的執行個體。下一步:設定 DNS 記錄。詳情請參閱「管理記錄」。
Go
Java
Node.js
Python
REST
按照 API 操作說明透過映像檔或快照來建立執行個體,並在要求主體中指定
hostname
欄位。POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances { "name": "VM_NAME", "hostname": "HOST_NAME", ... }
更改下列內容:
驗證自訂主機名稱
如果是 Linux VM,您可以在 VM 上執行
hostname -f
指令來驗證主機名稱。您也可以使用 Google Cloud 控制台或 Google Cloud CLI 驗證自訂主機名稱。
主控台
gcloud
如要使用
gcloud compute
查看 VM 的自訂主機名稱,請使用具有--format
旗標的instances describe
子指令來篩選輸出。將VM_NAME
替換為 VM 名稱。gcloud compute instances describe VM_NAME \ --format='get(hostname)'
舉例來說,如要查看名為
myinstance
的 VM 自訂主機名稱,請執行以下指令。gcloud compute instances describe myinstance \ --format='get(hostname)'
輸出內容可能如下所示:
test.example.com
如果未設定自訂主機名稱,這項指令的輸出內容會是空白。
後續步驟
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-09 (世界標準時間)。
-