一劳永逸，搭建ISSO开源评论系统全攻略教程

# for Debian/Ubuntu
sudo apt-get install python-setuptools python-virtualenv
# Fedora/Red Hat
sudo yum install python-setuptools python-virtualenv

#安装到根Python目录
#Debian /usr/local/lib/python2.7/dist-packages
pip install isso

#安装到指定目录
source /opt/isso/bin/activate
pip install isso

;;;;;;;;;;;;;;;;
;基础设置
;;;;;;;;;;;;;;;;
[general]
;储存评论的SQLite数据库文件
dbpath = /home/comments.db
;允许使用的网站
host =
    <http://www.hscbook.com/>
    <https://www.hscbook.com/>
;允许评论发布后多少分钟内可编辑
;0代表关闭（不建议开启）
max-age  =  0
;新评论的通知（审核）方式：smtp，stdout
;smtp是每有一条评论就通过SMTP邮件服务器发送邮件
;stdout是每有一条评论就通过SSH控制台输出
;建议使用SMTP方式，可通过邮件管理评论
notify   =  smtp
;系统日志的文件地址
log-file =  /home/ruan/isso/isso.log
;;;;;;;;;;;;;;;;
; 邮件服务器
;;;;;;;;;;;;;;;;
;SMTP邮件服务器地址
[smtp]
username = 用户名
password = 密码
host     = SMTP主机
port     = SMTP端口
;邮件编码（默认utf-8）
;encoding: utf-8
;邮件加密方式
security = ssl
;通知（审核）邮件发送到哪里
to       = mail@hscbook.com
;邮件的标题和发送地址
from     = "HscBook 评论通知" <fas@hscbook.com>
;STMP服务器的连接超时时间
timeout  = 15
;;;;;;;;;;;;;;;;
; 评论审核
;;;;;;;;;;;;;;;;
[moderation]
;打开评论审核
enabled      =  true
;最大审核时间（超过这个时间评论会自动被删除）
purge-after  =  3d
;;;;;;;;;;;;;;;;
; 评论允许使用的元素标签
;;;;;;;;;;;;;;;;
[markup]
;markup插件
options = superscript
;允许使用的HTML标签
allowed-elements = blockquote,br,code,del,em,h1,h2,h3,h4,h5,h6,hr,ins,p,pre,strong,table,tbody,thead,td,th
;允许的HTML标签属性
allowed-attributes = align
;;;;;;;;;;;;;;;;
; 简单垃圾防御
;;;;;;;;;;;;;;;;
[guard]
;是否开启
enabled         =  true
;每个IP每分钟最大评论数
ratelimit       =  2
;评论回复次数
direct-reply    =  3
;是否允许回复自己
reply-to-self   =  false
;是否必须输入名称
require-author  =  true
;是否必须输入邮箱
require-email   =  true
;;;;;;;;;;;;;;;;
; 加密KEY
;;;;;;;;;;;;;;;;
;对留言的邮箱地址进行加密
[hash]
salt       =  pdsTiOa86HkuLsa6Xsrtyfd8
algorithm  =  pbkdf2
;;;;;;;;;;;;;;;;
; 评论服务地址
;;;;;;;;;;;;;;;;
;对外服务的地址
[server]
;sock与http·二选一
;SOCK地址
;listen = unix:///tmp/isso.sock
;http地址
listen = <http://0.0.0.0:8080/>

<script data-isso="//0.0.0.0:8080/"
        data-isso-css="true"
        data-isso-lang="ru"
        data-isso-reply-to-self="false"
        data-isso-require-author="false"
        data-isso-require-email="false"
        data-isso-max-comments-top="10"
        data-isso-max-comments-nested="5"
        data-isso-reveal-on-click="5"
        data-isso-avatar="true"
        data-isso-avatar-bg="#f0f0f0"
        data-isso-avatar-fg="#9abf88 #5698c4 #e279a3 #9163b6 ..."
        data-isso-vote="true"
        data-vote-levels=""
        src="//0.0.0.0:8080/js/embed.js"></script>

<section id="isso-thread"></section>

<a href="需要显示评论数的文章地址#isso-thread">Comments</a>

#!/bin/sh
### BEGIN INIT INFO
# Provides:          isso
# Required-Start:    $local_fs $network
# Default-Start:     2 3 4 5
# Default-Stop:      0 1 6
# Description:       lightweight Disqus alternative
### END INIT INFO

EXEC=/opt/isso/bin/isso
EXEC_OPTS="-c /etc/isso.cfg run"

RUNAS=isso
PIDFILE=/var/run/isso.pid

start() {
  echo 'Starting service…' >&2
  start-stop-daemon --start --user "$RUNAS" --background --make-pidfile --pidfile $PIDFILE \\
                    --exec $EXEC -- $EXEC_OPTS
}

stop() {
  echo 'Stopping service…' >&2
  start-stop-daemon --stop --user "$RUNAS" --pidfile $PIDFILE --exec $EXEC
}

case "$1" in
  start)
    start
    ;;
  stop)
    stop
    ;;
  restart)
    stop
    start
    ;;
  *)
    echo "Usage: $0 {start|stop|restart}"
esac