wodby查看 Docker Hub 原文页
基于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容器:
bashdocker 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 文件实现多服务协同部署:
yamlversion: '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仓库获取详细配置指南。
wodby 命名空间的其他可用镜像:
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
DockerHub 原生拉取命令
docker pull wodby/postgres:<标签>
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务