Isso评论系统快速入门指南-优快云博客

Isso评论系统快速入门指南

isso a Disqus alternative 项目地址: https://gitcode.com/gh_mirrors/is/isso

前言

Isso是一款轻量级的自托管评论系统，可以作为Disqus等第三方评论服务的替代方案。本文将带领你快速完成Isso的配置、部署和集成过程，让你能够在自己的网站上搭建一个功能完善的评论系统。

基础配置

Isso的核心配置文件采用INI格式，以下是最基础的配置项说明：

[general]
; 数据库文件路径，会自动创建
dbpath = /var/lib/isso/comments.db
; 你的网站地址（不是Isso的地址）
host = http://example.tld/
; 可以添加多个地址用于本地开发或SSL连接
host =
    http://localhost:1234/
    http://example.tld/
    https://example.tld/

重要提示：

单个配置不支持多个不同网站
必须设置dbpath和host参数
其他参数都有合理的默认值

评论审核设置

Isso默认情况下会直接显示评论，如需启用审核机制，需添加以下配置：

[moderation]
enabled = true

启用审核后，你可以：

通过日志中的激活或删除URL来管理评论
配置SMTP接收新评论通知（包含管理URL）

[general]
notify = smtp
[smtp]
; 这里填写SMTP服务器配置

数据迁移

Isso提供了从Disqus或WordPress导入评论的工具：

Disqus迁移步骤

登录Disqus后台
进入"Discussions"部分
选择"Export"标签页导出评论

WordPress迁移步骤

进入WordPress后台的"Tools"菜单
导出数据
使用xmllint修复可能的XML格式问题

导入命令示例：

isso -c /path/to/isso.cfg import -t [disqus|wordpress] 导出文件.xml

运行Isso服务

启动Isso非常简单：

isso -c /path/to/isso.cfg run

安全建议：不要直接将Isso暴露在公网，建议通过Nginx等反向代理提供服务。

Nginx配置示例

server {
    listen [::]:80;
    server_name comments.example.tld;

    location / {
        proxy_pass http://localhost:8080;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

网站集成

将以下代码添加到你的网页中：

<script data-isso="//comments.example.tld/"
        src="//comments.example.tld/js/embed.min.js"></script>

<section id="isso-thread">
    <noscript>请启用JavaScript以查看评论</noscript>
</section>

注意事项：