zulip/zulip-postgresql

Zulip PostgreSQL 镜像文档

概述

Zulip PostgreSQL镜像是专为Zulip团队协作平台打造的数据库镜像，基于官方PostgreSQL镜像构建，针对Zulip应用的数据库需求进行了定制化配置。该镜像预配置了与Zulip兼容的数据库参数、字符集和权限设置，简化了Zulip部署过程中的数据库搭建步骤，确保Zulip应用与数据库之间的高效协同。

核心功能与特性

• Zulip兼容性优化：预配置符合Zulip要求的数据库参数（如共享缓冲区、连接数等），确保与Zulip应用无缝对接
• 基于官方镜像：继承官方PostgreSQL镜像的稳定性和安全性，同时添加Zulip专属配置
• 数据持久化支持：原生支持Docker卷挂载，确保数据库数据持久化存储
• 简化部署流程：无需手动配置数据库，可直接与Zulip应用容器联动
• 多版本支持：提供多个PostgreSQL版本标签，适配不同Zulip版本需求（如13、14等）

使用场景

• 部署自托管Zulip团队协作平台时作为后端数据库服务
• 开发/测试环境中快速搭建Zulip应用的数据库依赖
• 生产环境中为Zulip提供稳定、高性能的数据库支持

使用方法

快速启动

通过以下命令快速启动Zulip PostgreSQL容器：

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

Docker Compose 配置

推荐与Zulip应用配合使用docker-compose部署，典型配置示例：

yaml
version: '3'

services:
  db:
    image: zulip/postgres:latest
    container_name: zulip-postgres
    environment:
      - POSTGRES_USER=zulip
      - POSTGRES_PASSWORD=your_secure_password
      - POSTGRES_DB=zulip
      - POSTGRES_INITDB_ARGS=--encoding=UTF8 --lc-collate=en_US.UTF-8 --lc-ctype=en_US.UTF-8
    volumes:
      - zulip-postgres-data:/var/lib/postgresql/data
    restart: unless-stopped
    networks:
      - zulip-network

  zulip:
    image: zulip/zulip:latest
    depends_on:
      - db
    # Zulip应用配置...
    networks:
      - zulip-network

volumes:
  zulip-postgres-data:

networks:
  zulip-network:

环境变量配置

数据持久化

为避免容器重启导致数据丢失，需通过Docker卷挂载持久化存储数据库文件：

bash
# 创建命名卷（推荐）
docker volume create zulip-postgres-data

# 启动容器时挂载卷
docker run -d \
  --name zulip-postgres \
  -e POSTGRES_USER=zulip \
  -e POSTGRES_PASSWORD=your_secure_password \
  -v zulip-postgres-data:/var/lib/postgresql/data \
  zulip/postgres:latest

版本选择

镜像标签对应PostgreSQL版本，需与Zulip支持的PostgreSQL版本匹配：

• zulip/postgres:14（推荐，兼容最新Zulip版本）
• zulip/postgres:13（兼容旧版Zulip）
• zulip/postgres:latest（指向最新稳定版本）

注意事项

• 生产环境中必须设置强密码，并通过环境变量或安全方式注入，避免明文暴露
• 定期备份挂载的卷数据，防止数据丢失
• 确保Zulip应用配置中的数据库连接参数（主机、端口、用户、密码）与镜像配置一致
• 升级镜像前需确认目标版本与当前Zulip应用的兼容性