将Waline从LeanCloud迁移到MongoDB

LeanCloud 突然发了一条通知说是准备明年停止对外提供服务

而老苏博客的评论系统 Waline 就使用了 LeanCloud 作为评论的存储服务

虽然还有时间,老苏还是赶紧花时间研究了一下,当你看到本文时,说明已成功完成了迁移

数据迁移

可能是因为数据量大,反正 Waline 后台的 导出 从来没成功过

估计应该是超时了,所以只能从数据库的源头想办法

数据导出

LeanCloud 存储结构化数据提供了多种导出机制。通过控制台前往 数据存储 --> 导入导出 ,您可以分别进行 数据导出 和 备份导出。其中:

  • 数据导出:支持按时间范围筛选,它提供了 JSON 格式的导出文件;
  • 备份导出:则提供的是当日凌晨数据库备份的 BSON 格式的文件,它可用于 mongorestore 直接导入 MongoDB 数据库。

老苏选择了 备份导出,因为准备后续使用 MongoDB

LeanCloud 导出成功后,会通过邮件发送导出结果

收到邮件后

逐个下载即可

以 _ 开头的应该用不上

注册 MongoDB

Waline 支持多种数据库,包括 MySQL,PostgreSQL,SQLite 以及 MongoDB

而 https://mongodb.com 官网免费提供了 512M 的 MongoDB 数据库支持,对于 Waline 来说绰绰有余

注册 MongoDB 地址: https://www.mongodb.com

注册成功后,需要获取连接方式

还有一种更简单的创建数据库的办法,就是在 vercel 面板中 --> Storage --> Create a database --> MongoDB Atlas,可以不用考虑连接和安全性设置

  • 进入 Driver 模式

会获得下面这种 mongodb+srv格式的 URI

bash 复制代码
mongodb+srv://<db_user>:<db_password>@cluster0.sfhc25j.mongodb.net/?appName=Cluster0

可用于 Navicat 连接管理

但 AI 不建议老苏使用 Standalone 类型,让选择 Replica Set,都是可以连通的

而 Waline 使用的包比较旧,并不支持 mongod+srv 协议,只能使用 mongodb

  • 进入 Compass 模式,版本选中 1.11 or earlier

会获得下面这种 mongodb格式的 URI

uri 复制代码
mongodb://<db_user>:<db_password>@ac-ytvhtf1-shard-00-00.sfhc25j.mongodb.net:27017,ac-ytvhtf1-shard-00-01.sfhc25j.mongodb.net:27017,ac-ytvhtf1-shard-00-02.sfhc25j.mongodb.net:27017/?replicaSet=atlas-6swbtq-shard-0&ssl=true&authSource=admin

恢复数据

现在我们开始恢复从 LeanCloud 导出的 bson.gz 数据库

访问 MongoDB 官方的 Database Tools 下载页面:
https://www.mongodb.com/try/download/database-tools

然后在命令行执行下面的命令

bash 复制代码
mongorestore --uri "mongodb+srv://<db_user>:<db_password>@cluster0.sfhc25j.mongodb.net/?appName=Cluster0" --db
     waline --dir "C:\Users\Administrator\Downloads\leancloud\2026.01.16" --gzip --drop

Navicat 中查看

需要重新命名一下

测试验证

老苏为了保险起见,并没有直接修改 Vercel 部署的 Waline,而是先验证了连接 MongoDB 的环境变量

有两个选择,一个是基于 docker 在局域网中部署 Waline,另一种是在 Vercel 上部署另一个 Waline 实例

如果是从 Vercel 的 Storage 中创建的 MongoDB Atlas 数据库,下面的两个步骤是不需要的

环境变量

环境变量名称 必填 默认值 备注
MONGO_DB ✅ MongoDB 数据库名称
MONGO_USER ✅ MongoDB 服务的用户名
MONGO_PASSWORD ✅ MongoDB 服务的密码
MONGO_HOST 127.0.0.1 MongoDB 服务的地址,支持数组格式
MONGO_PORT 27017 MongoDB 服务的端口,支持数组格式
MONGO_REPLICASET MongoDB 集群
MONGO_AUTHSOURCE MongoDB 认证源
MONGO_OPT_SSL false 是否使用 SSL 进行连接

下面是根据 mongodb格式的 URI 生成的示例

ini 复制代码
MONGO_DB = waline # 
MONGO_USER = <db_user> 
MONGO_PASSWORD = <db_password> 
MONGO_HOST = ["ac-ytvhtf1-shard-00-00.sfhc25j.mongodb.net","ac-ytvhtf1-shard-00-01.sfhc25j.mongodb.net","ac-ytvhtf1-shard-00-02.sfhc25j.mongodb.net"] # MongoDB 主机名 
MONGO_PORT = [27017,27017,27017] 
MONGO_REPLICASET = atlas-6swbtq-shard-0 
MONGO_AUTHSOURCE = admin  
MONGO_OPT_SSL = true 

安全性

因为是从 Vercel 上访问,所以还需要在 MongoDB 的 Security Quickstart 中,放行 IP 地址 0.0.0.0/0

否则会导致 Waline 登录失败,从网页调试工具,应该会看到错误:Failed to load resource: the server responded with a status of 500 ()

迁移指引

以上测试都通过后,就可以开始对 Vercel 上 Waline 做最后的改动了

  1. 删除与 LeanCloud 相关的三个参数 LEAN_MASTER_KEY、LEAN_KEY、LEAN_ID;
  2. 新增 8 个 MONGO_ 开头的环境变量;
  3. 其他的环境变量保持不变;

目前遗留问题就是 热榜 还依赖 LeanCloud ,还有将近一年时间,总会解决的

参考文档

多数据库服务支持 | Waline

地址:https://waline.js.org/guide/database.html#mongodb
服务端环境变量 | Waline

地址:https://waline.js.org/reference/server/env.html#数据库

相关推荐
正在走向自律25 分钟前
MySQL兼容性深度实践:建表、增删改查与迁移避坑全记录
数据库·sql·mysql·信创·数据库迁移
隔窗听雨眠1 小时前
openGauss开源五年的内核演进与生态工程
数据库·opengauss·国产数据库
Decay__1 小时前
PostgreSQL 体系架构全解 —— 进程模型、共享内存、MVCC 与 WAL 预写日志深入
运维·数据库·sql·mysql·架构
沐知全栈开发3 小时前
基于ClinicalTrials公开数据的临床试验分析系统-毕业设计
数据库·课程设计
半杯咖啡半行码3 小时前
Qt 隐式共享(Implicit Sharing)深度解析:机制、陷阱与 Qt6迁移
开发语言·数据库·qt
Nturmoils3 小时前
空值、日期、字符串:业务 SQL 里的函数先跑一遍
数据库
倔强的石头_7 小时前
数据库选型四步法:我把候选从十几个缩到两个
数据库
bksczm21 小时前
Redis Cluster 分片集群详解:槽路由、故障判定与扩缩容
数据库·redis·分布式
黑十1 天前
FDE 怎么快速搭一个可演示页面?最小前端方案
java·大数据·前端·数据库·人工智能
Databend1 天前
OpenRaft 自定义 Membership,按部署拓扑选择 Quorum
大数据·数据库·数据分析