caroga/commentoplusplus

Commento++ Docker镜像文档

镜像概述

本镜像提供基于https://github.com/souramoo/commentoplusplus%E4%BB%93%E5%BA%93%E6%9E%84%E5%BB%BA%E7%9A%84Commento%E8%A1%A5%E4%B8%81%E7%89%88%E6%9C%AC%EF%BC%8C%E4%B8%BA%E7%94%A8%E6%88%B7%E6%8F%90%E4%BE%9B%E5%8D%B3%E5%BC%80%E5%8D%B3%E7%94%A8%E7%9A%84%E8%AF%84%E8%AE%BA%E7%B3%BB%E7%BB%9F%E9%83%A8%E7%BD%B2%E6%96%B9%E6%A1%88%E3%80%82%E9%95%9C%E5%83%8F%E9%80%9A%E8%BF%87GitLab Runner使用仓库自身构建文件生成，所有镜像同步自[***]

注意：Commento的所有功劳归于原软件作者及分支维护者，本镜像不承担任何使用责任。

核心功能与特性

• 基于Commento++补丁：集成Commento++的增强功能，修复原版Commento的已知问题
• 即开即用：无需手动编译，直接通过Docker部署
• PostgreSQL支持：依赖PostgreSQL数据库存储评论数据
• 环境变量配置：通过环境变量灵活配置系统参数
• GZIP压缩：支持静态资源GZIP压缩，提升加载性能

使用场景

适用于需要为网站添加评论功能的场景，包括但不限于：

• 个人博客系统
• 静态站点（如基于Jekyll、Hugo构建的网站）
• 内容管理系统（CMS）
• 各类需要用户互动评论的Web应用

使用方法

前置要求

• Docker及Docker Compose环境
• 可访问的PostgreSQL数据库（可通过Docker容器部署）

Docker Compose部署示例

以下是完整的docker-compose.yml配置示例：

yaml
version: '3.7'

services:
  commento:
    image: caroga/commentoplusplus:v1.8.6
    environment:
      COMMENTO_ORIGIN: 'https://your.domain.com'  # 评论系统访问域名
      COMMENTO_PORT: '8080'                      # 服务监听端口
      COMMENTO_POSTGRES: 'postgres://username:password@db:5432/commento?sslmode=disable'  # PostgreSQL连接字符串
      # COMMENTO_FORBID_NEW_OWNERS: 'true'       # 注册完成后可启用，禁止新管理员注册
      COMMENTO_GZIP_STATIC: 'true'               # 启用静态资源GZIP压缩
    depends_on:
      - db                                       # 依赖PostgreSQL服务
    ports:
      - "8080:8080"                              # 端口映射（主机端口:容器端口）

  db:
    image: postgres:12.5-alpine                  # PostgreSQL数据库镜像
    environment:
      POSTGRES_DB: 'commento'                    # 数据库名称
      POSTGRES_USER: 'username'                  # 数据库用户名
      POSTGRES_PASSWORD: 'password'              # 数据库密码

环境变量说明

启动步骤

1. 创建docker-compose.yml文件，配置上述参数
2. 执行命令启动服务：docker-compose up -d
3. 访问配置的COMMENTO_ORIGIN域名，完成管理员注册
4. （可选）注册完成后，在docker-compose.yml中取消COMMENTO_FORBID_NEW_OWNERS注释并重启服务，禁止新管理员注册

版本更新

由于未配置Webhook，若需要特定版本，可通过创建issue联系维护者。