voxbox/postgres

PostgreSQL Docker镜像文档

概述

本Docker镜像用于创建PostgreSQL数据库的容器化部署，基于Debian Jessie系统构建。PostgreSQL是一款强调可扩展性和标准合规性的对象关系型数据库管理系统（ORDBMS）。

该镜像源自https://github.com/sameersbn/docker-postgresql%E7%9A%84%E5%88%86%E6%94%AF%EF%BC%8C%E4%B8%BB%E8%A6%81%E4%BF%AE%E6%94%B9%E5%8C%85%E6%8B%AC%EF%BC%9A

1. 基础系统从Ubuntu 14.04更换为Debian Jessie
2. 新增构建参数支持（详见安装部分）
3. 不修改原仓库的运行时脚本
4. 增强Swarm/Stack模式部署示例及运行/清理脚本（详见快速启动部分）

核心功能与特性

• 灵活配置：支持通过构建参数自定义PostgreSQL版本、用户及目录
• 标准化部署：基于Debian Jessie，确保环境一致性
• 容器编排支持：提供Swarm/Stack模式部署示例
• 数据持久化：使用命名卷存储数据（非绑定挂载），支持切换高性能存储驱动（如overlay）
• 便捷工具：包含自动化部署脚本，简化部署流程

使用场景

• 开发/测试环境的PostgreSQL快速部署
• 生产环境的主从复制架构搭建
• 需要水平扩展的PostgreSQL集群
• 自动化备份与数据管理

安装与配置

镜像获取

推荐通过Docker Hub拉取自动化构建的镜像：

bash
docker pull voxbox/postgresql:latest

也可手动构建镜像：

bash
docker build -t voxbox/postgresql github.com/matteolc/docker-jessie-postgresql

构建参数

构建镜像时支持以下参数（均有默认值）：

快速启动

使用examples文件夹中的docker-compose.yml文件通过Docker Compose启动容器。所有示例均使用命名卷存储数据，可根据需要将本地驱动切换为更高效的存储驱动（如overlay）。examples文件夹还包含自动化部署脚本。

主从复制部署

参考examples中的主从架构配置文件，通过Docker Compose或Swarm Stack部署主从复制集群，实现数据冗余和读写分离。

副本扩展

利用Swarm模式的服务扩展功能，通过docker service scale命令快速扩展PostgreSQL副本数量，满足高并发访问需求。

备份策略

示例脚本包含自动化备份功能，可配置定时备份PostgreSQL数据，支持本地存储或远程备份目标。

维护

镜像升级

1. 拉取最新镜像：docker pull voxbox/postgresql:latest
2. 停止当前容器：docker stop <container_name>
3. 使用新镜像重新启动容器（注意挂载原数据卷）

Shell访问

如需调试或维护，可通过docker exec进入运行中的容器：

bash
docker exec -it <container_name> bash

注：需Docker 1.3.0及以上版本支持此功能

问题反馈

报告问题前，请先尝试：

1. 更新Docker至最新版本（参考Docker安装指南）
2. SELinux用户尝试执行setenforce 0临时禁用SELinux

如问题仍存在，请提供以下信息提交issue：

• docker version和docker info命令输出
• 启动容器使用的docker run命令或docker-compose.yml（脱敏敏感信息）
• 是否使用Boot2Docker、VirtualBox等虚拟化工具