借助Github Action实现通过 HTTP 请求触发邮件通知

原创已于 2025-11-03 16:17:18 修改 · 1.3k 阅读

23 ·

CC 4.0 BY-SA版权

文章标签：

#github #http #网络协议

于 2025-11-03 16:11:17 首次发布

Github Actions 同时被 3 个专栏收录

1 篇文章

订阅专栏

Github

1 篇文章

订阅专栏

Actions

1 篇文章

订阅专栏

Github仓库：Send Mail

Send Mail

通过 HTTP 请求触发 Github Actions 自动发送邮件的 workflow。可用于各种通知场景，如 IP 变更通知、任务完成提醒等。只要可以发起 HTTP 请求的地方，都可以使用此功能发送邮件通知。

如何使用

fork 本仓库到你的 Github 账号下。
在你的仓库中，进入 Settings -> Secrets and variables -> Actions，添加以下 Secrets：
- MAIL_USERNAME：SMTP 服务器用户名（通常是你的邮箱地址）
- MAIL_PASSWORD：SMTP 服务器密码（通常是授权码）
  
  名称值必填
  MAIL_USERNAME SMTP 服务器用户名（通常是你的邮箱地址）是
  MAIL_PASSWORD SMTP 服务器密码（通常是授权码）是

名称	值	必填
MAIL_USERNAME	SMTP 服务器用户名（通常是你的邮箱地址）	是
MAIL_PASSWORD	SMTP 服务器密码（通常是授权码）	是

发送http请求触发邮件发送

请求格式如下：

curl --request POST \
 --url https://api.github.com/repos/<owner>/<repo>/dispatches \
 --header 'Accept: application/vnd.github+json' \
 --header 'Authorization: <YOUR_GITHUB_TOKEN>' \
 --header 'Content-Type: application/json' \
 --data '{
           "event_type": "send_mail",
           "client_payload": {
               "to": "example@163.com",
               "subject": "📧 外部触发邮件通知",
               "template": "ip_update_template.html",
               "variables": {
                 "xx": "xx",
                 "ipv4Result": "成功",
                 "ipv4Domains": "example.com,api.example.com",
                 "ipv6Addr": "fe80::abcd",
                 "ipv6Result": "未改变",
                 "ipv6Domains": "v6.example.com",
                 "message": "来自Webhook的提醒111"
               }
           }
         }'

其中：

<owner>：你的 Github 用户名或组织名
<repo>：你的仓库名
<YOUR_GITHUB_TOKEN>：你的 Github 个人访问令牌（需要有 repo 权限）

变量名说明
<owner> 你的 Github 用户名或组织名
<repo> 你的仓库名
<YOUR_GITHUB_TOKEN> 你的 Github 个人访问令牌（需要有 repo 权限）

变量名	说明
<owner>	你的 Github 用户名或组织名
<repo>	你的仓库名
<YOUR_GITHUB_TOKEN>	你的 Github 个人访问令牌（需要有 `repo` 权限）

示例请求：

curl --request POST \
--url https://api.github.com/repos/vains-Sofia/send-mail/dispatches \
--header 'Accept: application/vnd.github+json' \
--header 'Authorization: <YOUR_GITHUB_TOKEN>' \
--header 'Content-Type: application/json' \
--data '{
          "event_type": "send_mail",
          "client_payload": {
            "to": "example@163.com",
            "subject": "📧 外部触发邮件通知",
            "template": "ip_update_template.html",
            "variables": {
              "ipv4Addr": "192.168.0.2",
              "ipv4Result": "成功",
              "ipv4Domains": "example.com,api.example.com",
              "ipv6Addr": "fe80::abcd",
              "ipv6Result": "未改变",
              "ipv6Domains": "v6.example.com",
              "message": "来自Webhook的提醒111"
              }
            }
        }'

入参说明：

event_type：固定值，必须为 send_mail

client_payload：包含邮件相关信息的对象，包含以下字段：

to：收件人邮箱地址
subject：邮件主题
template：邮件模板文件名（需预先在仓库中准备好对应的 HTML 模板文件，位于 mail-templates/ 目录下）

variables：模板变量的键值对，根据模板中的占位符进行替换

变量名	说明
event_type	固定值，必须为 `send_mail`
client_payload	包含邮件相关信息的对象
to	收件人邮箱地址
subject	邮件主题
template	邮件模板文件名（位于 mail-templates/ 目录下）
variables	模板变量的键值对，根据模板中的占位符进行替