本文基于@CCKNBC的日志@Waline 官方文档和博主自己部署时的实际情况编写如果需要最详细的配置请前往 @Waline 官方文档

评论系统特性

快速
真·安全
Markdown 语法支持
轻量易用
免费部署
多种部署方式和存储服务支持，每列选择一项多达 48 种部署方式任君选择

	Waline
客户端脚本	服务端部署	数据存储
@waline/client	Vercel	LeanCloud
MiniValine	CloudBase	CloudBase
	Docker	MongoDB
	独立部署	MySQL
		SQLite
		PostgreSQL
		Github

Todo

如果您要获得来自 Waline 群友或公子大佬的支持,可以在Github Discussions 中发布问题获取支持。当然你也可以加入 Waline 的 Telegram 小组或者是加入我们的 Waline 用户交流 QQ 群获取更多的支持。

上手

博主采用 Butterfly 主题,已经内置 Waline 评论系统

Vercel + LeanCloud

博主就使用了这种方式~~(毕竟能白嫖谁还要花钱啊?~~ 博主推荐使用LeanCloud 国际版本,如果您使用的是LeanCloud 中国版本,除了本文介绍的环境变量,还需要绑定 LeanCloud 域名配置方式: 设置 > 域名绑定 > API 访问域名绑定新域名 > 输入需要绑定的已备案域名点击确定。之后按照页面上的提示去 DNS 上做正确的 CNAME 解析即可。点击上面的 Deploy 按钮就可以快速跳转到 Vercel 部署辣如果你没有 Vercel 账号,可能提示你需要注册一个,这里不要用 QQ 邮箱因为他们会认为 QQ 邮箱是一个垃圾邮箱 PROJECT NAME 可以随便填写一个这就是项目名称,不过为了之后好辩别,还是写一个方便记住的吧输入了你的项目名称后点击 Continue 进入下一步不过可能会提示你要选择一个随便来一个就是(前提是你有对应的账号,否则老老实实选择 GitHub 进入下一步后会让你填写创建的 Git 仓库名称点击你的用户名可以显示出你账号绑定的 GitHub 账号这样就可以自定义创建的账号

下方 👇 的 Create private Git Repository 如果勾选上创建的时候就会创建一个私有仓库然后再次点击 Continue 进行下一步然后就会出现这个页面不管他,下滑找到 Environment Variables 配置环境变量默认需要的环境变量如下:

LEAN_ID
LEAN_KEY
LEAN_MASTER_KEY

它们的值分别对应上一步在 LeanCloud 中获得的 APPID APPKEY MasterKey 获取方法: 进入 LeanCloud 这边用国际版演示进入选择 Console 如果没有创建一个应用 注意 ⚠: 如果您之前用了 Valine 评论系统就不用创建了,因为 Waline 评论数据与 Valine 评论数据可以共用 进入应用设置后选择设置 -> 应用 Keys 复制并保存 Credentials 的所有配置然后把获取到的变量依次填入环境变量中设置都完成后就可以点击 Deploy 了在这里稍等一会儿就可以部署完成部署完成后在接下来的页面点击 Visit 就可以打开部署好的示例网页然后你需要注册一个账号在 Vercel 分配的域名后面加上/ui/register 第一个注册的会成为管理员哦~ 如果你想要自定义管理员头衔可以在客户端脚本中用langMode.admin配置哦例如:

function waline() {
  const Waline = require("@waline/client");
  new Waline({
    el: "#waline-comment",
    serverURL: %WALINEURL%,
    path: window.location.pathname,
    visitor: true,
    lang: location.pathname.startsWith("/en/") ? "en" : "zh-CN",
    langMode: {
      admin: location.pathname.startsWith("/en/") ? "Admin" : "Hajeekn",
    },
  });
}

按这样来说,你还可以配置访客的角标(头衔) 具体去看看Waline 文档或者@CCKNBC 当然如果你和我一样用的是 Butterfly 那么可以找到 Waline 配置项在option配置项加入配置即可

langMode: admin: Hajeekn 示例:

option:
  pageSize: 10
  ·····
  langMode:
    admin: Hajeekn

当然 Waline 现在也可以更改邮件模板只需要在环境变量内写入就行但是环境变量限制大小,推荐按照issues/106配置当然如果你的评论不是很多，并且之前配置过 Valine-Admin，那么你仍然可以使用 LeanCloud 异步发送通知

表情包配置(Butterfly)

这部分和 Valine 没多大差别,格式也可以直接复制粘贴 Valine 的只需要把名字改为 waline.json 具体可以查看主题文档

CloudBase 云开发部署

可以去看看@CCKNBC(CC)大佬写的

升级

Vercel

所需要的工具

!在这之前仓库必须公开! 安装完成后就可以删除 Waline 仓库，再 fork CC 的仓库，之后绑定到 fork 的仓库并重新部署即可

但是如果你没用腾讯云开发就把 .github/workflows/Update Waline TCB.yml 里的文件删掉，因为涉及到自动部署更新云开发，还有环境变量，如果没设定会导致报错

Tencent Cloudbase

和上面一样 Fork CC 的仓库然后新建几个变量进入你的仓库/settings/secrets/actions

变量名	变量解释
SECRETID	API 访问密钥 ID，可点击这里
新建/查看
SECRETKEY	API 访问密钥 KEY，可点击这里
新建/查看
TCBFUNNAME（没什么好加密的，就叫 waline 算了）	你想要新建/已有函数的名称，比如 `Waline`
TCBENVID	环境 ID，可点击这里

或这里查看，地址栏后也会显示，反正就是很多地方都在上面点一下就能看到 |

AD!

我的博客即将同步至腾讯云+社区，邀请大家一同入驻：https://cloud.tencent.com/developer/support-plan?invite_code=3gll8aqhc2kgg

Waline评论系统部署日志