Schnack.js数据迁移指南：从Disqus无缝过渡到自托管评论系统

【免费下载链接】schnack 🗣️ Simple self-hosted node app for Disqus-like drop-in commenting on static websites 项目地址: https://gitcode.com/gh_mirrors/sc/schnack

Schnack.js是一款轻量级自托管评论系统，提供类似Disqus的嵌入式评论功能，特别适合静态网站使用。本指南将详细介绍如何从Disqus平稳迁移到Schnack，帮助您轻松搭建属于自己的评论系统。

为什么选择从Disqus迁移到Schnack？

Disqus作为第三方评论服务，虽然方便但存在隐私和数据控制权问题。Schnack作为开源自托管解决方案，让您完全掌控评论数据，同时保持简单易用的特点。主要优势包括：

• 数据自主权：评论数据存储在您自己的服务器
• 轻量级设计：比Disqus加载速度更快
• 隐私友好：无需第三方跟踪代码
• 开源免费：完全免费使用，可自定义扩展

迁移前的准备工作

在开始迁移前，请确保您已完成以下准备：

1. 环境要求：安装Node.js (v10+)和npm
2. Disqus数据导出：从Disqus后台导出评论数据（XML格式）
3. 服务器空间：准备用于部署Schnack的服务器环境

快速安装Schnack

首先，克隆Schnack仓库并安装依赖：

git clone https://gitcode.com/gh_mirrors/sc/schnack
cd schnack
npm install

配置Schnack系统

1. 复制配置模板并修改：

   cp schnack.tpl.json schnack.json
   

2. 编辑配置文件，设置必要参数：

   • 网站URL
   • 数据库配置
   • 认证方式（支持Twitter、GitHub等）

配置示例（旧版到新版配置变化）：

旧版配置格式：

{
    "auth": {
        "twitter": {
            "consumer_key": "xxxxx",
            "consumer_secret": "xxxxx"
        }
    }
}

新版配置格式：

{
    "plugins": {
        "auth-twitter": {
            "consumer_key": "xxxxx",
            "consumer_secret": "xxxxx"
        }
    }
}

完整配置路径变更列表：

• auth.facebook → plugins.auth-facebook
• auth.github → plugins.auth-github
• auth.google → plugins.auth-google
• auth.mastodon → plugins.auth-mastodon
• auth.twitter → plugins.auth-twitter
• notify.webpush → plugins.notify-webpush
• notify.pushover → plugins.notify-pushover
• notify.sendmail → plugins.notify-sendmail
• notify.slack → plugins.notify-slack

从Disqus导入评论数据

1. 将Disqus导出的XML文件放置在项目根目录
2. 使用Schnack提供的导入工具：

   node src/importer.js disqus.xml
   

该工具会自动解析Disqus的XML格式数据，并导入到Schnack的数据库中。

数据库迁移与升级

Schnack使用SQLite数据库，并提供自动迁移功能。数据库迁移文件位于项目的migrations/目录下，包含以下版本：

• 001-initial-schema.sql
• 002-notifications.sql
• 003-replies.sql
• 004-indices.sql
• 005-unique-provider_id.sql
• 006-user-url.sql
• 007-oauth-providers.sql

系统会在启动时自动应用未执行的迁移脚本，确保数据库结构保持最新。

在网站中嵌入Schnack评论

迁移完成后，在您的网站中替换Disqus代码，添加Schnack评论框：

<div class="schnack-comments"></div>
<script src="https://your-schnack-server.com/client.js" 
        data-schnack-server="https://your-schnack-server.com"></script>

启动与维护Schnack服务

1. 启动Schnack服务：

   npm start
   

2. 设置开机自启动（推荐使用PM2）：

   npm install -g pm2
   pm2 start index.js --name "schnack"
   pm2 startup
   

常见迁移问题解决

• 评论数据丢失：确保导入前已备份Disqus数据
• 配置错误：检查schnack.json中的插件配置是否正确
• 认证问题：确认OAuth提供商的API密钥和回调URL设置正确

总结

通过本指南，您已成功将评论系统从Disqus迁移到Schnack，实现了数据自主管理和系统轻量化。Schnack不仅提供了与Disqus相当的功能，还让您完全掌控自己的评论数据，是静态网站评论系统的理想选择。

如需了解更多高级配置和插件开发，请参考项目文档和源码：

• 项目文档
• 核心源代码
• 插件系统

【免费下载链接】schnack 🗣️ Simple self-hosted node app for Disqus-like drop-in commenting on static websites 项目地址: https://gitcode.com/gh_mirrors/sc/schnack