Isso评论系统快速入门指南

Isso评论系统快速入门指南

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

前言

Isso是一款轻量级的自托管评论系统，可以作为Disqus等第三方评论服务的替代方案。本文将带你快速了解Isso的基本配置和使用方法，帮助你快速搭建自己的评论系统。

配置基础设置

Isso的核心配置主要涉及两个关键参数：

1. 数据库路径(dbpath)：指定评论数据的存储位置
2. 主机地址(host)：设置允许使用评论系统的网站域名

典型配置示例如下：

[general]
dbpath = /var/lib/isso/comments.db
host = 
    http://example.tld/
    http://localhost:1234/
    https://example.tld/

重要说明：

• 数据库文件会自动创建，但需确保运行Isso的用户有读写权限
• 可以配置多个域名，但不支持通配符
• 不同网站需要独立配置，不能共享同一配置

评论审核设置

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

[moderation]
enabled = true

审核方式有两种：

1. 通过日志查看审核链接
2. 配置SMTP接收审核邮件

SMTP配置示例：

[general]
notify = smtp

[smtp]
username = your_email@example.com
password = your_password
host = smtp.example.com
port = 587
security = starttls
to = admin@example.com
from = isso@example.com

数据迁移

Isso支持从Disqus和WordPress导入评论数据：

Disqus迁移步骤

1. 登录Disqus后台
2. 进入"Discussions"部分
3. 选择"Export"标签导出数据

WordPress迁移步骤

1. 进入WordPress后台的"Tools"菜单
2. 导出数据
3. 建议使用xmllint检查导出的XML文件是否有效

导入命令示例：

isso -c /path/to/isso.cfg import -t disqus disqus-export.xml

运行Isso服务

启动Isso服务非常简单：

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

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

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;
    }
}

网站集成

将Isso集成到网站只需添加以下代码：

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

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

注意事项：

• data-isso属性是可选的，但在使用异步加载脚本时建议保留
• 确保脚本URL与Nginx配置的域名一致

进阶配置

完成基础设置后，你还可以探索更多高级功能：

• 服务器端配置选项
• 客户端自定义样式
• 自动启动脚本
• 高级部署方案

结语

通过本文，你应该已经掌握了Isso评论系统的基本使用方法。从配置到部署，再到网站集成，Isso提供了一套完整的自托管评论解决方案。如需了解更多细节，建议查阅官方完整文档，探索更多个性化配置选项。

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