Waline

# 服务端配置

# 基础配置

服务端大部分的配置是通过环境变量进行配置的，如果是在 Vercel 的话可以在 Settings - Environment Variables 中进行设置。设置完毕之后需要进行重新部署才能生效。

环境变量名称 必填 备注
LEAN_ID ✓ LeanCloud 应用的 App ID
LEAN_KEY ✓ LeanCloud 应用的 App Key
LEAN_MASTER_KEY ✓ LeanCloud 应用的 Master Key 用于后台修改数据
LEAN_SERVER LeanCloud 服务地址，国内版用户需要配置此项
SITE_NAME 博客名称
SITE_URL 博客地址
IPQPS 基于IP的评论发布频率限制，单位为秒。默认为60秒，设置为0不限制
SECURE_DOMAINS 安全域名配置，支持逗号分隔配置多个域名
DISABLE_USERAGENT 是否隐藏评论者的 UA，默认为否
AKISMET_KEY Akismet 反垃圾评论服务 Key（默认开启，不用请设置为false）
COMMENT_AUDIT 评论发布审核开关，配置后建议在 Placehoder 上提供文案提示

除了以上这些环境变量之外，不同的功能也会有很多环境变量配置，具体可在左侧列进度对应的功能项进行查看。

# 代码配置

除了环境变量，我们还支持一些项目代码配置。

# secureDomains

安全域名配置，配置后非该域名来源的请求会返回 403 状态码。支持字符串、正则、数组类型，不配置表示允许所有域名来源。

//index.js
const Waline = require('@waline/vercel');

module.exports = Waline({
  secureDomains: 'waline.js.org'
});

为了方便本地开发，localhost 和 127.0.0.1 会被默认添加到安全域名列表中。当存在该配置时，环境变量 SECURE_DOMAINS 不生效。
腾讯云开发需要同时在 环境 -> 安全配置 -> WEB 安全域名 中配置安全域名

# forbiddenWords

违禁词配置，包含违禁词的内容会直接标记为垃圾评论。

//index.js
const Waline = require('@waline/vercel');

module.exports = Waline({
  forbiddenWords: [
    '习近平',
    '毛泽东'
  ]
});

# disallowIPList

IP 禁止名单配置，命中名单中的 IP 会直接返回 403 错误

//index.js
const Waline = require('@waline/vercel');

module.exports = Waline({
  disallowIPList: [
    '8.8.8.8',
    '4.4.4.4'
  ]
});

# 评论 Hooks

除了环境变量配置之外，Waline 还提供了一些自定义钩子，方便大家有自定义需求进行处理，只需要在服务端入口文件 index.js 中进行配置即可。

# preSave(comment)

发布评论前执行的操作。传入评论数据，如果该方法返回内容，则接口会直接返回，不存储评论数据。

//index.js
const Waline = require('@waline/vercel');

module.exports = Waline({
  async preSave(comment) {
    const isSapm = await Akismet.check(comment);
    if(isSpam) {
      return { errmsg: 'It\'s a spam!' };
    }
  }
});

# postSave(comment, pComment)

评论发布后执行的操作。方法执行时会传入评论数据，如果是回复评论的话还会传入父级评论。


//index.js
const Waline = require('@waline/vercel');

module.exports = Waline({
  async postSave(comment, pComment) {
    await mailto({
      mail: pComment.mail,
      text: `${comment.nick} replied your comment!`
    });
  }
});

# preUpdate(comment)

评论内容在后台被更新前执行的操作。如果该方法返回内容，则接口会直接返回，不更新评论数据。

//index.js
const Waline = require('@waline/vercel');

module.exports = Waline({
  async preUpdate(comment) {
    return 'Then you can\'t update comment data';
  }
});

# afterUpdate(comment)

评论内容在后台被更新后执行的操作。方法执行时会传入评论数据。


//index.js
const Waline = require('@waline/vercel');

module.exports = Waline({
  async postUpdate(comment) {
    console.log(`comment ${comment.objectId} has been updated!`);
  }
});

# preDelete(commentId)

评论被删除前执行的操作，方法执行时会传入需要操作的评论 Id。如果该方法返回内容，则接口会直接返回，不更新评论数据。

//index.js
const Waline = require('@waline/vercel');

module.exports = Waline({
  async preDelete(commentId) {
    return 'Then you can\'t delete comment';
  }
});

# afterDelete(commentId)

评论被删除后执行的操作，方法执行时会传入需要操作的评论 Id。

//index.js
const Waline = require('@waline/vercel');

module.exports = Waline({
  async postDelete(commentId) {
    console.log(`comment ${commentId} has been deleted!`);
  }
});

← 评论通知 →