评论通知 | Waline
date_saved: 2024-03-24 23:40:19
date_published: 2024-02-02 11:12:10
Full Content:
迁移![](https://proxy-prod.omnivore-image-cache.app/0x0,szGbsc2PXzx1TXFlPwz-W2vq3CraSOfQOcSGBKJGme94/data:image/svg+xml,%3Csvg xmlns=‘http://www.w3.org/2000/svg’ viewBox=‘0 0 24 24’%3E%3Cpath fill=‘rgba(0,0,0,0.5)’ d=‘M7.41 15.41L12 10.83l4.59 4.58L18 14l-6-6-6 6z’/%3E%3C/svg%3E)
参考![](https://proxy-prod.omnivore-image-cache.app/0x0,szGbsc2PXzx1TXFlPwz-W2vq3CraSOfQOcSGBKJGme94/data:image/svg+xml,%3Csvg xmlns=‘http://www.w3.org/2000/svg’ viewBox=‘0 0 24 24’%3E%3Cpath fill=‘rgba(0,0,0,0.5)’ d=‘M7.41 15.41L12 10.83l4.59 4.58L18 14l-6-6-6 6z’/%3E%3C/svg%3E)
高级![](https://proxy-prod.omnivore-image-cache.app/0x0,szGbsc2PXzx1TXFlPwz-W2vq3CraSOfQOcSGBKJGme94/data:image/svg+xml,%3Csvg xmlns=‘http://www.w3.org/2000/svg’ viewBox=‘0 0 24 24’%3E%3Cpath fill=‘rgba(0,0,0,0.5)’ d=‘M7.41 15.41L12 10.83l4.59 4.58L18 14l-6-6-6 6z’/%3E%3C/svg%3E)
![](https://proxy-prod.omnivore-image-cache.app/0x0,szGbsc2PXzx1TXFlPwz-W2vq3CraSOfQOcSGBKJGme94/data:image/svg+xml,%3Csvg xmlns=‘http://www.w3.org/2000/svg’ viewBox=‘0 0 24 24’%3E%3Cpath fill=‘rgba(0,0,0,0.5)’ d=‘M7.41 15.41L12 10.83l4.59 4.58L18 14l-6-6-6 6z’/%3E%3C/svg%3E)
当网站有用户发布评论或者用户回复评论时,Waline 支持对博主和回复评论作者进行通知。
- 博主通知支持多种方式,包括 QQ、微信、邮件等。
- 当访客的评论收到回复时,我们会对访客进行邮件通知。
邮件通知
邮件通知需要配置以下环境变量:
SMTP_SERVICE
: SMTP 邮件发送服务提供商。
提示
你可以在 这里 查看所有支持的运营商。
如果你的运营商不受支持,你必须填写SMTP_HOST
和SMTP_PORT
。SMTP_HOST
: SMTP 服务器地址,一般可以在邮箱的设置中找到。SMTP_PORT
: SMTP 服务器端口,一般可以在邮箱的设置中找到。
SMTP_USER
: SMTP 邮件发送服务的用户名,一般为登录邮箱。SMTP_PASS
: SMTP 邮件发送服务的密码,一般为邮箱登录密码,部分邮箱(例如 163)是单独的 SMTP 密码。SMTP_SECURE
: 是否使用 SSL 连接 SMTP。SITE_NAME
: 网站名称,用于在消息中显示。SITE_URL
: 网站地址,用于在消息中显示。AUTHOR_EMAIL
: 博主邮箱,用来接收新评论通知。如果是博主发布的评论则不进行提醒通知。
以下是选填的环境变量:
SENDER_NAME
: 自定义发送邮件的发件人SENDER_EMAIL
: 自定义发送邮件的发件地址MAIL_SUBJECT
: 自定义评论回复邮件标题MAIL_TEMPLATE
: 自定义评论回复邮件内容MAIL_SUBJECT_ADMIN
: 自定义新评论通知邮件标题MAIL_TEMPLATE_ADMIN
: 自定义新评论通知邮件内容
微信通知
微信通知使用了 Server 酱 提供的服务,需要在环境变量中配置在 Server 酱中申请的 SC_KEY
。
SC_KEY
: Server 酱提供的 Token,必填。AUTHOR_EMAIL
: 博主邮箱,用来区分发布的评论是否是博主本身发布的。如果是博主发布的则不进行提醒通知。SITE_NAME
: 网站名称,用于在消息中显示。SITE_URL
: 网站地址,用于在消息中显示。SC_TEMPLATE
: Server酱 使用的通知模板,变量与具体格式可参见下文的通知模板。未配置则使用默认模板。
企业微信应用通知
由于 Server 酱 提供的推送服务对发送消息数量有限制,如果消息数量较多时,建议使用企业微信应用通知。
要使用企业微信应用通知,需要配置环境变量 QYWX_AM
。
第一个值是企业 id,第二个值是应用 secret,第三个值@all(或者成员 id),第四个值是 AgentID,第五个值是图片 id,中间以逗号隔开。最终格式例:
QYWX_AM
: 用于发送企业应用消息的变量,必填。AUTHOR_EMAIL
: 博主邮箱,用来区分发布的评论是否是博主本身发布的。如果是博主发布的则不进行提醒通知。SITE_NAME
: 网站名称,用于在消息中显示。SITE_URL
: 网站地址,用于在消息中显示。WX_TEMPLATE
: QYWX_AM 使用的通知模板,变量与具体格式可参见下文 QQ 的通知模板。未配置则使用默认模板。
QQ 通知
QQ 通知使用了 Qmsg 酱 提供的服务,需要在环境变量中配置在 Qmsg 酱中申请的 QMSG_KEY
。
QMSG_KEY
: Qmsg 酱提供的 KEY,必填。QMSG_Host
: Qmsg 酱提供的私有化 HOST,选填。默认为https://qmsg.zendee.cn
。QQ_ID
: 接收消息的 QQ 号 (不支持 QQ 群),可以添加多个,以半角逗号分割,如:1244453393,2952937634
(必须均在您的 Qmsg 酱 QQ 号列表中)。AUTHOR_EMAIL
: 博主邮箱,用来区分发布的评论是否是博主本身发布的。如果是博主发布的则不进行提醒通知。SITE_NAME
: 网站名称,用于在消息中显示。SITE_URL
: 网站地址,用于在消息中显示。QQ_TEMPLATE
: QQ 使用的通知模板,变量与具体格式可参见下文的通知模板。未配置则使用默认模板。
Telegram 通知
Telegram 通知通过 Telegram bot 机器人实现,需要配置以下几个环境变量:
==TG_BOT_TOKEN==
: Telegram 机器人用于访问 HTTP API 的 token,通过 ==@BotFather 创建机器人获取,必填。====TG_CHAT_ID==
: 接收消息对象的==chat_id==
,可以是单一用户、频道、群组,通过 ==@userinfobot 获取,必填。====AUTHOR_EMAIL==
: 博主邮箱,用来区分发布的评论是否是博主本身发布的。如果是博主发布的则不进行提醒通知。==SITE_NAME==
: 网站名称,用于在消息中显示。==SITE_URL==
: 网站地址,用于在消息中显示。==TG_TEMPLATE==
: Telegram 使用的通知模板,变量与具体格式可参见下文的通知模板。未配置则使用默认模板。
PushPlus 通知
pushplus 集成了微信、企业微信、钉钉、短信、邮件等渠道的信息推送平台。需要配置以下几个环境变量,具体的参数格式见 pushplus 文档:
PUSH_PLUS_KEY
: 用户令牌,即token
,必填。PUSH_PLUS_TOPIC
:群组编码,不填仅发送给自己;channel 为 webhook 时无效PUSH_PLUS_TEMPLATE
:发送模板PUSH_PLUS_CHANNEL
:发送渠道PUSH_PLUS_WEBHOOK
:webhook 编码,仅在 channel 使用 webhook 渠道和 CP 渠道时需要填写PUSH_PLUS_CALLBACKURL
:发送结果回调地址AUTHOR_EMAIL
: 博主邮箱,用来区分发布的评论是否是博主本身发布的。如果是博主发布的则不进行提醒通知。SITE_NAME
: 网站名称,用于在消息中显示。SITE_URL
: 网站地址,用于在消息中显示。
Discord 通知
Discord 通知通过 Discord Webhook 实现,需要配置以下几个环境变量:
DISCORD_WEBHOOK
:Discord Webhook 地址,如何创建 Discord Webhook?DISCORD_TEMPLATE
:发送模板AUTHOR_EMAIL
: 博主邮箱,用来区分发布的评论是否是博主本身发布的。如果是博主发布的则不进行提醒通知。SITE_NAME
: 网站名称,用于在消息中显示。SITE_URL
: 网站地址,用于在消息中显示。
飞书通知
飞书群聊机器人支持通过 Webhook 发送消息,需配置以下几个环境变量。
LARK_WEBHOOK
: 飞书群聊机器人 使用指南LARK_SECRET
: 请参考上面的飞书文档,该密钥用于请求签名以避免接口被滥用(可选)LARK_TEMPLATE
: 消息模板SITE_NAME
: 网站名称,用于在消息中显示。SITE_URL
: 网站地址,用于在消息中显示。
通知模板
Waline 支持为每个平台分别配置您自定义的通知模板,从而实现更强大的自定义能力与多语言兼容性。
支持的变量
模板通过 self
、 parent
和 site
对象传递参数,其中分别包含以下变量:
self
: 该条评论本身
| 变量 | 备注 |
| --------------- | ------ |
| nick | 评论者名 |
| mail | 评论者邮箱 |
| link | 评论者网址 |
| url | 文章地址 |
| comment | 评论内容 |
| browser | 浏览器 |
| os | 操作系统 |
| addr | 归属地 |
| avatar | 头像地址 |
| commentLink* | 评论中的链接 |
*: commentLink 仅在 Telegram 通知中提供,会自动封装成 Markdown 的格式parent
: 该条评论的回复对象(父评论)
| 变量 | 备注 |
| ------- | ----- |
| nick | 评论者名 |
| mail | 评论者邮箱 |
| link | 评论者网址 |
| browser | 浏览器 |
| os | 操作系统 |
| addr | 归属地 |
| avatar | 头像地址 |
| comment | 评论内容 |- site: 网站配置
| 变量 | 备注 |
| ------- | ------ |
| name | 站点名 |
| url | 站点网址 |
| postUrl | 评论完整地址 |
默认模板
此处附上默认的模板,方便您参考:
- QQ_TEMPLATE:
- TG_TEMPLATE:
{{self.comment-}}
{{-self.commentLink}}
_邮箱_: `{{self.mail}}`
_审核_: {{self.status}}
仅供评论预览,点击 [查看完整內容]({{site.postUrl}})
- SC_TEMPLATE:
附加说明
- Vercel 的环境变量大小限制为
4KB
,所以如果您的模板很长,请使用代码配置,参见 issue#106 ; - 变量具体信息在开发过程中可能会发生变化,此处的变量说明仅供参考,具体的内容请以具体的代码示例为准。
![](https://proxy-prod.omnivore-image-cache.app/0x0,szGbsc2PXzx1TXFlPwz-W2vq3CraSOfQOcSGBKJGme94/data:image/svg+xml,%3Csvg xmlns=‘http://www.w3.org/2000/svg’ viewBox=‘0 0 24 24’%3E%3Cpath fill=‘rgba(0,0,0,0.5)’ d=‘M7.41 15.41L12 10.83l4.59 4.58L18 14l-6-6-6 6z’/%3E%3C/svg%3E)上一页安全性下一页![](https://proxy-prod.omnivore-image-cache.app/0x0,szGbsc2PXzx1TXFlPwz-W2vq3CraSOfQOcSGBKJGme94/data:image/svg+xml,%3Csvg xmlns=‘http://www.w3.org/2000/svg’ viewBox=‘0 0 24 24’%3E%3Cpath fill=‘rgba(0,0,0,0.5)’ d=‘M7.41 15.41L12 10.83l4.59 4.58L18 14l-6-6-6 6z’/%3E%3C/svg%3E)自定义样式
Highlights
Telegram 通知通过 Telegram bot 机器人实现,需要配置以下几个环境变量:
TG_BOT_TOKEN
: Telegram 机器人用于访问 HTTP API 的 token,通过 @BotFather 创建机器人获取,必填。TG_CHAT_ID
: 接收消息对象的chat_id
,可以是单一用户、频道、群组,通过 @userinfobot 获取,必填。AUTHOR_EMAIL
: 博主邮箱,用来区分发布的评论是否是博主本身发布的。如果是博主发布的则不进行提醒通知。SITE_NAME
: 网站名称,用于在消息中显示。SITE_URL
: 网站地址,用于在消息中显示。TG_TEMPLATE
: Telegram 使用的通知模板,变量与具体格式可参见下文的通知模板。未配置则使用默认模板。 ⤴️