Valine

category
tags
type
status
slug
date
password
Last edited time
Jan 31, 2024 08:15 AM
summary
icon

关于

Valine和Waline都是支持云函数部署的快速、简洁的评论系统,理论上支持但不限于静态博客。
其中Waline 是从 Valine 衍生的带后端评论系统,可以看作是Valine的升级版,具备更多Valine不支持的功能,两者的数据结构是可以兼容的,你甚至可以同时安装Valine和Waline,两者的评论互通。
notion image
本文主要介绍LeanCloud+Vercel的部署方案教程;另外,您也可以下面这篇Zeabur方案的部署教程,体验也很方便顺滑:
Zeabur 是一个帮助开发者们可以一键部署自己的服务的平台。整体和 Railway 比较类似,但是比它多了更多的功能,不需要绑定信用卡,免费额度也要比它高。
 

1. 注册LeanCloud

两个插件均要借助LeanCloud提供的云函数,云数据存储等功能,对于普通开发者来说免费版已经足够使用。
😀
若您使用的是Zeabur的部署方案,则不需要额外注册一个LeanCloud。

获取APP ID 和 APP Key

1.请先登录注册 LeanCloud, 进入控制台后点击左下角创建应用
notion image
2.进入刚刚创建的应用,选择左下角的设置>应用Key,查看你的APP IDAPP Key
notion image

2.NotionNext中配置VALINE

获取上述的appIdappKey等参数后,就可以直接在NotionNext(版本≥3.3.9)中激活valine了,如果不想使用Valine可以直接跳到文章下一节《Waline部署》部分。
在NotionNext的Vercel环境变量中配置以下内容:
字段名
说明
是否必填
NEXT_PUBLIC_VALINE_ID
你的AppId
NEXT_PUBLIC_VALINE_KEY
你的App秘钥
NEXT_PUBLIC_VALINE_SERVER_URLS
服务地址,说明文档
选填
NEXT_PUBLIC_VALINE_PLACEHOLDER
评论框占位信息
选填,默认”抢个沙发吧”
环境变量配置示例:
notion image
notion image
 
NEXT_PUBLIC_VALINE_SERVER_URLS 说明
此参数选填,在应用内部会尝试自动获取,如果发现获取失败,请手动提供配置,配置方法:
在LeanCloud刚创建的应用中,选择左下角的设置>应用Key,找到Request 域名 第一行: 注意,需要手动在域名前加上 https:// 否则会无法访问valine评论。
notion image
💡
完成配置后重新部署一下Vercel项目即可生效。

其它可选的Valine配置

安全域名(可选) 点击展开
leanCloud支持设置自己的安全域名,设置后,仅列表中配置的域名才可以访问你的服务。例如我只在博客中用到valine服务,那么我的安全域名只需要配置为 https://tangly1024.com。
notion image
部署valine后台(可选)点击展开
valine没有自带后台,可以借助 Valine-Admin 几分钟就可以部署一个管理后台,支持行评论的查看、删除,以及邮件通知,垃圾评论过滤等功能。部署方式不在此文赘述,可以请参阅 官方文档中的“云引擎一键部署”部分.
 

Q&A

  1. 博客底部没有显示评论
      • 可能是NotionNext版本不是最新,请更新项目;
      • 可能是Vercel后台没有配置Valine/Waline的环境变量,配置后需要redeploy
  1. 评论出现 ‘Unexpected end of JSON input’
    1. 配置的Waline地址有误,检查一下,参考此issue的回答
  1. 评论出现错误提示 ‘fail to fetch’ 或者 ‘Network Error’
    1. 可能是Vercel部署的Waline出现了跨域网络限制,按F12打开控制台,查看是否有打印“缺少CORS头“,相关的错误提示。
      解决办法:换DETA部署试一下。
 

更多

最新版本已经支持Twikoo评论插件,欢迎体验
其他评论部署方式参考
 
GitalkWaline
  • Twikoo
  • Giscus
  • Cusdis