discourse/postgres

Discourse PostgreSQL 镜像文档

概述

Discourse PostgreSQL镜像是专为Discourse论坛软件设计的数据库服务镜像，基于官方PostgreSQL镜像优化，预配置了Discourse运行所需的数据库参数、权限设置和兼容性配置。该镜像旨在简化Discourse部署流程，减少数据库环境配置的复杂性，确保Discourse与PostgreSQL之间的稳定交互。

核心功能和特性

• 预配置兼容性：内置Discourse推荐的PostgreSQL配置参数（如连接池大小、缓存设置等），无需手动调整即可满足Discourse运行要求。
• 官方镜像基础：基于最新稳定版PostgreSQL官方镜像构建，继承其安全性和可靠性。
• 数据持久化支持：支持通过Docker数据卷挂载实现数据库数据持久化，避免容器重启导致数据丢失。
• 安全配置：默认启用数据库用户认证，支持通过环境变量自定义管理员账户和密码。
• 轻量级优化：去除不必要的组件，保持镜像精简，降低资源占用。

使用场景和适用范围

• Discourse开发环境：为本地开发或测试Discourse提供独立的数据库服务，避免影响本地PostgreSQL实例。
• Discourse生产部署：作为生产环境中Discourse论坛的后端数据库，配合Docker Compose实现多容器协同部署。
• 小型社区论坛：适用于中小型Discourse论坛（用户规模≤10,000）的数据库服务需求。

使用方法和配置说明

基本使用（Docker Run）

通过以下命令启动Discourse PostgreSQL容器，挂载数据卷并设置基本认证信息：

bash
docker run -d \
  --name discourse-postgres \
  -e POSTGRES_USER=discourse \
  -e POSTGRES_PASSWORD=your_secure_password \
  -e POSTGRES_DB=discourse \
  -v discourse-postgres-data:/var/lib/postgresql/data \
  discourse/discourse-postgres:latest

关键参数说明

Docker Compose配置示例

在Discourse部署中，通常与其他服务（如Discourse应用、Redis）配合使用，以下是docker-compose.yml片段：

yaml
version: '3'

services:
  postgres:
    image: discourse/discourse-postgres:latest
    container_name: discourse-postgres
    environment:
      - POSTGRES_USER=discourse
      - POSTGRES_PASSWORD=${DB_PASSWORD}  # 建议通过.env文件传入
      - POSTGRES_DB=discourse
    volumes:
      - discourse-postgres-data:/var/lib/postgresql/data
    restart: unless-stopped
    networks:
      - discourse-network

volumes:
  discourse-postgres-data:

networks:
  discourse-network:

数据备份与恢复

备份数据库数据

通过docker exec执行PostgreSQL备份命令：

bash
docker exec discourse-postgres pg_dump -U discourse discourse > discourse_backup_$(date +%Y%m%d).sql

恢复数据库数据

将备份文件导入容器内数据库：

bash
cat discourse_backup.sql | docker exec -i discourse-postgres psql -U discourse discourse

注意事项

• 版本匹配：需确保镜像版本与Discourse要求的PostgreSQL版本兼容（Discourse官方推荐PostgreSQL 13+）。
• 资源配置：生产环境建议为容器分配至少1GB内存，避免因内存不足导致数据库性能下降。
• 安全加固：生产环境中应避免使用默认密码，建议通过Docker Secrets或环境变量文件管理敏感信息，限制容器网络访问权限。

详细配置和更新说明请参考官方仓库：https://github.com/discourse/discourse-postgres