本頁面由 Cloud Translation API 翻譯而成。

使用 SendGrid 傳送電子郵件

本教學課程說明如何使用 SendGrid，從在 Compute Engine 虛擬機器 (VM) 執行個體上執行的應用程式傳送電子郵件。

使用 Postfix 從執行個體傳送郵件

請按照以下步驟連線至 sendgrid-tutorial 執行個體，再以 Postfix 執行 SendGrid。

使用 SSH 連線至 sendgrid-tutorial 執行個體

In the Google Cloud console, go to the VM instances page.
Go to VM instances
In the list of virtual machine instances, click SSH in the row of the instance that you want to connect to.

透過 Postfix 將 SendGrid 設定為 SMTP 轉發服務

在 SSH 終端機中執行下列指令，藉以透過 Postfix 將 SendGrid 做為 SMTP 轉發使用。

成為超級使用者：
```
sudo su -
```
設定安全的 umask：
```
umask 077
```
安裝 Postfix Mail Transport Agent (Postfix 郵件傳輸代理程式)：
Debian
```
apt update && apt -y install postfix libsasl2-modules
```
CentOS
```
yum install postfix cyrus-sasl-plain cyrus-sasl-md5 -y
```
如果出現系統提示，請選取 [Local Only] (僅限本機) 設定並接受預設的網域名稱。
修改 Postfix 設定選項。打開 /etc/postfix/main.cf 進行編輯。舉例來說，如要使用 nano 文字編輯器，請輸入下列指令：
```
nano /etc/postfix/main.cf
```
更新檔案：
1. 加註下列幾行：
```
# default_transport = error
# relay_transport = error
```
2. 在檔案末尾加入下列幾行：
```
relayhost = [smtp.sendgrid.net]:2525
smtp_tls_security_level = encrypt
smtp_sasl_auth_enable = yes
smtp_sasl_password_maps = hash:/etc/postfix/sasl_passwd
header_size_limit = 4096000
smtp_sasl_security_options = noanonymous
```
  以上幾行會針對這些要求強制執行安全資料傳輸層 (SSL)/傳輸層安全標準 (TLS) 支援，並設定 SMTP 驗證。簡單存取及安全性階層 (SASL) 模組可處理 Postfix 設定中的驗證作業。
儲存並關閉檔案。
使用您在「事前準備」一節中產生的 API 金鑰，產生 SASL 密碼對應。將 your-api-key 改為您產生的 API 金鑰。
```
echo [smtp.sendgrid.net]:2525 apikey:your-api-key >> /etc/postfix/sasl_passwd
```
使用 postmap 公用程式產生 .db 檔案。
```
postmap /etc/postfix/sasl_passwd
```

確認您擁有 .db 檔案：

ls -l /etc/postfix/sasl_passwd*

-rw------- 1 root root    ...  /etc/postfix/sasl_passwd
-rw------- 1 root root    ...  /etc/postfix/sasl_passwd.db

移除內含憑證的檔案，因為現在已不需要該檔案：
```
rm /etc/postfix/sasl_passwd
```

在 .db 檔案上設定權限，並確認另一個檔案已移除：

chmod 600 /etc/postfix/sasl_passwd.db
ls -la /etc/postfix/sasl_passwd*

-rw------- 1 root root    ...  /etc/postfix/sasl_passwd.db

重新載入設定，以載入修改後的參數：
Debian
```
/etc/init.d/postfix restart
```
CentOS
```
postfix reload
```

安裝 mailutils 或 mailx 套件：

Debian

apt -y install mailutils

CentOS

yum install mailx -y

傳送測試電子郵件：
```
echo 'message' | mail -s subject email@example.com
```
更改下列內容：
- message：電子郵件內文。
- subject：電子郵件主旨。
- email@example.com：要傳送訊息的電子郵件地址。
請在系統記錄中尋找內含 status 的狀態行，以及成功的伺服器回應碼 (250)：
Debian
```
tail -n 5 /var/log/syslog
```
CentOS
```
tail -n 5 /var/log/maillog
```

在執行個體上以 Java 傳送郵件

使用 SSH 連線至 sendgrid-tutorial 執行個體

In the Google Cloud console, go to the VM instances page.
Go to VM instances
In the list of virtual machine instances, click SSH in the row of the instance that you want to connect to.

建構並傳送電子郵件

以下操作說明會使用 SendGrid Java 用戶端程式庫，透過 SendGrid 來建構和傳送電子郵件。您可在 GitHub 上檢視完整範例。

在 SSH 終端機中：

成為超級使用者並設定安全的 umask：
```
sudo su -
umask 077
```

安裝 Java 和 Maven：

apt -y update && apt -y install git-core openjdk-11-jdk maven

複製 GitHub 存放區：

git clone https://github.com/GoogleCloudPlatform/java-docs-samples.git

前往範例的主要原始碼：

cd /root/java-docs-samples/compute/sendgrid/src/main/java/com/example/compute/sendgrid

開啟 SendEmailServelet.java 進行編輯。
- 將 your-sendgrid-api-key 替換為您 SendGrid 帳戶的 API 金鑰。
- 將 your-sendgrid-from-email 替換為您要用來發送郵件的電子郵件地址。
- 將 destination-email 替換為您要傳送郵件到其中的目標電子郵件地址。

前往程式碼範例的根目錄：

cd /root/java-docs-samples/compute/sendgrid

建立 Java 類別套件：
```
mvn clean package
```
前往新的 target目錄：
```
cd target
```

設定權限，允許執行 jar 檔案：

chmod +x compute-sendgrid-1.0-SNAPSHOT-jar-with-dependencies.jar

執行替代的 Java 版本選取器：
```
update-alternatives --config java
```
選取 java-11-openjdk-amd64 選項。

執行 Java 檔案：

java -jar compute-sendgrid-1.0-SNAPSHOT-jar-with-dependencies.jar

在執行個體上透過 Node.js 傳送郵件

如要執行此範例，VM 執行個體上必須已安裝 Node.js 7.6 版或更新版本。

使用 SSH 連線至 sendgrid-tutorial 執行個體

In the Google Cloud console, go to the VM instances page.
Go to VM instances
In the list of virtual machine instances, click SSH in the row of the instance that you want to connect to.

建構並傳送電子郵件

在 SSH 終端機中：

成為超級使用者並設定安全的 umask：
```
sudo su -
umask 077
```
更新套件存放區：
Debian
```
apt update
```
CentOS
```
yum update -y
```

安裝 Node.js 依附元件：

Debian

apt -y install git-core curl build-essential openssl libssl-dev

CentOS

yum install git-core curl openssl openssl-devel -y
yum groupinstall "Development Tools" -y

安裝 Node.js。根據預設，系統在安裝過程中也會安裝 npm：

Debian

curl -sL https://deb.nodesource.com/setup_14.x | sudo bash -
sudo apt -y install nodejs

CentOS

curl --silent --location https://rpm.nodesource.com/setup_14.x | bash -

然後再安裝 Node.js：

yum -y install nodejs

安裝 SendGrid Node.js 用戶端：
```
npm install sendgrid
```

複製範例存放區：

git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples.git

前往含有 SendGrid 範例的目錄：
```
cd nodejs-docs-samples/compute
```
複製 sendgrid.js 檔案：
```
cp sendgrid.js sendmail.js
```

開啟 sendmail.js 進行編輯。

將 your-sendgrid-api-key 替換為您 SendGrid 帳戶的 API 金鑰。
將 from-email@example.com 替換為您要用來發送郵件的電子郵件地址。
將 to-email@example.com 替換為您要傳送郵件到其中的目標電子郵件地址。

// This sample is based off of:
// https://github.com/sendgrid/sendgrid-nodejs/tree/master/packages/mail
const sendgrid = require('@sendgrid/mail');
sendgrid.setApiKey(process.env.SENDGRID_API_KEY || '<your-sendgrid-api-key>');

async function sendgridExample() {
  await sendgrid.send({
    to: 'to_email@example.com',
    from: 'from_email@example.com',
    subject: 'Sendgrid test email from Node.js on Google Cloud Platform',
    text: 'Well hello! This is a Sendgrid test email from Node.js on Google Cloud Platform.',
  });
}
sendgridExample();

執行程式以透過 SendGrid 傳送電子郵件訊息：
```
node sendmail.js
```

從 Exchange Edge 傳輸伺服器傳送郵件

您可以設定外寄傳送連接器，讓 Microsoft Exchange 透過 SendGrid 傳送外寄電子郵件。詳情請參閱「在 Compute Engine 上部署 Microsoft Exchange Server 2016」。

使用 SendGrid 傳送電子郵件 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

使用 Postfix 從執行個體傳送郵件

使用 SSH 連線至 sendgrid-tutorial 執行個體

透過 Postfix 將 SendGrid 設定為 SMTP 轉發服務

Debian

CentOS

Debian

CentOS

Debian

CentOS

Debian

CentOS

在執行個體上以 Java 傳送郵件

使用 SSH 連線至 sendgrid-tutorial 執行個體

建構並傳送電子郵件

在執行個體上透過 Node.js 傳送郵件

使用 SSH 連線至 sendgrid-tutorial 執行個體

建構並傳送電子郵件

Debian

CentOS

Debian

CentOS

Debian

CentOS

從 Exchange Edge 傳輸伺服器傳送郵件

使用 SendGrid 傳送電子郵件