postgres

wodby/postgres Docker 镜像

基于Alpine的PostgreSQL容器镜像,包含编排功能,适用于轻量级PostgreSQL部署与管理。

下载次数: 0状态:社区镜像维护者:wodby仓库类型:镜像最近更新:
下载命令
点击查看

PostgreSQL Docker镜像(基于Alpine)

概述

该镜像是一个基于Alpine Linux构建的轻量级PostgreSQL容器化解决方案,集成编排功能,旨在简化PostgreSQL数据库的部署、配置与运维流程。Alpine Linux基础确保镜像体积小巧、资源占用低,同时完整保留PostgreSQL核心功能,适用于开发、测试及轻量级生产环境。

核心功能与特性

  • 轻量级基础:基于Alpine Linux,镜像体积显著小于传统Linux发行版基础的PostgreSQL镜像,降低存储和网络传输成本,运行时内存与CPU占用更低。
  • 完整数据库功能:集成官方PostgreSQL数据库引擎,支持标准SQL、事务处理、索引、存储过程等核心特性,兼容各版本PostgreSQL功能规范。
  • 编排支持:内置初始化脚本执行、配置文件管理、服务健康检查等编排功能,支持自动化部署与实例生命周期管理。
  • 灵活配置:通过环境变量、挂载配置文件等方式自定义数据库参数,满足不同场景下的性能与功能需求。
  • 安全增强:继承Alpine Linux的安全特性,默认配置遵循最小权限原则,减少潜在***面。

使用场景与适用范围

  • 开发与测试环境:快速搭建独立的PostgreSQL实例,支持本地开发与团队协作测试。
  • 轻量级生产环境:适用于资源受限或中小型应用,提供高效的数据库服务。
  • CI/CD流程集成:作为自动化测试的依赖服务,支持快速启动与销毁,提升持续集成效率。
  • 边缘计算场景:在边缘设备或嵌入式系统中部署轻量级数据库服务。

使用方法与配置说明

基本部署(docker run)

通过以下命令启动PostgreSQL容器:

bash
docker run -d \
  --name postgres-alpine \
  -p 5432:5432 \
  -v postgres-data:/var/lib/postgresql/data \
  -e POSTGRES_USER=myuser \
  -e POSTGRES_PASSWORD=mypassword \
  -e POSTGRES_DB=mydb \
  docker.xuanyuan.run/wodby/postgres:latest
  • -v postgres-data:/var/lib/postgresql/data:挂载数据卷以持久化数据库数据,避免容器删除导致数据丢失。
  • -e 参数:设置数据库初始化与运行参数(详见配置参数说明)。

Docker Compose配置示例

创建 docker-compose.yml 文件实现多服务协同部署:

yaml
version: '3.8'
services:
  postgres:
    image: docker.xuanyuan.run/wodby/postgres:latest
    container_name: postgres-alpine
    ports:
      - "5432:5432"
    volumes:
      - postgres-data:/var/lib/postgresql/data
      # 可选:挂载初始化脚本目录(支持.sql/.sh文件自动执行)
      # - ./init-scripts:/docker-entrypoint-initdb.d
    environment:
      POSTGRES_USER: myuser
      POSTGRES_PASSWORD: mypassword
      POSTGRES_DB: mydb
      POSTGRES_PORT: 5432
      POSTGRES_PARAMS: "-c max_connections=100 -c shared_buffers=256MB"  # 自定义数据库参数
    restart: unless-stopped

volumes:
  postgres-data:  # 命名卷持久化数据

配置参数(环境变量)

环境变量说明默认值
POSTGRES_USER数据库超级用户名称postgres
POSTGRES_PASSWORD超级用户密码(必填)无
POSTGRES_DB初始化时创建的默认数据库名与 POSTGRES_USER 相同
POSTGRES_PORT数据库服务监听端口5432
POSTGRES_PARAMS传递给 postgres 命令的额外参数(格式:-c key=value)无
POSTGRES_INITDB_ARGS传递给 initdb 的参数(如字符集配置:--encoding=UTF8)无

数据持久化

为避免容器重启或删除导致数据丢失,需通过 -v 参数将容器内 /var/lib/postgresql/data 目录挂载到宿主机目录或命名卷(推荐使用命名卷,如示例中的 postgres-data)。

注意事项

  • 版本选择:镜像标签通常对应PostgreSQL版本(如 15-alpine、14-alpine),请根据应用兼容性需求选择具体版本。
  • 权限管理:挂载宿主机目录时,需确保宿主机目录权限允许容器内 postgres 用户(UID 70)访问,避免权限错误。
  • 生产环境安全:生产环境中应避免使用默认密码,建议通过密钥管理工具或环境变量文件安全传递敏感信息。
  • 高级编排:如需主从复制、定时备份等高级功能,可参考官方GitHub仓库获取详细配置指南。

镜像拉取方式

您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。

轩辕镜像加速拉取命令点我查看更多 postgres 镜像标签

docker pull docker.xuanyuan.run/wodby/postgres:<标签>

DockerHub 原生拉取命令

docker pull wodby/postgres:<标签>
专业版 · 高速稳定拉取镜像
50GB 仅 ¥8/年
高速镜像下载在线技术支持专业版保障服务可用付费会员免广告