A simple comment system with backend support fork from Valine.

中文 README

Documatation

English | 简体中文

Feature

Fast
Really Safe
Support full markdown syntax
Simple and lightweight
Deploy free!
Multiple deployment and storage service support, at least 84 deployment choice!

	Waline
Client	Server	Storage
@waline/client	Vercel	LeanCloud
MiniValine	Deta	CloudBase
	CloudBase	MongoDB
	Railway	MySQL
	Render	SQLite
	Docker	PostgreSQL
	self host	GitHub
		Deta Base

Todo

from https://github.com/walinejs/waline

------------------------------------------------

将 Waline 从 LeanCloud 迁移到 MongoDB Cloud

前言

从 Hexo 时代开始，我的 Waline 就是托管在 Vercel 的，而数据存储使用的是 LeanCloud 国际版。这也是 Waline 官方最推荐的部署方式。虽然简单，但是时间长了 Waline 的速度必然会受制于 LeanCloud。

我自己后来翻文章、回复评论的时候也发现加载速度上的一些问题，便决定切换数据库，从 LeanCloud 迁出来优化评论区的性能。

过程

配置数据库与 Waline

首先，我在 MongoDB Cloud 上创建了一个位于中国香港地域的 Azure 免费的 M0 数据库，存储空间大小是 512 MB，对 Waline 来说可谓绰绰有余了。如果不够了，以后再迁到 5 GB 免费的 TiDB 也可以。

创建好以后，在 “Network Access” 页面放行所有 IP 的访问请求，然后复制一下 SRV 格式的连接串。在 Navicat 里使用连接串连接到 MongoDB 之后创建一个名为 waline 的数据库，记好名字备用。

打开部署在 Vercel 上的 Waline 项目，转到环境变量设置，删除原有的 LeanCloud 相关配置项，然后依照 Waline 的文档填写好 MongoDB 的连接信息。这里有一点需要注意：MongoDB Cloud 的 M0 数据库是没有集群信息的，如果设置了错误的 MONGO_REPLICASET，会导致 Waline 在获取评论信息时出现 500 连接超时错误。我当时迁移的时候就是卡在了这里，后来搜索到了 Waline 仓库里的一个 Issue 才知道这个问题。

多机连接信息可以在这里找到：

选择 Drivers 作为连接方式，Driver 为 Node.js，Version 为 2.2.12 or later.

其中形似黄色荧光笔勾住的部分即是多机连接信息，不要带端口号，按照 Waline 文档内的格式将其依次填入环境变量。

注意

你的 Vercel 项目的地域也需要设置在与数据库所在地域相同的地域或者尽可能靠近，否则速度会大打折扣！

备份与恢复数据

配置好之后，先去 Waline 管理后台“导入导出”页面导出所有数据，如果一段时间后浏览器没有自动下载导出的 JSON，很可能是因为 Vercel 的无服务器函数超时了，此时尝试再执行一次导出操作应该就能导出了。

导出的是标准的 JSON，包含了所有的评论与注册用户的信息。将其留下来，不要删除，然后在 Vercel 上重新部署一次 Waline。部署完成之后访问管理页面，重新注册账号或者使用 OAuth 注册账号。登录之后，再在“导入导出”页面执行一次导入操作，然后选中此前导出的包含 Waline 所有数据的 JSON 文件，Waline 就会开始自动进行导入与索引建立操作了。

这里建议打开浏览器的 DevTools，切换到“网络”面板，这样在一定程度上可以判断 Waline 的导入操作是否正常进行。如果导入突然停止并且管理页面的进度指示没有走完就消失掉的话，多半是 Vercel 的无服务器函数超时了（Hobby 计划的每个 Vercel 无服务器函数最长只能持续运行 10 秒，否则会超时并返回 504 错误）。这时候不管怎么样，重新执行一次导入操作，应该就可以了。

这里我并没有遇到导入失败的情况，只能提供一个这样的解决方案了。

导入完成之后，应该就一切正常了。退出评论区的登录状态，用原来 LeanCloud 作为数据库时 Waline 的账号密码进行登录即可。之后多翻翻博客的每一篇文章，你会发现评论的加载速度有了极大提升。到演示页面测试一下评论，也会发现相比 LeanCloud 有了极大提升。

其他优化

MongoDB 有一个“索引”功能，能够在一定程度上加快读取大的集合时数据库的响应速度。因此，为一些太大的集合设置索引能够提升 Waline 的响应速度。

这些大体量的集合通常是页面浏览量和评论信息（Counter 和 Comment 集合），因此为它们设置索引即可。

参考

Hexo去LeanCloud依赖 | Finisky Garden

坑

后来有一次我发现几乎所有注册用户的绿色小对勾标志都没有了，看着很膈应。

然后一翻数据库，好家伙，几乎所有评论都有一个空的 user_id 字段。我打开 User 表一对比，才知道这里的 user_id 字段其实就是 MongoDB 中每条数据最前面的 id。这下好了，得重新为之前的评论设置用户信息字段了。

因为我没有什么编写脚本的经验，所以这一切操作都是在 Navicat 里手动进行的。就，挺累的……

人生在世，看得透，又看得远者prevail everywhere. v.gd/YLHADG v.gd/cRqvfD v.gd/sRm3tA

Total Pageviews

Wednesday, 13 July 2022

waline