💬 使用 Commento 为 Hexo 博客添加自托管评论系统（完整教程）

本文将介绍如何使用 Docker Compose 部署 Commento 评论系统，并将其集成到 Hexo 静态博客中，实现可控、轻量、无追踪的评论功能。

📌 目录

  1. Commento 简介
  2. 为什么选择 Commento
  3. 系统架构
  4. 部署环境准备
  5. Docker Compose 部署 Commento + PostgreSQL + Caddy
  6. 配置域名和 HTTPS
  7. Hexo 集成 Commento
  8. 评论后台管理
  9. 常见问题与建议
  10. 总结

Commento 简介

Commento 是一个开源的嵌入式评论系统，可用于替代如 Disqus 等第三方服务。支持 Markdown、隐私保护、反垃圾、多站点等特性。你可以选择自托管的方式完全控制数据。

为什么选择 Commento

特性支持描述
开源✅自由修改部署
自托管✅控制全部数据
无广告✅注重隐私，无第三方追踪
支持 Markdown✅格式美观、方便书写
支持审核管理✅后台可屏蔽、删除、审批
邮件通知✅可配置 SMTP 发送通知
多站点支持✅一套服务，多站共用

系统架构

组件功能
Commento评论服务核心，运行在端口 8080
PostgreSQL存储评论数据
Caddy反向代理并自动配置 HTTPS
Hexo生成静态页面的博客系统

部署环境准备

  1. 一台云服务器（Ubuntu 20.04 或以上）
  2. 域名一枚（如 comments.example.com）并完成解析
  3. 安装 Docker 和 Docker Compose：
1
2
sudo apt update
sudo apt install docker docker-compose -y

Docker Compose 部署 Commento + PostgreSQL + Caddy

1️⃣ 创建 docker-compose.yml

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42

version: '3.8'

services:
  postgres:
    image: postgres:13
    container_name: commento-postgres
    restart: always
    environment:
      POSTGRES_USER: commento
      POSTGRES_PASSWORD: strong_password_here
      POSTGRES_DB: commento
    volumes:
      - pgdata:/var/lib/postgresql/data

  commento:
    image: registry.gitlab.com/commento/commento
    container_name: commento
    restart: always
    environment:
      COMMENTO_ORIGIN: "https://comments.example.com"
      COMMENTO_PORT: 8080
      COMMENTO_POSTGRES: "postgres://commento:strong_password_here@postgres:5432/commento?sslmode=disable"
    depends_on:
      - postgres

  caddy:
    image: caddy:2
    container_name: commento-caddy
    restart: always
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile
      - caddy_data:/data
      - caddy_config:/config

volumes:
  pgdata:
  caddy_data:
  caddy_config:

2️⃣ 创建 Caddyfile

1
2
3
4
5
6
7
8
9
10
11
comments.example.com {
  reverse_proxy commento:8080

  encode gzip
  header {
    Strict-Transport-Security "max-age=31536000; includeSubDomains; preload"
    X-Content-Type-Options "nosniff"
    X-Frame-Options "DENY"
    X-XSS-Protection "1; mode=block"
  }
}

3️⃣ 启动服务

1
docker compose up -d

配置域名和 HTTPS

将 comments.example.com 指向你的服务器 IP（A 记录）

确保服务器开放 80 和 443 端口：

1
2
3
sudo ufw allow 80
sudo ufw allow 443
Caddy 会自动申请并续签 HTTPS 证书

Hexo 集成 Commento

在你的 Hexo 博客主题中找到 layout/post.ejs 或 post.html，在页面底部插入：

1
2
<div id="commento"></div>
<script defer src="https://comments.example.com/js/commento.js"></script>

然后执行生成部署：

1
hexo clean && hexo g && hexo d

评论后台管理

访问你的 Commento 服务首页：
https://comments.example.com

  • 注册账号
  • 登录后创建站点（填写你博客的域名）
  • 管理功能：
    • 评论审核与删除
    • 用户封禁
    • 多站点切换
    • SMTP 通知配置（可选）

常见问题与建议

问题解决方案
域名访问不了检查 DNS、端口、防火墙配置
评论不显示检查域名与 COMMENTO_ORIGIN 是否一致
邮件通知失败配置 SMTP，确保端口和账号正确
页面加载太慢使用 CDN 加速博客主站，不影响评论

总结

项目技术
评论系统Commento（自托管）
部署方式Docker Compose
评论数据存储PostgreSQL
反向代理与HTTPS Caddy 自动化配置
博客平台Hexo（静态）
嵌入方法HTML 标签与 JS 脚本

Commento 是一个优雅、注重隐私的评论解决方案，适合内容创作者、技术博客、文档站点等场景。结合 Hexo 可构建完全自控的内容平台。

本文作者：Samjoe Yang

本文链接： https://need.uno/shi-yong-commento-wei-hexo-bo-ke-tian-jia-zi-tuo-guan-ping-lun-xi-tong-wan-zheng-jiao-cheng/

更新于 2025-05-28

评论

发表评论

此博客中的热门博文

AI幻觉的本质、影响与创造性价值探讨

  一、什么是 AI 幻觉？ 所谓“AI 幻觉”（AI Hallucination），是指大型语言模型在缺乏真实依据的情况下，输出 看似合理、实则虚构或错误的内容 现象。这种幻觉不是偶发 bug，而是生成式语言模型工作机制的自然副产品。 语言模型并非基于理解生成语言，而是通过庞大的文本数据学习“下一个词的概率分布”。在缺乏明确信号、上下文或训练样本不足的情况下，模型可能“编造”内容来填补知识空白，这种编造常常带有逻辑连贯性，反而增强了幻觉的“迷惑性”。 这使得幻觉区别于普通的机器错误。它不是乱码、不是崩溃，而是一种 结构完整但脱离现实 的生成输出。 二、AI 幻觉的影响 ✅ 积极影响：误差中的创造力 尽管“幻觉”在语义上往往代表偏差或错误，但在创意工作中，它却可能成为一个 具备创造潜力的副产品 。 方面 描述 创意写作 AI 虚构的角色、设定、剧情经常被作家、游戏编剧等转化为构思灵感 语义想象力 幻觉跳脱现实语义框架，为生成新概念、隐喻和诗意文本提供可能性 跨领域联想 模型会将物理与哲学、数学与神话等进行混搭，产生意想不到的组合 集体创作引子 用户识别并讨论幻觉内容，有时能触发有意义的修改与共识 测试模型边界 幻觉集中区域暴露模型盲区，为未来训练优化提供线索 深入探讨： 比如，在科学幻想小说创作中，AI 幻觉能提出从未有过的术语或科技概念，如“量子意识场”或“心灵引擎”，虽然现实中尚无根据，但正因其“荒谬”而富有灵感张力。同理，艺术创作者利用 AI 幻觉激发灵感、生成诗意文字或曲折叙事，已经成为常见的实践。 此外，幻觉也可以被设计性地“引导”，例如通过 prompt 工程让模型朝着“更富幻想”的方向生成。此时幻觉就不再是负面，而是一种被管理的想象力。 ❌ 消极影响：认知误导与信任危机 AI 幻觉也带来了广泛的风险，尤其当其被误以为是真实信息时，会产生严重的信任和认知危机。 场景 风险 高风险行业（医疗/法律/金融） 模型幻觉可能被误信为建议，导致决策失误甚至伤害 新闻与事实核查 AI 编造的“引用”或“伪文献”可能制造信息污染 教育领域 学生可能将幻觉内容误当真知，影响认知形成 AI信任危机 用户发现幻觉越多，越难区分模型“何时说真话” 深入探讨： 在医疗诊断中，如果模型胡乱推荐了不存在的治疗方案或药物名称，后果可能极其严重。同样地，幻觉生成的伪引用在学术写...
阅读全文

PHP编译安装时常见错误解决办法

http://www.poluoluo.com/jzxy/201505/364819.html This article is post on https://coderwall.com/p/ggmpfa configure: error: xslt-config not found. Please reinstall the libxslt >= 1.1.0 distribution 代码如下 : yum -y install libxslt-devel configure: error: Could not find net-snmp-config binary. Please check your net-snmp installation. 代码如下 : yum -y install net-snmp-devel configure: error: Please reinstall readline – I cannot find readline.h 代码如下 : yum -y install readline-devel configure: error: Cannot find pspell 代码如下 : yum -y install aspell-devel checking for unixODBC support… configure: error: ODBC header file ‘/usr/include/sqlext.h’ not found! 代码如下 : yum -y install unixODBC-devel configure: error: Unable to detect ICU prefix or /usr/bin/icu-config failed. Please verify ICU install prefix and make sure icu-config works. 代码如下 : yum -y install libicu-devel configure: error: utf8mime2text () has new signature , but U8TCANONICAL is missing. This should not happen. Check...
阅读全文